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 ouputs 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  Dont'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>.

bilibop                                            2015-07-14                                       LSBILIBOP(8)