Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
DSBMC-Cli(1)		FreeBSD	General	Commands Manual		  DSBMC-Cli(1)

     dsbmc-cli -- command-line client for DSBMD

     dsbmc-cli -L event	command	[arg ...] ; [-L	...]
     dsbmc-cli -a [-b dev1,dev2,...] [-U time] [[-L event command [arg ...]] ;
	       [-L ...]]
     dsbmc-cli {{-e | -u} [-f] | {-m | -s | -u | -v speed}} device
     dsbmc-cli {-e | -u} _mount	point_
     dsbmc-cli -i _disk	image_
     dsbmc-cli -l
     dsbmc-cli [-h]

     dsbmc-cli is a command-line client	for DSBMD that provides	a simple in-
     terface to	query information about	storage	devices, and to	send requests
     to	mount, unmount and eject these.

     -L	     Listen for	event, and execute the command every time the event is
	     received. Possible	events are mount, unmount, add,	and remove.
	     The command must be terminated by a semicolon (`;') as a separate
	     argument. Each event provides information about the device	that
	     can be accessed using the placeholders %d (device name), %l (vol-
	     ume label), %m (mount point) (only	mount and unmount ), and %t
	     (device type). A literal percent character	(`%') must be escaped
	     by	a further `%' character	("%%").

	     Possible values for the device type (%t) are hdd, usbdisk,
	     datacd, audiocd, dvd, vcd,	svcd, mmc, mtp,	and ptp.

	     The -L option can be given	multiple times.

     -U	     Auto-unmount. Try to unmount each automounted device every	time

     -a	     Automount.	After mounting all devices presented by	DSBMD,
	     dsbmc-cli(1) waits	for new	devices	added to the system, and
	     mounts them.  In addition,	the -L option can be specified for
	     each event. If dsbmc-cli(1) automounts a device, it executes the
	     command defined for the mount event.

     -b	dev1,dev2,...
	     Define a comma-separated list of devices and/or volume labels to
	     ignore if the -a option is	given. Volume labels must be prefixed
	     by	"volid=".
	     Example: dsbmc-cli	-a -b da0p2,volid=EFISYS,volid=TMP

     -e	device,	-e _mount point_
	     Eject the given device or the device mounted on _mount point_

     -i	_disk image_
	     Create a memory disk to access the	given disk image.

     -l	     List all currently	attached devices DSBMD supports.

     -m	device
	     Mount the given device.

     -s	device
	     The storage capacity of the given device is queried, and the me-
	     dia size, the number of used and free bytes are printed to	std-

     -u	device,	-u _mount point_
	     Unmount the given device or the device mounted on _mount point_

     -v	speed device
	     Set the reading speed of the given	CD/DVD device.

	   $ dsbmc-cli -L mount	printf "%%s was	mounted	on %%s\n" %d %m	';'

     This command listens for mount events, and	executes the printf command,
     where %d and %m are replaced by the device	name and mount point.

	   $ dsbmc-cli -a -L add sh -c 'case %t	in audiocd) vlc	cdda://%d&;;
	   dvd)	vlc dvd://%d&;;	esac' ';' -L mount sh -c 'Thunar %m&' ';'

     In	this example, dsbmc-cli	automounts devices, and	listens	for add	and
     mount events. If an audio CD or a DVD was inserted, the command vlc
     cdda://%d_	or vlc dvd://%d_ is executed, respectively. If a device	was
     mounted, dsbmc-cli	executes the command Thunar %m_, where %m is replaced
     by	the mount point.

FreeBSD	13.0		       October 28, 2021			  FreeBSD 13.0


Want to link to this manual page? Use this URL:

home | help