udisks
udisks command line tool
Synopsis
add an example, a script, a trick and tips
examples
no example yet ...
... Feel free to add your own example above to help other Linux-lovers !
description
udisks
is a simple command line client for the udisks(7)
system bus service.
options
--dump
Dump all information about all
devices. Please include this when filing bugs.
--enumerate
Lists all object paths of
devices know to the daemon.
--enumerate-device-files
Lists all device files of
devices know to the daemon.
--monitor
Connect to the daemon and print
a line every time an event happens.
--monitor-detail
Like
--monitor but prints the full details of
the device whenever an event happens.
--show-info
device_file
Shows information about
device_file.
--inhibit-polling
device_file
[-- program arg ...]
Inhibits polling on
device_file. If no program is given, polling is
inhibited until Ctrl+C is pressed. Otherwise the program is
spawned and the polling is only inhibited until the program
terminates.
--poll-for-media
device_file
Polls device_file to
perform media detection.
--inhibit-all-polling
[-- program arg ...]
Inhibits polling on all
devices. If no program is given, polling is inhibited until
Ctrl+C is pressed. Otherwise the program is spawned and the
polling is only inhibited until the program terminates.
--mount
device_file
[--mount-fstype fstype]
[--mount-options options]
Mounts the device represented
by device_file using the file system fstype
and a comma-separated list of options.
--unmount
device_file
[--unmount-options options]
Unmounts the device represented
by device_file using a comma-separated list of
options.
--detach
device_file
[--detach-options options]
Detaches (e.g. powering down
the physical port the device is connected to) the device
represented by device_file using a
comma-separated list of options.
--eject
device_file
[--eject-options options]
Ejects media from the device
represented by device_file using a
comma-separated list of options.
--ata-smart-refresh
device_file
[--ata-smart-wakeup]
Refreshes ATA SMART data for
device_file. If the disk is sleeping it will not be
woken up unless
--ata-smart-wakeup is passed.
will be used.
--ata-smart-refresh
device_file
--ata-smart-simulate
blob
Read ATA SMART data from
blob for device_file. This can only be done by
the super user and is typically used for testing that
clients relying on the ATA SMART data provided by udisks
behave correctly. The libatasmart git repository at
http://git.0pointer.de/?p=libatasmart.git;a=summary
contains a collection of blobs from
failing disks.
--inhibit
[-- program arg ...]
Inhibits
clients from invoking methods on the daemon that require
authorization (all methods will return the
org.freedesktop.UDisks.Error.Inhibited error) if the caller
is not the super user. This is typically used by OS
installers and other programs that expects full control of
the system, specifically to avoid automounting devices. Only
the super user can do this.
If
no program is given, the daemon is inhibited until Ctrl+C is
pressed. Otherwise the program is spawned and the daemon is
only inhibited until the program terminates.
--set-spindown
device_file
--spindown-timeout seconds
[-- program arg ...]
Configures
disk spindown timeout on device_file to
seconds. See the section called “SPINNING DOWN
DISKS” for important information before using this
option.
If
no program is given, the spindown time will be used until
Ctrl+C is pressed. Otherwise the program is spawned and the
the spindown timeout will only be used until the program
terminates.
--set-spindown-all
--spindown-timeout seconds
[-- program arg ...]
Configures
disk spindown timeout on all disks that can be spun down to
seconds. See the section called “SPINNING DOWN
DISKS” for important information before using this
option.
If
no program is given, the spindown time will be used until
Ctrl+C is pressed. Otherwise the program is spawned and the
the spindown timeout will only be used until the program
terminates.
--help
Show help
options.
spinning down disks
Caution should be exercised when
configuring disk spin down timeouts.
Note that every time a disk is spun down,
the “start-stop-count” ATA SMART attribute will increase by 1 and
most disks are only good for a limited number (typically 50,000
but it varies by manufacturer and model). In addition, the drive
may take as long as 30 seconds to respond to subsequent disk
access – most drives are typically faster, see the “spin-up-time”
ATA SMART attribute.
On the other hand, cautious use (e.g. using
conservative timeouts) of the ability to spin down disks, can be
a good way to trade power consumption (typically 8 vs 1 Watts for
3.5" drives) and heat emission for a slightly higher
latency.
bugs
Please
send bug reports to either the distribution bug tracker or
the upstream bug tracker at
http://bugs.freedesktop.org/enter_bug.cgi?product=udisks.
see also
udisks-daemon,
udisks,
author
Written
by David Zeuthen david[:at:]fubar[:dot:]dk with a lot of help from many
others.