← Back to branch summary

~ubuntu-multiseat/ubuntu/trusty/udisks2/full-logind-support

« back to all changes in this revision

Viewing changes to doc/html/udisks-polkit-actions.html

  • Committer: Package Import Robot
  • Author(s): Martin Pitt
  • Date: 2012-06-13 17:01:30 UTC
  • mfrom: (1.1.1) (2.1.1 experimental)
  • Revision ID: package-import@ubuntu.com-20120613170130-9jggrd76bkv1vd0b
Tags: 1.98.0-1
* New upstream release.
* debian/control: Drop ntfsprogs Recommends. It is a transitional package
  for ntfs-3g now, which we already recommend.
* Add 00git_no_polkit_fallback.patch: Fix crash if polkit is not available.
  Patch backported from current upstream git head.
* Add debian/local/integration-test: Latest integration test suite from
  upstream git. 1.99 and later will ship that in the source tarball.
* Add debian/tests/control and debian/tests/upstream-system: DEP-8
  autopkgtest (adapted from udisks package).
* debian/control: Change suggestion of cryptsetup to cryptsetup-bin, as that
  is sufficient for udisks' needs.
* debian/copyright: Fix duplicate copyright line, thanks lintian.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/html/udisks-polkit-actions.html
26
26
          Many methods and operations offered by udisks requires the
27
27
          calling user to be sufficiently authorized. Whether the user
28
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
 
          and the administrator can configure <a class="ulink" href="http://www.freedesktop.org/software/polkit/docs/latest/pklocalauthority.8.html" target="_top">polkit's
30
 
          local authority</a> (but note that the system may be
31
 
          using another polkit authority implementation).
 
29
          allowing the administrator to configure fine-grained permissions via
 
30
          polkit authorization rules.
32
31
        </p>
33
32
<p>
34
33
          There is not necessarily a one-to-one relationship between
62
61
          The polkit actions are not considered stable and may change
63
62
          from release to release so administrators should take notice
64
63
          when upgrading from one version of udisks to another. For
65
 
          example, <code class="filename">.pkla</code> files may need to be
66
 
          updated to match an updated policy.
67
 
          For reference, the polkit actions defined by udisks 1.97.0
 
64
          example, polkit authorization rules may need to be updated
 
65
          to match an updated policy.
 
66
        </p>
 
67
<p>
 
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
 
72
          any of the
 
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
 
76
          block device.
 
77
        </p>
 
78
<div class="table">
 
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">
 
81
<colgroup>
 
82
<col>
 
83
<col>
 
84
</colgroup>
 
85
<thead><tr>
 
86
<th align="left">key</th>
 
87
<th align="left">value</th>
 
88
</tr></thead>
 
89
<tbody>
 
90
<tr>
 
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>
 
93
</tr>
 
94
<tr>
 
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>
 
97
</tr>
 
98
<tr>
 
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>
 
101
</tr>
 
102
<tr>
 
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>
 
105
</tr>
 
106
<tr>
 
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>
 
109
</tr>
 
110
<tr>
 
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>
 
113
</tr>
 
114
<tr>
 
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>
 
117
</tr>
 
118
<tr>
 
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>
 
121
</tr>
 
122
<tr>
 
123
<td align="left"><em class="parameter"><code>id.type</code></em></td>
 
124
<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>
 
125
</tr>
 
126
<tr>
 
127
<td align="left"><em class="parameter"><code>id.usage</code></em></td>
 
128
<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>
 
129
</tr>
 
130
<tr>
 
131
<td align="left"><em class="parameter"><code>id.version</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.IdVersion" title='The "IdVersion" property'>Block:IdVersion</a> property.</td>
 
133
</tr>
 
134
<tr>
 
135
<td align="left"><em class="parameter"><code>id.label</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.IdLabel" title='The "IdLabel" property'>Block:IdLabel</a> property.</td>
 
137
</tr>
 
138
<tr>
 
139
<td align="left"><em class="parameter"><code>id.uuid</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.IdUUID" title='The "IdUUID" property'>Block:IdUUID</a> property.</td>
 
141
</tr>
 
142
<tr>
 
143
<td align="left"><em class="parameter"><code>partition.number</code></em></td>
 
144
<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>
 
145
</tr>
 
146
<tr>
 
147
<td align="left"><em class="parameter"><code>partition.type</code></em></td>
 
148
<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>
 
149
</tr>
 
150
<tr>
 
151
<td align="left"><em class="parameter"><code>partition.flags</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.Flags" title='The "Flags" property'>Partition:Flags</a> property.</td>
 
153
</tr>
 
154
<tr>
 
155
<td align="left"><em class="parameter"><code>partition.name</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.Name" title='The "Name" property'>Partition:Name</a> property.</td>
 
157
</tr>
 
158
<tr>
 
159
<td align="left"><em class="parameter"><code>partition.uuid</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.UUID" title='The "UUID" property'>Partition:UUID</a> property.</td>
 
161
</tr>
 
162
</tbody>
 
163
</table></div>
 
164
</div>
 
165
<br class="table-break"><p>
 
166
          For reference, the polkit actions defined by udisks 1.98.0
68
167
 
69
168
          are included here:
70
169
          </p>
412
511
    &lt;/defaults&gt;
413
512
  &lt;/action&gt;
414
513
 
 
514
  &lt;!-- Set SMART data from blob --&gt;
 
515
  &lt;action id="org.freedesktop.udisks2.ata-smart-simulate"&gt;
 
516
    &lt;_description&gt;Set SMART data from blob&lt;/_description&gt;
 
517
    &lt;_message&gt;Authentication is required to set SMART data from blob&lt;/_message&gt;
 
518
    &lt;defaults&gt;
 
519
      &lt;allow_any&gt;auth_admin&lt;/allow_any&gt;
 
520
      &lt;allow_inactive&gt;auth_admin&lt;/allow_inactive&gt;
 
521
      &lt;allow_active&gt;auth_admin_keep&lt;/allow_active&gt;
 
522
    &lt;/defaults&gt;
 
523
  &lt;/action&gt;
 
524
 
415
525
  &lt;!-- Start and abort SMART self-tests --&gt;
416
526
  &lt;action id="org.freedesktop.udisks2.ata-smart-selftest"&gt;
417
527
    &lt;_description&gt;Run SMART self-test&lt;/_description&gt;