← Back to branch summary

~psusi/ubuntu/utopic/udisks2/fix-standby

« back to all changes in this revision

Viewing changes to doc/html/udisks2-Utilities.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/udisks2-Utilities.html
249
249
via <em class="parameter"><code>invocation</code></em>.
250
250
</p>
251
251
<p>
252
 
The calling thread is blocked for the duration of the
253
 
authentication which may be a very long time unless
254
 
<em class="parameter"><code>auth_no_user_interaction</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
255
 
</p>
256
 
<p>
257
 
The follow variables can be used in <em class="parameter"><code>message</code></em>
258
 
</p>
259
 
<p>
260
 
</p>
261
 
<div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>udisks2.device - If <em class="parameter"><code>object</code></em> has a <a class="link" href="UDisksBlock.html" title="UDisksBlock"><span class="type">UDisksBlock</span></a> interface, this property is set to the value of the <span class="type">"preferred-device"</span> property.</p></li></ul></div>
262
 
<p>
 
252
The calling thread is blocked for the duration of the authorization
 
253
check which could be a very long time since it may involve
 
254
presenting an authentication dialog and having a human user use
 
255
it. If <span class="quote">“<span class="quote">auth.no_user_interaction</span>”</span> in <em class="parameter"><code>options</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
 
256
no authentication dialog will be presented and the check is not
 
257
expected to take a long time.
 
258
</p>
 
259
<p>
 
260
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 variables that
 
261
can be used in <em class="parameter"><code>message</code></em> but note that not all variables can be used
 
262
in all checks. For example, any check involving a <a class="link" href="UDisksDrive.html" title="UDisksDrive"><span class="type">UDisksDrive</span></a> or a
 
263
<a class="link" href="UDisksBlock.html" title="UDisksBlock"><span class="type">UDisksBlock</span></a> object can safely include the fragment
 
264
<span class="quote">“<span class="quote">$(drive)</span>”</span> since it will always expand to the name of
 
265
the drive, e.g. <span class="quote">“<span class="quote">INTEL SSDSA2MH080G1GC (/dev/sda1)</span>”</span> or
 
266
the block device file e.g. <span class="quote">“<span class="quote">/dev/vg_lucifer/lv_root</span>”</span>
 
267
or <span class="quote">“<span class="quote">/dev/sda1</span>”</span>. However this won't work for operations
 
268
that isn't on a drive or block device, for example calls on the
 
269
<a class="link" href="gdbus-org.freedesktop.UDisks2.Manager.html#gdbus-interface-org-freedesktop-UDisks2-Manager.top_of_page">Manager</a>
 
270
object.
263
271
</p>
264
272
<div class="variablelist"><table border="0">
265
273
<col align="left" valign="top">
279
287
</tr>
280
288
<tr>
281
289
<td><p><span class="term"><em class="parameter"><code>options</code></em> :</span></p></td>
282
 
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to check for the <code class="literal">auth.no_user_interaction</code> option or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
 
290
<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> to check for the <span class="quote">“<span class="quote">auth.no_user_interaction</span>”</span> option or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
283
291
</td>
284
292
</tr>
285
293
<tr>