1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
<title>UDisks Reference Manual: Authorization Checks</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
<link rel="home" href="index.html" title="UDisks Reference Manual">
8
<link rel="up" href="ref-dbus-overview.html" title="Overview">
9
<link rel="prev" href="ref-dbus-jobs.html" title="The /org/freedesktop/UDisks2/jobs/* objects">
10
<link rel="next" href="udisks-std-options.html" title="The options parameter">
11
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
<td width="100%" align="left" class="shortcuts"></td>
17
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
18
<td><a accesskey="u" href="ref-dbus-overview.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
19
<td><a accesskey="p" href="ref-dbus-jobs.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
20
<td><a accesskey="n" href="udisks-std-options.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
23
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
24
<a name="udisks-polkit-actions"></a>Authorization Checks</h2></div></div></div>
26
Many methods and operations offered by udisks requires the
27
calling user to be sufficiently authorized. Whether the user
28
is authorized is checked using <a class="ulink" href="http://www.freedesktop.org/software/polkit/docs/latest/polkit.8.html" target="_top">polkit</a>
29
allowing the administrator to configure fine-grained permissions via
30
polkit authorization rules.
33
There is not necessarily a one-to-one relationship between
34
D-Bus methods and polkit actions - typically the
35
relationship is more complicated and depends on both the
36
context of the process invoking the method, the object the
37
method is acting on and possibly more factors. For example,
38
the <a class="link" href="gdbus-org.freedesktop.UDisks2.Filesystem.html#gdbus-method-org-freedesktop-UDisks2-Filesystem.Mount" title="The Mount() method">Filesystem.Mount()</a>
39
method call may check that the caller is authorized for one
41
<span class="emphasis"><em>org.freedesktop.udisks2.filesystem-mount</em></span>,
42
<span class="emphasis"><em>org.freedesktop.udisks2.filesystem-mount-system</em></span>,
43
<span class="emphasis"><em>org.freedesktop.udisks2.filesystem-mount-other-seat</em></span>
45
<span class="emphasis"><em>org.freedesktop.udisks2.filesystem-mount-fstab</em></span>
46
depending on circumstances.
49
Often there will be two polkit actions for one operation -
50
one for so-called <span class="quote">“<span class="quote">system devices</span>”</span> and one for
51
non-system devices. In this context <span class="quote">“<span class="quote">system
52
device</span>”</span> refers to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Block.html#gdbus-property-org-freedesktop-UDisks2-Block.HintSystem" title='The "HintSystem" property'>Block:HintSystem</a>
53
D-Bus property and is normally only
54
<code class="constant">TRUE</code> for devices not considered
55
<span class="quote">“<span class="quote">removable</span>”</span> (devices considered removable
56
include USB attached storage, Flash media and optical
57
drives). See <a class="xref" href="udisks.8.html" title="udisks"><span class="refentrytitle">udisks</span>(8)</a> for how to control
58
if a device is considered a system device.
61
The polkit actions are not considered stable and may change
62
from release to release so administrators should take notice
63
when upgrading from one version of udisks to another. For
64
example, polkit authorization rules may need to be updated
65
to match an updated policy.
68
See <a class="xref" href="udisks-polkit-actions.html#udisks-polkit-details" title="Table 1. Known polkit variables">Table 1, “Known polkit variables”</a> for the
69
variables that can be used to assist in determining if the
70
caller is authorized (note that each variable may not be set
71
for request). For example, a polkit authorization rule for
73
<span class="emphasis"><em>org.freedesktop.udisks2.filesystem-mount*</em></span>
74
actions can use the <em class="parameter"><code>device</code></em> variable
75
to determine if the caller is authorized to mount a specific
79
<a name="udisks-polkit-details"></a><p class="title"><b>Table 1. Known polkit variables</b></p>
80
<div class="table-contents"><table summary="Known polkit variables" border="1">
86
<th align="left">key</th>
87
<th align="left">value</th>
91
<td align="left"><em class="parameter"><code>device</code></em></td>
92
<td align="left">If the object is a block device, this property is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Block.html#gdbus-property-org-freedesktop-UDisks2-Block.PreferredDevice" title='The "PreferredDevice" property'>Block:PreferredDevice</a> property. If set, this is guaranteed to be a device file, for example <span class="quote">“<span class="quote">/dev/vg_lucifer/lv_root</span>”</span> or <span class="quote">“<span class="quote">/dev/sda1</span>”</span>. If the object is not a block device, this is not set.</td>
95
<td align="left"><em class="parameter"><code>drive</code></em></td>
96
<td align="left">Like the <em class="parameter"><code>device</code></em> variable, but if the object is also a drive, this variable includes Vital Product Data about the drive such as the vendor and model identifiers (if available), for example <span class="quote">“<span class="quote">INTEL SSDSA2MH080G1GC (/dev/sda1)</span>”</span>. Otherwise is just set to the same value as <em class="parameter"><code>device</code></em>. If the object is not a block device, this is not set (it is however set if the object is a block device but not a drive).</td>
99
<td align="left"><em class="parameter"><code>drive.wwn</code></em></td>
100
<td align="left">If the object is a drive (or a block device that is part of a drive), this is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.html#gdbus-property-org-freedesktop-UDisks2-Drive.WWN" title='The "WWN" property'>Drive:WWN</a> property.</td>
103
<td align="left"><em class="parameter"><code>drive.serial</code></em></td>
104
<td align="left">If the object is a drive (or a block device that is part of a drive), this is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.html#gdbus-property-org-freedesktop-UDisks2-Drive.Serial" title='The "Serial" property'>Drive:Serial</a> property.</td>
107
<td align="left"><em class="parameter"><code>drive.vendor</code></em></td>
108
<td align="left">If the object is a drive (or a block device that is part of a drive), this is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.html#gdbus-property-org-freedesktop-UDisks2-Drive.Vendor" title='The "Vendor" property'>Drive:Vendor</a> property.</td>
111
<td align="left"><em class="parameter"><code>drive.model</code></em></td>
112
<td align="left">If the object is a drive (or a block device that is part of a drive), this is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.html#gdbus-property-org-freedesktop-UDisks2-Drive.Model" title='The "Model" property'>Drive:Model</a> property.</td>
115
<td align="left"><em class="parameter"><code>drive.revision</code></em></td>
116
<td align="left">If the object is a drive (or a block device that is part of a drive), this is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.html#gdbus-property-org-freedesktop-UDisks2-Drive.Revision" title='The "Revision" property'>Drive:Revision</a> property.</td>
119
<td align="left"><em class="parameter"><code>drive.removable</code></em></td>
120
<td align="left">If the object is a drive (or a block device that is part of a drive), this is set to the string <span class="quote">“<span class="quote">true</span>”</span> only if the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.html#gdbus-property-org-freedesktop-UDisks2-Drive.Removable" title='The "Removable" property'>Drive:Removable</a> property is <code class="constant">TRUE</code>.</td>
123
<td align="left"><em class="parameter"><code>drive.removable.bus</code></em></td>
124
<td align="left">If the object is a drive (or a block device that is part of a drive), this is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.html#gdbus-property-org-freedesktop-UDisks2-Drive.ConnectionBus" title='The "ConnectionBus" property'>Drive:ConnectionBus</a> property. This variable is set only if the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.html#gdbus-property-org-freedesktop-UDisks2-Drive.Removable" title='The "Removable" property'>Drive:Removable</a> property is <code class="constant">TRUE</code>.</td>
127
<td align="left"><em class="parameter"><code>drive.removable.media</code></em></td>
128
<td align="left">If the object is a drive (or a block device that is part of a drive), this is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.html#gdbus-property-org-freedesktop-UDisks2-Drive.MediaCompatibility" title='The "MediaCompatibility" property'>Drive:MediaCompatibility</a> property. This variable is set only if the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.html#gdbus-property-org-freedesktop-UDisks2-Drive.Removable" title='The "Removable" property'>Drive:Removable</a> property is <code class="constant">TRUE</code>.</td>
131
<td align="left"><em class="parameter"><code>id.type</code></em></td>
132
<td align="left">If the object is a block device, this property is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Block.html#gdbus-property-org-freedesktop-UDisks2-Block.IdType" title='The "IdType" property'>Block:IdType</a> property.</td>
135
<td align="left"><em class="parameter"><code>id.usage</code></em></td>
136
<td align="left">If the object is a block device, this property is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Block.html#gdbus-property-org-freedesktop-UDisks2-Block.IdUsage" title='The "IdUsage" property'>Block:IdUsage</a> property.</td>
139
<td align="left"><em class="parameter"><code>id.version</code></em></td>
140
<td align="left">If the object is a block device, this property is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Block.html#gdbus-property-org-freedesktop-UDisks2-Block.IdVersion" title='The "IdVersion" property'>Block:IdVersion</a> property.</td>
143
<td align="left"><em class="parameter"><code>id.label</code></em></td>
144
<td align="left">If the object is a block device, this property is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Block.html#gdbus-property-org-freedesktop-UDisks2-Block.IdLabel" title='The "IdLabel" property'>Block:IdLabel</a> property.</td>
147
<td align="left"><em class="parameter"><code>id.uuid</code></em></td>
148
<td align="left">If the object is a block device, this property is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Block.html#gdbus-property-org-freedesktop-UDisks2-Block.IdUUID" title='The "IdUUID" property'>Block:IdUUID</a> property.</td>
151
<td align="left"><em class="parameter"><code>partition.number</code></em></td>
152
<td align="left">If the object is a partition, this property is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Partition.html#gdbus-property-org-freedesktop-UDisks2-Partition.Number" title='The "Number" property'>Partition:Number</a> property.</td>
155
<td align="left"><em class="parameter"><code>partition.type</code></em></td>
156
<td align="left">If the object is a partition, this property is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Partition.html#gdbus-property-org-freedesktop-UDisks2-Partition.Type" title='The "Type" property'>Partition:Type</a> property.</td>
159
<td align="left"><em class="parameter"><code>partition.flags</code></em></td>
160
<td align="left">If the object is a partition, this property is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Partition.html#gdbus-property-org-freedesktop-UDisks2-Partition.Flags" title='The "Flags" property'>Partition:Flags</a> property.</td>
163
<td align="left"><em class="parameter"><code>partition.name</code></em></td>
164
<td align="left">If the object is a partition, this property is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Partition.html#gdbus-property-org-freedesktop-UDisks2-Partition.Name" title='The "Name" property'>Partition:Name</a> property.</td>
167
<td align="left"><em class="parameter"><code>partition.uuid</code></em></td>
168
<td align="left">If the object is a partition, this property is set to the value of the <a class="link" href="gdbus-org.freedesktop.UDisks2.Partition.html#gdbus-property-org-freedesktop-UDisks2-Partition.UUID" title='The "UUID" property'>Partition:UUID</a> property.</td>
173
<br class="table-break"><p>
174
For reference, the polkit actions defined by udisks 2.1.3
178
<div class="informalexample">
179
<a name="udisks-polkit-actions-file"></a><pre class="programlisting"><?xml version="1.0" encoding="utf-8"?>
181
<!DOCTYPE policyconfig PUBLIC
182
"-//freedesktop//DTD PolicyKit Policy Configuration 1.0//EN"
183
"http://www.freedesktop.org/standards/PolicyKit/1.0/policyconfig.dtd">
186
<vendor>The udisks Project</vendor>
187
<vendor_url>http://udisks.freedesktop.org/</vendor_url>
188
<icon_name>drive-removable-media</icon_name>
190
<!-- ###################################################################### -->
191
<!-- Mounting filesystems -->
193
<action id="org.freedesktop.udisks2.filesystem-mount">
194
<_description>Mount a filesystem</_description>
195
<_message>Authentication is required to mount the filesystem</_message>
197
<allow_any>auth_admin</allow_any>
198
<allow_inactive>auth_admin</allow_inactive>
199
<allow_active>yes</allow_active>
203
<!-- mount a device considered a "system device" -->
204
<action id="org.freedesktop.udisks2.filesystem-mount-system">
205
<_description>Mount a filesystem on a system device</_description>
206
<_message>Authentication is required to mount the filesystem</_message>
208
<allow_any>auth_admin</allow_any>
209
<allow_inactive>auth_admin</allow_inactive>
210
<allow_active>auth_admin_keep</allow_active>
214
<!-- mount a device attached to another seat -->
215
<action id="org.freedesktop.udisks2.filesystem-mount-other-seat">
216
<_description>Mount a filesystem from a device plugged into another seat</_description>
217
<_message>Authentication is required to mount the filesystem</_message>
219
<allow_any>auth_admin</allow_any>
220
<allow_inactive>auth_admin</allow_inactive>
221
<allow_active>auth_admin_keep</allow_active>
225
<!-- mount a device referenced in the /etc/fstab file with the x-udisks-auth option -->
226
<action id="org.freedesktop.udisks2.filesystem-fstab">
227
<_description>Mount/unmount filesystems defined in the fstab file with the x-udisks-auth option</_description>
228
<_message>Authentication is required to mount/unmount the filesystem</_message>
230
<allow_any>auth_admin</allow_any>
231
<allow_inactive>auth_admin</allow_inactive>
232
<allow_active>auth_admin_keep</allow_active>
236
<!-- ###################################################################### -->
237
<!-- Unmounting filesystems -->
239
<!-- unmount a filesystem mounted by another user -->
240
<action id="org.freedesktop.udisks2.filesystem-unmount-others">
241
<_description>Unmount a device mounted by another user</_description>
242
<_message>Authentication is required to unmount a filesystem mounted by another user</_message>
244
<allow_any>auth_admin</allow_any>
245
<allow_inactive>auth_admin</allow_inactive>
246
<allow_active>auth_admin_keep</allow_active>
250
<!-- ###################################################################### -->
251
<!-- Unlocking encrypted devices -->
253
<action id="org.freedesktop.udisks2.encrypted-unlock">
254
<_description>Unlock an encrypted device</_description>
255
<_message>Authentication is required to unlock an encrypted device</_message>
257
<allow_any>auth_admin</allow_any>
258
<allow_inactive>auth_admin</allow_inactive>
259
<allow_active>yes</allow_active>
263
<!-- unlock a device considered a "system device" -->
264
<action id="org.freedesktop.udisks2.encrypted-unlock-system">
265
<_description>Unlock an encrypted system device</_description>
266
<_message>Authentication is required to unlock an encrypted device</_message>
268
<allow_any>auth_admin</allow_any>
269
<allow_inactive>auth_admin</allow_inactive>
270
<allow_active>auth_admin_keep</allow_active>
274
<!-- mount a device attached to another seat -->
275
<action id="org.freedesktop.udisks2.encrypted-unlock-other-seat">
276
<_description>Unlock an encrypted device plugged into another seat</_description>
277
<_message>Authentication is required to unlock an encrypted device</_message>
279
<allow_any>auth_admin</allow_any>
280
<allow_inactive>auth_admin</allow_inactive>
281
<allow_active>auth_admin_keep</allow_active>
285
<!-- unlock a device referenced in the /etc/crypttab file with the x-udisks-auth option -->
286
<action id="org.freedesktop.udisks2.encrypted-unlock-crypttab">
287
<_description>Unlock an encrypted device specified in the crypttab file with the x-udisks-auth option</_description>
288
<_message>Authentication is required to unlock an encrypted device</_message>
290
<allow_any>auth_admin</allow_any>
291
<allow_inactive>auth_admin</allow_inactive>
292
<allow_active>auth_admin_keep</allow_active>
296
<!-- ###################################################################### -->
297
<!-- Locking encrypted devices -->
299
<!-- lock a device unlocked by another user -->
300
<action id="org.freedesktop.udisks2.encrypted-lock-others">
301
<_description>Lock an encrypted device unlocked by another user</_description>
302
<_message>Authentication is required to lock an encrypted device unlocked by another user</_message>
304
<allow_any>auth_admin</allow_any>
305
<allow_inactive>auth_admin</allow_inactive>
306
<allow_active>auth_admin_keep</allow_active>
310
<!-- ###################################################################### -->
311
<!-- Changing passphrases on encrypted devices -->
313
<action id="org.freedesktop.udisks2.encrypted-change-passphrase">
314
<_description>Change passphrase for an encrypted device</_description>
315
<_message>Authentication is required to change the passphrase for an encrypted device</_message>
317
<allow_any>auth_admin</allow_any>
318
<allow_inactive>auth_admin</allow_inactive>
319
<allow_active>yes</allow_active>
323
<!-- change passphrase on a device considered a "system device" -->
324
<action id="org.freedesktop.udisks2.encrypted-change-passphrase-system">
325
<_description>Change passphrase for an encrypted device</_description>
326
<_message>Authentication is required to change the passphrase for an encrypted device</_message>
328
<allow_any>auth_admin</allow_any>
329
<allow_inactive>auth_admin</allow_inactive>
330
<allow_active>auth_admin_keep</allow_active>
334
<!-- ###################################################################### -->
335
<!-- Setting up loop devices -->
337
<action id="org.freedesktop.udisks2.loop-setup">
338
<_description>Manage loop devices</_description>
339
<_message>Authentication is required to set up a loop device</_message>
341
<allow_any>auth_admin</allow_any>
342
<allow_inactive>auth_admin</allow_inactive>
343
<!-- NOTE: this is not a DoS because we are using /dev/loop-control -->
344
<allow_active>yes</allow_active>
348
<!-- ###################################################################### -->
349
<!-- Deleting and modifying loop devices -->
351
<action id="org.freedesktop.udisks2.loop-delete-others">
352
<_description>Delete loop devices</_description>
353
<_message>Authentication is required to delete a loop device set up by another user</_message>
355
<allow_any>auth_admin</allow_any>
356
<allow_inactive>auth_admin</allow_inactive>
357
<allow_active>auth_admin_keep</allow_active>
361
<action id="org.freedesktop.udisks2.loop-modify-others">
362
<_description>Modify loop devices</_description>
363
<_message>Authentication is required to modify a loop device set up by another user</_message>
365
<allow_any>auth_admin</allow_any>
366
<allow_inactive>auth_admin</allow_inactive>
367
<allow_active>auth_admin_keep</allow_active>
371
<!-- ###################################################################### -->
372
<!-- Manage (start/stop) swapspace -->
374
<action id="org.freedesktop.udisks2.manage-swapspace">
375
<_description>Manage swapspace</_description>
376
<_message>Authentication is required to manage swapspace</_message>
378
<allow_any>auth_admin</allow_any>
379
<allow_inactive>auth_admin</allow_inactive>
380
<allow_active>auth_admin_keep</allow_active>
384
<!-- ###################################################################### -->
385
<!-- Manage MD-RAID -->
387
<action id="org.freedesktop.udisks2.manage-md-raid">
388
<_description>Manage RAID arrays</_description>
389
<_message>Authentication is required to manage RAID arrays</_message>
391
<allow_any>auth_admin</allow_any>
392
<allow_inactive>auth_admin</allow_inactive>
393
<allow_active>auth_admin_keep</allow_active>
397
<!-- ###################################################################### -->
398
<!-- Power off drives -->
400
<action id="org.freedesktop.udisks2.power-off-drive">
401
<_description>Power off drive</_description>
402
<_message>Authentication is required to power off a drive</_message>
404
<allow_any>auth_admin</allow_any>
405
<allow_inactive>auth_admin</allow_inactive>
406
<allow_active>yes</allow_active>
410
<!-- Power off a drive considered a "system device" -->
411
<action id="org.freedesktop.udisks2.power-off-drive-system">
412
<_description>Power off a system drive</_description>
413
<_message>Authentication is required to power off a drive</_message>
415
<allow_any>auth_admin</allow_any>
416
<allow_inactive>auth_admin</allow_inactive>
417
<allow_active>auth_admin_keep</allow_active>
421
<!-- Power off a drive attached to another seat -->
422
<action id="org.freedesktop.udisks2.power-off-drive-other-seat">
423
<_description>Power off a drive attached to another seat</_description>
424
<_message>Authentication is required to power off a drive plugged into another seat</_message>
426
<allow_any>auth_admin</allow_any>
427
<allow_inactive>auth_admin</allow_inactive>
428
<allow_active>auth_admin_keep</allow_active>
432
<!-- ###################################################################### -->
433
<!-- Eject media from a drive -->
435
<action id="org.freedesktop.udisks2.eject-media">
436
<_description>Eject media</_description>
437
<_message>Authentication is required to eject media</_message>
439
<allow_any>auth_admin</allow_any>
440
<allow_inactive>auth_admin</allow_inactive>
441
<allow_active>yes</allow_active>
445
<!-- eject media from a drive considered a "system device" -->
446
<action id="org.freedesktop.udisks2.eject-media-system">
447
<_description>Eject media from a system drive</_description>
448
<_message>Authentication is required to eject media</_message>
450
<allow_any>auth_admin</allow_any>
451
<allow_inactive>auth_admin</allow_inactive>
452
<allow_active>auth_admin_keep</allow_active>
456
<!-- eject media from a drive attached to another seat -->
457
<action id="org.freedesktop.udisks2.eject-media-other-seat">
458
<_description>Eject media from a drive attached to another seat</_description>
459
<_message>Authentication is required to eject media from a drive plugged into another seat</_message>
461
<allow_any>auth_admin</allow_any>
462
<allow_inactive>auth_admin</allow_inactive>
463
<allow_active>auth_admin_keep</allow_active>
467
<!-- ###################################################################### -->
468
<!-- Modify a device (create new filesystem, partitioning, change FS label etc.) -->
470
<action id="org.freedesktop.udisks2.modify-device">
471
<_description>Modify a device</_description>
472
<_message>Authentication is required to modify a device</_message>
474
<allow_any>auth_admin</allow_any>
475
<allow_inactive>auth_admin</allow_inactive>
476
<allow_active>yes</allow_active>
480
<!-- modify a device considered a "system device" -->
481
<action id="org.freedesktop.udisks2.modify-device-system">
482
<_description>Modify a system device</_description>
483
<_message>Authentication is required to modify a device</_message>
485
<allow_any>auth_admin</allow_any>
486
<allow_inactive>auth_admin</allow_inactive>
487
<allow_active>auth_admin_keep</allow_active>
491
<!-- modify a device attached to another seat -->
492
<action id="org.freedesktop.udisks2.modify-device-other-seat">
493
<_description>Modify a device</_description>
494
<_message>Authentication is required to modify a device plugged into another seat</_message>
496
<allow_any>auth_admin</allow_any>
497
<allow_inactive>auth_admin</allow_inactive>
498
<allow_active>auth_admin_keep</allow_active>
502
<!-- rescan a device -->
503
<action id="org.freedesktop.udisks2.rescan">
504
<_description>Rescan a device</_description>
505
<_message>Authentication is to rescan a device</_message>
507
<allow_any>auth_admin</allow_any>
508
<allow_inactive>auth_admin</allow_inactive>
509
<allow_active>yes</allow_active>
513
<!-- ###################################################################### -->
514
<!-- Open a device for reading (for creating / restoring disk images) -->
516
<action id="org.freedesktop.udisks2.open-device">
517
<_description>Open a device</_description>
518
<_message>Authentication is required to open a device</_message>
520
<allow_any>auth_admin</allow_any>
521
<allow_inactive>auth_admin</allow_inactive>
522
<allow_active>auth_admin_keep</allow_active>
526
<action id="org.freedesktop.udisks2.open-device-system">
527
<_description>Open a system device</_description>
528
<_message>Authentication is required to open a device</_message>
530
<allow_any>auth_admin</allow_any>
531
<allow_inactive>auth_admin</allow_inactive>
532
<allow_active>auth_admin_keep</allow_active>
536
<!-- ###################################################################### -->
537
<!-- Manage system-wide configuration files such as /etc/fstab or
538
/etc/crypttab ... including files referenced by these files.
540
IMPORTANT: It is not secure to automatically grant authority
541
for this action to groups of users. Neither is it secure to
542
to allow a process to retain the authorization (e.g. don't
543
use the _keep variants).
546
<action id="org.freedesktop.udisks2.modify-system-configuration">
547
<_description>Modify system-wide configuration</_description>
548
<_message>Authentication is required to modify system-wide configuration</_message>
550
<allow_any>auth_admin</allow_any>
551
<allow_inactive>auth_admin</allow_inactive>
552
<allow_active>auth_admin</allow_active>
556
<!-- Get secrets from system-wide configuration files -->
557
<action id="org.freedesktop.udisks2.read-system-configuration-secrets">
558
<_description>Modify system-wide configuration</_description>
559
<_message>Authentication is required to retrieve secrets from system-wide configuration</_message>
561
<allow_any>auth_admin</allow_any>
562
<allow_inactive>auth_admin</allow_inactive>
563
<allow_active>auth_admin</allow_active>
567
<!-- ###################################################################### -->
568
<!-- Drive configuration (Power Management, Acustics, etc.) -->
570
<action id="org.freedesktop.udisks2.modify-drive-settings">
571
<_description>Modify drive settings</_description>
572
<_message>Authentication is required to modify drive settings</_message>
574
<allow_any>auth_admin</allow_any>
575
<allow_inactive>auth_admin</allow_inactive>
576
<allow_active>auth_admin_keep</allow_active>
580
<!-- ###################################################################### -->
581
<!-- ATA SMART -->
583
<!-- Update/refresh SMART data -->
584
<action id="org.freedesktop.udisks2.ata-smart-update">
585
<_description>Update SMART data</_description>
586
<_message>Authentication is required to update SMART data</_message>
588
<allow_any>auth_admin</allow_any>
589
<allow_inactive>auth_admin</allow_inactive>
590
<allow_active>yes</allow_active>
594
<!-- Set SMART data from blob -->
595
<action id="org.freedesktop.udisks2.ata-smart-simulate">
596
<_description>Set SMART data from blob</_description>
597
<_message>Authentication is required to set SMART data from blob</_message>
599
<allow_any>auth_admin</allow_any>
600
<allow_inactive>auth_admin</allow_inactive>
601
<allow_active>auth_admin_keep</allow_active>
605
<!-- Start and abort SMART self-tests -->
606
<action id="org.freedesktop.udisks2.ata-smart-selftest">
607
<_description>Run SMART self-test</_description>
608
<_message>Authentication is required to run a SMART self-test</_message>
610
<allow_any>auth_admin</allow_any>
611
<allow_inactive>auth_admin</allow_inactive>
612
<allow_active>auth_admin_keep</allow_active>
616
<!-- Enable/Disable SMART -->
617
<action id="org.freedesktop.udisks2.ata-smart-enable-disable">
618
<_description>Enable/Disable SMART</_description>
619
<_message>Authentication is required to enable/disable SMART</_message>
621
<allow_any>auth_admin</allow_any>
622
<allow_inactive>auth_admin</allow_inactive>
623
<allow_active>auth_admin_keep</allow_active>
627
<!-- ###################################################################### -->
628
<!-- ATA Power Management -->
630
<!-- Check power state -->
631
<action id="org.freedesktop.udisks2.ata-check-power">
632
<_description>Check power state</_description>
633
<_message>Authentication is required to check the power state</_message>
635
<allow_any>auth_admin</allow_any>
636
<allow_inactive>auth_admin</allow_inactive>
637
<allow_active>yes</allow_active>
641
<!-- Send standby command / resume from standby -->
642
<action id="org.freedesktop.udisks2.ata-standby">
643
<_description>Send standby command</_description>
644
<_message>Authentication is required to put a drive into standby mode</_message>
646
<allow_any>auth_admin</allow_any>
647
<allow_inactive>auth_admin</allow_inactive>
648
<allow_active>yes</allow_active>
652
<!-- Send standby command / resume from standby to a drive considered a "system device" -->
653
<action id="org.freedesktop.udisks2.ata-standby-system">
654
<_description>Send standby command to a system drive</_description>
655
<_message>Authentication is required to put a drive into standby mode</_message>
657
<allow_any>auth_admin</allow_any>
658
<allow_inactive>auth_admin</allow_inactive>
659
<allow_active>auth_admin_keep</allow_active>
663
<!-- Send standby command / resume from standby to a drive on another seat -->
664
<action id="org.freedesktop.udisks2.ata-standby-other-seat">
665
<_description>Send standby command to drive on other seat</_description>
666
<_message>Authentication is required to put a drive into standby mode</_message>
668
<allow_any>auth_admin</allow_any>
669
<allow_inactive>auth_admin</allow_inactive>
670
<allow_active>auth_admin_keep</allow_active>
674
<!-- ###################################################################### -->
675
<!-- ATA Secure Erase -->
677
<!-- Send SECURE ERASE UNIT command -->
678
<action id="org.freedesktop.udisks2.ata-secure-erase">
679
<_description>Securely erase a hard disk</_description>
680
<_message>Authentication is required to securely erase a hard disk</_message>
682
<allow_any>auth_admin</allow_any>
683
<allow_inactive>auth_admin</allow_inactive>
684
<allow_active>auth_admin_keep</allow_active>
688
<!-- ###################################################################### -->
689
<!-- Canceling jobs -->
691
<!-- Cancel own job -->
692
<action id="org.freedesktop.udisks2.cancel-job">
693
<_description>Cancel job</_description>
694
<_message>Authentication is required to cancel a job</_message>
696
<allow_any>auth_admin</allow_any>
697
<allow_inactive>auth_admin</allow_inactive>
698
<allow_active>yes</allow_active>
702
<!-- Cancel job initiated by other user -->
703
<action id="org.freedesktop.udisks2.cancel-job-other-user">
704
<_description>Cancel job started by another user</_description>
705
<_message>Authentication is required to cancel a job started by another user</_message>
707
<allow_any>auth_admin</allow_any>
708
<allow_inactive>auth_admin</allow_inactive>
709
<allow_active>auth_admin_keep</allow_active>
713
</policyconfig>
721
Generated by GTK-Doc V1.20</div>
b'\\ No newline at end of file'
added
removed
doc/html/udisks-polkit-actions.html
