NAME

       lsbilibop - list BILIBOP tagged devices, display or update some of their udev properties

SYNOPSIS

       lsbilibop [-l]
       lsbilibop [-a|-c|-i] [DEVICE [DEVICE [...]]]
       lsbilibop -h

DESCRIPTION

       lsbilibop  is  a simple shell script that outputs the list of BILIBOP tagged block devices
       and some of their udev(7) properties,  or  triggers  uevents  to  update  udev  rules  and
       properties that can be applied to these devices.

       If  the operating system is running from an external and writable support (USB or SD Flash
       Memory, USB, Firewire or eSATA HDD), then the BILIBOP tagged devices are the block devices
       whose contents are on the same physical disk than the root filesystem. This includes disk,
       partitions, but also device-mapper and loopback devices, and even block devices containing
       a  filesystem used as lower/readonly branch of an aufs(5) or overlay mountpoint (depending
       on  the  kernel  version).   The   rules   file   /lib/udev/rules.d/66-bilibop.rules   (or
       /etc/udev/rules.d/66-bilibop.rules) is used to find and tag such devices.

OPTIONS

       Options  must  be  invoked  before arguments.  When invoked without option, lsbilibop just
       outputs a list of the device(s) given as arguments  (if  they  are  BILIBOP  tagged  block
       devices),  or of all BILIBOP tagged block devices if none is specified. Devices are listed
       in the same order than in /proc/partitions, i.e. in the order they have been discovered by
       the kernel. Absolute or relative paths and symlinks can be used to specify a device. Shell
       wildcards are allowed.

       -a  Trigger 'device add' uevent for the device(s) given as arguments (if they are  BILIBOP
           tagged block devices), or of all BILIBOP tagged block devices if none is specified, to
           update their properties. This can be used each time the corresponding  BILIBOP_RULES_*
           variables  are  modified in bilibop.conf(5), to apply the new settings without need to
           reboot the operating system.

       -c  Trigger 'device change' uevent for the device(s)  given  as  arguments  (if  they  are
           BILIBOP  tagged  block  devices),  or  of  all BILIBOP tagged block devices if none is
           specified, to update their properties. This can be used each  time  the  corresponding
           BILIBOP_RULES_*  variables  are modified in bilibop.conf(5), to apply the new settings
           without need to reboot the operating system.

       -h  Print a help page on standard output and exit.

       -i  Display some useful udev(7) properties of the device(s) given as  arguments  (if  they
           are  BILIBOP  tagged block devices), or of all BILIBOP tagged block devices if none is
           specified.  This option overrides -a and -c options.

           The following properties are only informative. The two last ones are set if  and  only
           if  udisks  1.x  (ID_DRIVE_DETACHABLE)  and/or  udisks  2.x (UDISKS_CAN_POWER_OFF) are
           installed.

           DEVNAME
           BILIBOP_DISK
           BILIBOP_PARTITION
           BILIBOP_UNDERLYING_PARTITION
           DEVLINKS

           ID_DRIVE_DETACHABLE
           UDISKS_CAN_POWER_OFF

           The following properties can  be  used  to  set  BILIBOP_RULES_*_WHITELIST  and  other
           variables in bilibop.conf(5):

           ID_FS_LABEL
           ID_FS_TYPE
           ID_FS_USAGE
           ID_FS_UUID

           The following properties can be modified by changing the corresponding BILIBOP_RULES_*
           variables in bilibop.conf(5).  They are set if and only if udisks 1.x (for  the  first
           set) and/or udisks 2.x (for the second set) are installed.

           UDISKS_PRESENTATION_HIDE
           UDISKS_PRESENTATION_ICON_NAME
           UDISKS_PRESENTATION_NAME
           UDISKS_SYSTEM_INTERNAL

           UDISKS_IGNORE
           UDISKS_ICON_NAME
           UDISKS_NAME
           UDISKS_SYSTEM

       -l  Don't  rely  on  the  'BILIBOP'  tag to list the devices.  This option is based on the
           bilibop-common shell library.

ERRORS

       If the 'BILIBOP' tag does not exist in the udev database, then lsbilibop displays a useful
       error  message  on  stderr,  and  lists  the  device nodes whose content is supposed to be
       written on the same physical disk than the root filesystem (as does the -l  option).  Exit
       code is 8.

FILES

       /etc/bilibop/bilibop.conf
       /usr/share/doc/bilibop-rules/examples/bilibop.conf
       /usr/share/bilibop/bilibop_rules_generator
       /lib/udev/rules.d/66-bilibop.rules
       /etc/udev/rules.d/66-bilibop.rules

SEE ALSO

       bilibop(7), bilibop.conf(5), drivemap(1), udev(7), udevadm(8), udisks(7), udisks(8)

AUTHOR

       This manual page has been written by Bilibop Project <quidame@poivron.org>.