udisks(1)

1UDISKS(1)                           udisks                           UDISKS(1)
2
3
4

NAME

6       udisks - udisks command line tool
7

SYNOPSIS

9       udisks [OPTIONS]
10

DESCRIPTION

12       udisks is a simple command line client for the udisks(7) system bus
13       service.
14

OPTIONS

16       --dump
17           Dump all information about all devices. Please include this when
18           filing bugs.
19
20       --enumerate
21           Lists all object paths of devices know to the daemon.
22
23       --enumerate-device-files
24           Lists all device files of devices know to the daemon.
25
26       --monitor
27           Connect to the daemon and print a line every time an event happens.
28
29       --monitor-detail
30           Like --monitor but prints the full details of the device whenever
31           an event happens.
32
33       --show-info device_file
34           Shows information about device_file.
35
36       --inhibit-polling device_file [-- program arg ...]
37           Inhibits polling on device_file. If no program is given, polling is
38           inhibited until Ctrl+C is pressed. Otherwise the program is spawned
39           and the polling is only inhibited until the program terminates.
40
41       --poll-for-media device_file
42           Polls device_file to perform media detection.
43
44       --inhibit-all-polling [-- program arg ...]
45           Inhibits polling on all devices. If no program is given, polling is
46           inhibited until Ctrl+C is pressed. Otherwise the program is spawned
47           and the polling is only inhibited until the program terminates.
48
49       --mount device_file [--mount-fstype fstype] [--mount-options options]
50           Mounts the device represented by device_file using the file system
51           fstype and a comma-separated list of options.
52
53       --unmount device_file [--unmount-options options]
54           Unmounts the device represented by device_file using a
55           comma-separated list of options.
56
57       --detach device_file [--detach-options options]
58           Detaches (e.g. powering down the physical port the device is
59           connected to) the device represented by device_file using a
60           comma-separated list of options.
61
62       --eject device_file [--eject-options options]
63           Ejects media from the device represented by device_file using a
64           comma-separated list of options.
65
66       --ata-smart-refresh device_file [--ata-smart-wakeup]
67           Refreshes ATA SMART data for device_file. If the disk is sleeping
68           it will not be woken up unless --ata-smart-wakeup is passed. will
69           be used.
70
71       --ata-smart-refresh device_file --ata-smart-simulate blob
72           Read ATA SMART data from blob for device_file. This can only be
73           done by the super user and is typically used for testing that
74           clients relying on the ATA SMART data provided by udisks behave
75           correctly. The libatasmart git repository at
76           http://git.0pointer.de/?p=libatasmart.git;a=summary contains a
77           collection of blobs from failing disks.
78
79       --inhibit [-- program arg ...]
80           Inhibits clients from invoking methods on the daemon that require
81           authorization (all methods will return the
82           org.freedesktop.UDisks.Error.Inhibited error) if the caller is not
83           the super user. This is typically used by OS installers and other
84           programs that expects full control of the system, specifically to
85           avoid automounting devices. Only the super user can do this.
86
87           If no program is given, the daemon is inhibited until Ctrl+C is
88           pressed. Otherwise the program is spawned and the daemon is only
89           inhibited until the program terminates.
90
91       --set-spindown device_file --spindown-timeout seconds
92       [-- program arg ...]
93           Configures disk spindown timeout on device_file to seconds. See the
94           section called “SPINNING DOWN DISKS” for important information
95           before using this option.
96
97           If no program is given, the spindown time will be used until Ctrl+C
98           is pressed. Otherwise the program is spawned and the the spindown
99           timeout will only be used until the program terminates.
100
101       --set-spindown-all --spindown-timeout seconds [-- program arg ...]
102           Configures disk spindown timeout on all disks that can be spun down
103           to seconds. See the section called “SPINNING DOWN DISKS” for
104           important information before using this option.
105
106           If no program is given, the spindown time will be used until Ctrl+C
107           is pressed. Otherwise the program is spawned and the the spindown
108           timeout will only be used until the program terminates.
109
110       --help
111           Show help options.
112

SPINNING DOWN DISKS

114       Caution should be exercised when configuring disk spin down timeouts.
115
116       Note that every time a disk is spun down, the “start-stop-count” ATA
117       SMART attribute will increase by 1 and most disks are only good for a
118       limited number (typically 50,000 but it varies by manufacturer and
119       model). In addition, the drive may take as long as 30 seconds to
120       respond to subsequent disk access – most drives are typically faster,
121       see the “spin-up-time” ATA SMART attribute.
122
123       On the other hand, cautious use (e.g. using conservative timeouts) of
124       the ability to spin down disks, can be a good way to trade power
125       consumption (typically 8 vs 1 Watts for 3.5" drives) and heat emission
126       for a slightly higher latency.
127

AUTHOR

129       Written by David Zeuthen david@fubar.dk with a lot of help from many
130       others.
131

BUGS

133       Please send bug reports to either the distribution bug tracker or the
134       upstream bug tracker at
135       http://bugs.freedesktop.org/enter_bug.cgi?product=udisks.
136