docs/reference/gio/html/GMountOperation.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>GMountOperation</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GIO Reference Manual">
   8 <link rel="up" href="file_ops.html" title="File Operations">
   9 <link rel="prev" href="gio-GIOError.html" title="GIOError">
  10 <link rel="next" href="file_mon.html" title="File System Monitoring">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  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="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="gio-GIOError.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="file_ops.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GIO Reference Manual</th>
  21 <td><a accesskey="n" href="file_mon.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#GMountOperation.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#GMountOperation.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#GMountOperation.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#GMountOperation.properties" class="shortcut">Properties</a>
  31                    |
  32                   <a href="#GMountOperation.signals" class="shortcut">Signals</a>
  33 </td></tr>
  34 </table>
  35 <div class="refentry">
  36 <a name="GMountOperation"></a><div class="titlepage"></div>
  37 <div class="refnamediv"><table width="100%"><tr>
  38 <td valign="top">
  39 <h2><span class="refentrytitle"><a name="GMountOperation.top_of_page"></a>GMountOperation</span></h2>
  40 <p>GMountOperation — Object used for authentication and user interaction</p>
  41 </td>
  42 <td valign="top" align="right"></td>
  43 </tr></table></div>
  44 <div class="refsynopsisdiv">
  45 <a name="GMountOperation.synopsis"></a><h2>Synopsis</h2>
  46 <pre class="synopsis">
  47 #include &lt;gio/gio.h&gt;
  48
  49 enum                <a class="link" href="GMountOperation.html#GAskPasswordFlags" title="enum GAskPasswordFlags">GAskPasswordFlags</a>;
  50 enum                <a class="link" href="GMountOperation.html#GPasswordSave" title="enum GPasswordSave">GPasswordSave</a>;
  51                     <a class="link" href="GMountOperation.html#GMountOperation-struct" title="GMountOperation">GMountOperation</a>;
  52 enum                <a class="link" href="GMountOperation.html#GMountOperationResult" title="enum GMountOperationResult">GMountOperationResult</a>;
  53 <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="returnvalue">GMountOperation</span></a> *   <a class="link" href="GMountOperation.html#g-mount-operation-new" title="g_mount_operation_new ()">g_mount_operation_new</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
  54 const <span class="returnvalue">char</span> *        <a class="link" href="GMountOperation.html#g-mount-operation-get-username" title="g_mount_operation_get_username ()">g_mount_operation_get_username</a>      (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);
  55 <span class="returnvalue">void</span>                <a class="link" href="GMountOperation.html#g-mount-operation-set-username" title="g_mount_operation_set_username ()">g_mount_operation_set_username</a>      (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
  56                                                          <em class="parameter"><code>const <span class="type">char</span> *username</code></em>);
  57 const <span class="returnvalue">char</span> *        <a class="link" href="GMountOperation.html#g-mount-operation-get-password" title="g_mount_operation_get_password ()">g_mount_operation_get_password</a>      (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);
  58 <span class="returnvalue">void</span>                <a class="link" href="GMountOperation.html#g-mount-operation-set-password" title="g_mount_operation_set_password ()">g_mount_operation_set_password</a>      (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
  59                                                          <em class="parameter"><code>const <span class="type">char</span> *password</code></em>);
  60 <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GMountOperation.html#g-mount-operation-get-anonymous" title="g_mount_operation_get_anonymous ()">g_mount_operation_get_anonymous</a>     (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);
  61 <span class="returnvalue">void</span>                <a class="link" href="GMountOperation.html#g-mount-operation-set-anonymous" title="g_mount_operation_set_anonymous ()">g_mount_operation_set_anonymous</a>     (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
  62                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> anonymous</code></em>);
  63 const <span class="returnvalue">char</span> *        <a class="link" href="GMountOperation.html#g-mount-operation-get-domain" title="g_mount_operation_get_domain ()">g_mount_operation_get_domain</a>        (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);
  64 <span class="returnvalue">void</span>                <a class="link" href="GMountOperation.html#g-mount-operation-set-domain" title="g_mount_operation_set_domain ()">g_mount_operation_set_domain</a>        (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
  65                                                          <em class="parameter"><code>const <span class="type">char</span> *domain</code></em>);
  66 <a class="link" href="GMountOperation.html#GPasswordSave" title="enum GPasswordSave"><span class="returnvalue">GPasswordSave</span></a>       <a class="link" href="GMountOperation.html#g-mount-operation-get-password-save" title="g_mount_operation_get_password_save ()">g_mount_operation_get_password_save</a> (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);
  67 <span class="returnvalue">void</span>                <a class="link" href="GMountOperation.html#g-mount-operation-set-password-save" title="g_mount_operation_set_password_save ()">g_mount_operation_set_password_save</a> (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
  68                                                          <em class="parameter"><code><a class="link" href="GMountOperation.html#GPasswordSave" title="enum GPasswordSave"><span class="type">GPasswordSave</span></a> save</code></em>);
  69 <span class="returnvalue">int</span>                 <a class="link" href="GMountOperation.html#g-mount-operation-get-choice" title="g_mount_operation_get_choice ()">g_mount_operation_get_choice</a>        (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);
  70 <span class="returnvalue">void</span>                <a class="link" href="GMountOperation.html#g-mount-operation-set-choice" title="g_mount_operation_set_choice ()">g_mount_operation_set_choice</a>        (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
  71                                                          <em class="parameter"><code><span class="type">int</span> choice</code></em>);
  72 <span class="returnvalue">void</span>                <a class="link" href="GMountOperation.html#g-mount-operation-reply" title="g_mount_operation_reply ()">g_mount_operation_reply</a>             (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
  73                                                          <em class="parameter"><code><a class="link" href="GMountOperation.html#GMountOperationResult" title="enum GMountOperationResult"><span class="type">GMountOperationResult</span></a> result</code></em>);
  74 </pre>
  75 </div>
  76 <div class="refsect1">
  77 <a name="GMountOperation.object-hierarchy"></a><h2>Object Hierarchy</h2>
  78 <pre class="synopsis">
  79   <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
  80    +----GMountOperation
  81 </pre>
  82 </div>
  83 <div class="refsect1">
  84 <a name="GMountOperation.properties"></a><h2>Properties</h2>
  85 <pre class="synopsis">
  86   "<a class="link" href="GMountOperation.html#GMountOperation--anonymous" title='The "anonymous" property'>anonymous</a>"                <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  87   "<a class="link" href="GMountOperation.html#GMountOperation--choice" title='The "choice" property'>choice</a>"                   <a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
  88   "<a class="link" href="GMountOperation.html#GMountOperation--domain" title='The "domain" property'>domain</a>"                   <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
  89   "<a class="link" href="GMountOperation.html#GMountOperation--password" title='The "password" property'>password</a>"                 <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
  90   "<a class="link" href="GMountOperation.html#GMountOperation--password-save" title='The "password-save" property'>password-save</a>"            <a class="link" href="GMountOperation.html#GPasswordSave" title="enum GPasswordSave"><span class="type">GPasswordSave</span></a>         : Read / Write
  91   "<a class="link" href="GMountOperation.html#GMountOperation--username" title='The "username" property'>username</a>"                 <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
  92 </pre>
  93 </div>
  94 <div class="refsect1">
  95 <a name="GMountOperation.signals"></a><h2>Signals</h2>
  96 <pre class="synopsis">
  97   "<a class="link" href="GMountOperation.html#GMountOperation-aborted" title='The "aborted" signal'>aborted</a>"                                        : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  98   "<a class="link" href="GMountOperation.html#GMountOperation-ask-password" title='The "ask-password" signal'>ask-password</a>"                                   : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  99   "<a class="link" href="GMountOperation.html#GMountOperation-ask-question" title='The "ask-question" signal'>ask-question</a>"                                   : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 100   "<a class="link" href="GMountOperation.html#GMountOperation-reply" title='The "reply" signal'>reply</a>"                                          : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 101   "<a class="link" href="GMountOperation.html#GMountOperation-show-processes" title='The "show-processes" signal'>show-processes</a>"                                 : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 102 </pre>
 103 </div>
 104 <div class="refsect1">
 105 <a name="GMountOperation.description"></a><h2>Description</h2>
 106 <p>
 107 <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> provides a mechanism for interacting with the user.
 108 It can be used for authenticating mountable operations, such as loop
 109 mounting files, hard drive partitions or server locations. It can
 110 also be used to ask the user questions or show a list of applications
 111 preventing unmount or eject operations from completing.
 112 </p>
 113 <p>
 114 Note that <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> is used for more than just <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>
 115 objects – for example it is also used in <a class="link" href="GDrive.html#g-drive-start" title="g_drive_start ()"><code class="function">g_drive_start()</code></a> and
 116 <a class="link" href="GDrive.html#g-drive-stop" title="g_drive_stop ()"><code class="function">g_drive_stop()</code></a>.
 117 </p>
 118 <p>
 119 Users should instantiate a subclass of this that implements all the
 120 various callbacks to show the required dialogs, such as
 121 <a href="http://developer.gnome.org/devel/gtk/gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a>. If no user interaction is desired (for example
 122 when automounting filesystems at login time), usually <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> can be
 123 passed, see each method taking a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> for details.
 124 </p>
 125 </div>
 126 <div class="refsect1">
 127 <a name="GMountOperation.details"></a><h2>Details</h2>
 128 <div class="refsect2">
 129 <a name="GAskPasswordFlags"></a><h3>enum GAskPasswordFlags</h3>
 130 <pre class="programlisting">typedef enum {
 131   G_ASK_PASSWORD_NEED_PASSWORD       = (1 &lt;&lt; 0),
 132   G_ASK_PASSWORD_NEED_USERNAME       = (1 &lt;&lt; 1),
 133   G_ASK_PASSWORD_NEED_DOMAIN         = (1 &lt;&lt; 2),
 134   G_ASK_PASSWORD_SAVING_SUPPORTED    = (1 &lt;&lt; 3),
 135   G_ASK_PASSWORD_ANONYMOUS_SUPPORTED = (1 &lt;&lt; 4)
 136 } GAskPasswordFlags;
 137 </pre>
 138 <p>
 139 <a class="link" href="GMountOperation.html#GAskPasswordFlags" title="enum GAskPasswordFlags"><span class="type">GAskPasswordFlags</span></a> are used to request specific information from the
 140 user, or to notify the user of their choices in an authentication
 141 situation.
 142 </p>
 143 <div class="variablelist"><table border="0">
 144 <col align="left" valign="top">
 145 <tbody>
 146 <tr>
 147 <td><p><a name="G-ASK-PASSWORD-NEED-PASSWORD:CAPS"></a><span class="term"><code class="literal">G_ASK_PASSWORD_NEED_PASSWORD</code></span></p></td>
 148 <td>operation requires a password.
 149 </td>
 150 </tr>
 151 <tr>
 152 <td><p><a name="G-ASK-PASSWORD-NEED-USERNAME:CAPS"></a><span class="term"><code class="literal">G_ASK_PASSWORD_NEED_USERNAME</code></span></p></td>
 153 <td>operation requires a username.
 154 </td>
 155 </tr>
 156 <tr>
 157 <td><p><a name="G-ASK-PASSWORD-NEED-DOMAIN:CAPS"></a><span class="term"><code class="literal">G_ASK_PASSWORD_NEED_DOMAIN</code></span></p></td>
 158 <td>operation requires a domain.
 159 </td>
 160 </tr>
 161 <tr>
 162 <td><p><a name="G-ASK-PASSWORD-SAVING-SUPPORTED:CAPS"></a><span class="term"><code class="literal">G_ASK_PASSWORD_SAVING_SUPPORTED</code></span></p></td>
 163 <td>operation supports saving settings.
 164 </td>
 165 </tr>
 166 <tr>
 167 <td><p><a name="G-ASK-PASSWORD-ANONYMOUS-SUPPORTED:CAPS"></a><span class="term"><code class="literal">G_ASK_PASSWORD_ANONYMOUS_SUPPORTED</code></span></p></td>
 168 <td>operation supports anonymous users.
 169 </td>
 170 </tr>
 171 </tbody>
 172 </table></div>
 173 </div>
 174 <hr>
 175 <div class="refsect2">
 176 <a name="GPasswordSave"></a><h3>enum GPasswordSave</h3>
 177 <pre class="programlisting">typedef enum {
 178   G_PASSWORD_SAVE_NEVER,
 179   G_PASSWORD_SAVE_FOR_SESSION,
 180   G_PASSWORD_SAVE_PERMANENTLY
 181 } GPasswordSave;
 182 </pre>
 183 <p>
 184 <a class="link" href="GMountOperation.html#GPasswordSave" title="enum GPasswordSave"><span class="type">GPasswordSave</span></a> is used to indicate the lifespan of a saved password.
 185 </p>
 186 <p>
 187 <span class="type">Gvfs</span> stores passwords in the Gnome keyring when this flag allows it
 188 to, and later retrieves it again from there.
 189 </p>
 190 <div class="variablelist"><table border="0">
 191 <col align="left" valign="top">
 192 <tbody>
 193 <tr>
 194 <td><p><a name="G-PASSWORD-SAVE-NEVER:CAPS"></a><span class="term"><code class="literal">G_PASSWORD_SAVE_NEVER</code></span></p></td>
 195 <td>never save a password.
 196 </td>
 197 </tr>
 198 <tr>
 199 <td><p><a name="G-PASSWORD-SAVE-FOR-SESSION:CAPS"></a><span class="term"><code class="literal">G_PASSWORD_SAVE_FOR_SESSION</code></span></p></td>
 200 <td>save a password for the session.
 201 </td>
 202 </tr>
 203 <tr>
 204 <td><p><a name="G-PASSWORD-SAVE-PERMANENTLY:CAPS"></a><span class="term"><code class="literal">G_PASSWORD_SAVE_PERMANENTLY</code></span></p></td>
 205 <td>save a password permanently.
 206 </td>
 207 </tr>
 208 </tbody>
 209 </table></div>
 210 </div>
 211 <hr>
 212 <div class="refsect2">
 213 <a name="GMountOperation-struct"></a><h3>GMountOperation</h3>
 214 <pre class="programlisting">typedef struct _GMountOperation GMountOperation;</pre>
 215 <p>
 216 Class for providing authentication methods for mounting operations,
 217 such as mounting a file locally, or authenticating with a server.
 218 </p>
 219 </div>
 220 <hr>
 221 <div class="refsect2">
 222 <a name="GMountOperationResult"></a><h3>enum GMountOperationResult</h3>
 223 <pre class="programlisting">typedef enum {
 224   G_MOUNT_OPERATION_HANDLED,
 225   G_MOUNT_OPERATION_ABORTED,
 226   G_MOUNT_OPERATION_UNHANDLED
 227 } GMountOperationResult;
 228 </pre>
 229 <p>
 230 <a class="link" href="GMountOperation.html#GMountOperationResult" title="enum GMountOperationResult"><span class="type">GMountOperationResult</span></a> is returned as a result when a request for
 231 information is send by the mounting operation.
 232 </p>
 233 <div class="variablelist"><table border="0">
 234 <col align="left" valign="top">
 235 <tbody>
 236 <tr>
 237 <td><p><a name="G-MOUNT-OPERATION-HANDLED:CAPS"></a><span class="term"><code class="literal">G_MOUNT_OPERATION_HANDLED</code></span></p></td>
 238 <td>The request was fulfilled and the
 239     user specified data is now available
 240 </td>
 241 </tr>
 242 <tr>
 243 <td><p><a name="G-MOUNT-OPERATION-ABORTED:CAPS"></a><span class="term"><code class="literal">G_MOUNT_OPERATION_ABORTED</code></span></p></td>
 244 <td>The user requested the mount operation
 245     to be aborted
 246 </td>
 247 </tr>
 248 <tr>
 249 <td><p><a name="G-MOUNT-OPERATION-UNHANDLED:CAPS"></a><span class="term"><code class="literal">G_MOUNT_OPERATION_UNHANDLED</code></span></p></td>
 250 <td>The request was unhandled (i.e. not
 251     implemented)
 252 </td>
 253 </tr>
 254 </tbody>
 255 </table></div>
 256 </div>
 257 <hr>
 258 <div class="refsect2">
 259 <a name="g-mount-operation-new"></a><h3>g_mount_operation_new ()</h3>
 260 <pre class="programlisting"><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="returnvalue">GMountOperation</span></a> *   g_mount_operation_new               (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 261 <p>
 262 Creates a new mount operation.
 263 </p>
 264 <div class="variablelist"><table border="0">
 265 <col align="left" valign="top">
 266 <tbody><tr>
 267 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 268 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 269 </tr></tbody>
 270 </table></div>
 271 </div>
 272 <hr>
 273 <div class="refsect2">
 274 <a name="g-mount-operation-get-username"></a><h3>g_mount_operation_get_username ()</h3>
 275 <pre class="programlisting">const <span class="returnvalue">char</span> *        g_mount_operation_get_username      (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);</pre>
 276 <p>
 277 Get the user name from the mount operation.
 278 </p>
 279 <div class="variablelist"><table border="0">
 280 <col align="left" valign="top">
 281 <tbody>
 282 <tr>
 283 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 284 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 285 </tr>
 286 <tr>
 287 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 288 <td>a string containing the user name.</td>
 289 </tr>
 290 </tbody>
 291 </table></div>
 292 </div>
 293 <hr>
 294 <div class="refsect2">
 295 <a name="g-mount-operation-set-username"></a><h3>g_mount_operation_set_username ()</h3>
 296 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_operation_set_username      (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
 297                                                          <em class="parameter"><code>const <span class="type">char</span> *username</code></em>);</pre>
 298 <p>
 299 Sets the user name within <em class="parameter"><code>op</code></em> to <em class="parameter"><code>username</code></em>.
 300 </p>
 301 <div class="variablelist"><table border="0">
 302 <col align="left" valign="top">
 303 <tbody>
 304 <tr>
 305 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 306 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 307 </tr>
 308 <tr>
 309 <td><p><span class="term"><em class="parameter"><code>username</code></em> :</span></p></td>
 310 <td>input username.</td>
 311 </tr>
 312 </tbody>
 313 </table></div>
 314 </div>
 315 <hr>
 316 <div class="refsect2">
 317 <a name="g-mount-operation-get-password"></a><h3>g_mount_operation_get_password ()</h3>
 318 <pre class="programlisting">const <span class="returnvalue">char</span> *        g_mount_operation_get_password      (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);</pre>
 319 <p>
 320 Gets a password from the mount operation.
 321 </p>
 322 <div class="variablelist"><table border="0">
 323 <col align="left" valign="top">
 324 <tbody>
 325 <tr>
 326 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 327 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 328 </tr>
 329 <tr>
 330 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 331 <td>a string containing the password within <em class="parameter"><code>op</code></em>.</td>
 332 </tr>
 333 </tbody>
 334 </table></div>
 335 </div>
 336 <hr>
 337 <div class="refsect2">
 338 <a name="g-mount-operation-set-password"></a><h3>g_mount_operation_set_password ()</h3>
 339 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_operation_set_password      (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
 340                                                          <em class="parameter"><code>const <span class="type">char</span> *password</code></em>);</pre>
 341 <p>
 342 Sets the mount operation's password to <em class="parameter"><code>password</code></em>.
 343 </p>
 344 <div class="variablelist"><table border="0">
 345 <col align="left" valign="top">
 346 <tbody>
 347 <tr>
 348 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 349 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 350 </tr>
 351 <tr>
 352 <td><p><span class="term"><em class="parameter"><code>password</code></em> :</span></p></td>
 353 <td>password to set.</td>
 354 </tr>
 355 </tbody>
 356 </table></div>
 357 </div>
 358 <hr>
 359 <div class="refsect2">
 360 <a name="g-mount-operation-get-anonymous"></a><h3>g_mount_operation_get_anonymous ()</h3>
 361 <pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_mount_operation_get_anonymous     (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);</pre>
 362 <p>
 363 Check to see whether the mount operation is being used
 364 for an anonymous user.
 365 </p>
 366 <div class="variablelist"><table border="0">
 367 <col align="left" valign="top">
 368 <tbody>
 369 <tr>
 370 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 371 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 372 </tr>
 373 <tr>
 374 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 375 <td>
 376 <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if mount operation is anonymous.</td>
 377 </tr>
 378 </tbody>
 379 </table></div>
 380 </div>
 381 <hr>
 382 <div class="refsect2">
 383 <a name="g-mount-operation-set-anonymous"></a><h3>g_mount_operation_set_anonymous ()</h3>
 384 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_operation_set_anonymous     (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
 385                                                          <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> anonymous</code></em>);</pre>
 386 <p>
 387 Sets the mount operation to use an anonymous user if <em class="parameter"><code>anonymous</code></em> is <a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
 388 </p>
 389 <div class="variablelist"><table border="0">
 390 <col align="left" valign="top">
 391 <tbody>
 392 <tr>
 393 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 394 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 395 </tr>
 396 <tr>
 397 <td><p><span class="term"><em class="parameter"><code>anonymous</code></em> :</span></p></td>
 398 <td>boolean value.</td>
 399 </tr>
 400 </tbody>
 401 </table></div>
 402 </div>
 403 <hr>
 404 <div class="refsect2">
 405 <a name="g-mount-operation-get-domain"></a><h3>g_mount_operation_get_domain ()</h3>
 406 <pre class="programlisting">const <span class="returnvalue">char</span> *        g_mount_operation_get_domain        (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);</pre>
 407 <p>
 408 Gets the domain of the mount operation.
 409 </p>
 410 <div class="variablelist"><table border="0">
 411 <col align="left" valign="top">
 412 <tbody>
 413 <tr>
 414 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 415 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 416 </tr>
 417 <tr>
 418 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 419 <td>a string set to the domain.</td>
 420 </tr>
 421 </tbody>
 422 </table></div>
 423 </div>
 424 <hr>
 425 <div class="refsect2">
 426 <a name="g-mount-operation-set-domain"></a><h3>g_mount_operation_set_domain ()</h3>
 427 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_operation_set_domain        (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
 428                                                          <em class="parameter"><code>const <span class="type">char</span> *domain</code></em>);</pre>
 429 <p>
 430 Sets the mount operation's domain.
 431 </p>
 432 <div class="variablelist"><table border="0">
 433 <col align="left" valign="top">
 434 <tbody>
 435 <tr>
 436 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 437 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 438 </tr>
 439 <tr>
 440 <td><p><span class="term"><em class="parameter"><code>domain</code></em> :</span></p></td>
 441 <td>the domain to set.</td>
 442 </tr>
 443 </tbody>
 444 </table></div>
 445 </div>
 446 <hr>
 447 <div class="refsect2">
 448 <a name="g-mount-operation-get-password-save"></a><h3>g_mount_operation_get_password_save ()</h3>
 449 <pre class="programlisting"><a class="link" href="GMountOperation.html#GPasswordSave" title="enum GPasswordSave"><span class="returnvalue">GPasswordSave</span></a>       g_mount_operation_get_password_save (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);</pre>
 450 <p>
 451 Gets the state of saving passwords for the mount operation.
 452 </p>
 453 <div class="variablelist"><table border="0">
 454 <col align="left" valign="top">
 455 <tbody>
 456 <tr>
 457 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 458 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 459 </tr>
 460 <tr>
 461 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 462 <td>a <a class="link" href="GMountOperation.html#GPasswordSave" title="enum GPasswordSave"><span class="type">GPasswordSave</span></a> flag.</td>
 463 </tr>
 464 </tbody>
 465 </table></div>
 466 </div>
 467 <hr>
 468 <div class="refsect2">
 469 <a name="g-mount-operation-set-password-save"></a><h3>g_mount_operation_set_password_save ()</h3>
 470 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_operation_set_password_save (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
 471                                                          <em class="parameter"><code><a class="link" href="GMountOperation.html#GPasswordSave" title="enum GPasswordSave"><span class="type">GPasswordSave</span></a> save</code></em>);</pre>
 472 <p>
 473 Sets the state of saving passwords for the mount operation.
 474 </p>
 475 <div class="variablelist"><table border="0">
 476 <col align="left" valign="top">
 477 <tbody>
 478 <tr>
 479 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 480 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 481 </tr>
 482 <tr>
 483 <td><p><span class="term"><em class="parameter"><code>save</code></em> :</span></p></td>
 484 <td>a set of <a class="link" href="GMountOperation.html#GPasswordSave" title="enum GPasswordSave"><span class="type">GPasswordSave</span></a> flags.</td>
 485 </tr>
 486 </tbody>
 487 </table></div>
 488 </div>
 489 <hr>
 490 <div class="refsect2">
 491 <a name="g-mount-operation-get-choice"></a><h3>g_mount_operation_get_choice ()</h3>
 492 <pre class="programlisting"><span class="returnvalue">int</span>                 g_mount_operation_get_choice        (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>);</pre>
 493 <p>
 494 Gets a choice from the mount operation.
 495 </p>
 496 <div class="variablelist"><table border="0">
 497 <col align="left" valign="top">
 498 <tbody>
 499 <tr>
 500 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 501 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 502 </tr>
 503 <tr>
 504 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 505 <td>an integer containing an index of the user's choice from
 506 the choice's list, or <code class="literal">0</code>.</td>
 507 </tr>
 508 </tbody>
 509 </table></div>
 510 </div>
 511 <hr>
 512 <div class="refsect2">
 513 <a name="g-mount-operation-set-choice"></a><h3>g_mount_operation_set_choice ()</h3>
 514 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_operation_set_choice        (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
 515                                                          <em class="parameter"><code><span class="type">int</span> choice</code></em>);</pre>
 516 <p>
 517 Sets a default choice for the mount operation.
 518 </p>
 519 <div class="variablelist"><table border="0">
 520 <col align="left" valign="top">
 521 <tbody>
 522 <tr>
 523 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 524 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 525 </tr>
 526 <tr>
 527 <td><p><span class="term"><em class="parameter"><code>choice</code></em> :</span></p></td>
 528 <td>an integer.</td>
 529 </tr>
 530 </tbody>
 531 </table></div>
 532 </div>
 533 <hr>
 534 <div class="refsect2">
 535 <a name="g-mount-operation-reply"></a><h3>g_mount_operation_reply ()</h3>
 536 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_operation_reply             (<em class="parameter"><code><a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op</code></em>,
 537                                                          <em class="parameter"><code><a class="link" href="GMountOperation.html#GMountOperationResult" title="enum GMountOperationResult"><span class="type">GMountOperationResult</span></a> result</code></em>);</pre>
 538 <p>
 539 Emits the <a class="link" href="GMountOperation.html#GMountOperation-reply" title='The "reply" signal'><span class="type">"reply"</span></a> signal.
 540 </p>
 541 <div class="variablelist"><table border="0">
 542 <col align="left" valign="top">
 543 <tbody>
 544 <tr>
 545 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 546 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>
 547 </td>
 548 </tr>
 549 <tr>
 550 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
 551 <td>a <a class="link" href="GMountOperation.html#GMountOperationResult" title="enum GMountOperationResult"><span class="type">GMountOperationResult</span></a>
 552 </td>
 553 </tr>
 554 </tbody>
 555 </table></div>
 556 </div>
 557 </div>
 558 <div class="refsect1">
 559 <a name="GMountOperation.property-details"></a><h2>Property Details</h2>
 560 <div class="refsect2">
 561 <a name="GMountOperation--anonymous"></a><h3>The <code class="literal">"anonymous"</code> property</h3>
 562 <pre class="programlisting">  "anonymous"                <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 563 <p>
 564 Whether to use an anonymous user when authenticating.
 565 </p>
 566 <p>Default value: FALSE</p>
 567 </div>
 568 <hr>
 569 <div class="refsect2">
 570 <a name="GMountOperation--choice"></a><h3>The <code class="literal">"choice"</code> property</h3>
 571 <pre class="programlisting">  "choice"                   <a href="./../glib/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 572 <p>
 573 The index of the user's choice when a question is asked during the
 574 mount operation. See the <a class="link" href="GMountOperation.html#GMountOperation-ask-question" title='The "ask-question" signal'><span class="type">"ask-question"</span></a> signal.
 575 </p>
 576 <p>Allowed values: &gt;= 0</p>
 577 <p>Default value: 0</p>
 578 </div>
 579 <hr>
 580 <div class="refsect2">
 581 <a name="GMountOperation--domain"></a><h3>The <code class="literal">"domain"</code> property</h3>
 582 <pre class="programlisting">  "domain"                   <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 583 <p>
 584 The domain to use for the mount operation.
 585 </p>
 586 <p>Default value: NULL</p>
 587 </div>
 588 <hr>
 589 <div class="refsect2">
 590 <a name="GMountOperation--password"></a><h3>The <code class="literal">"password"</code> property</h3>
 591 <pre class="programlisting">  "password"                 <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 592 <p>
 593 The password that is used for authentication when carrying out
 594 the mount operation.
 595 </p>
 596 <p>Default value: NULL</p>
 597 </div>
 598 <hr>
 599 <div class="refsect2">
 600 <a name="GMountOperation--password-save"></a><h3>The <code class="literal">"password-save"</code> property</h3>
 601 <pre class="programlisting">  "password-save"            <a class="link" href="GMountOperation.html#GPasswordSave" title="enum GPasswordSave"><span class="type">GPasswordSave</span></a>         : Read / Write</pre>
 602 <p>
 603 Determines if and how the password information should be saved.
 604 </p>
 605 <p>Default value: G_PASSWORD_SAVE_NEVER</p>
 606 </div>
 607 <hr>
 608 <div class="refsect2">
 609 <a name="GMountOperation--username"></a><h3>The <code class="literal">"username"</code> property</h3>
 610 <pre class="programlisting">  "username"                 <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 611 <p>
 612 The user name that is used for authentication when carrying out
 613 the mount operation.
 614 </p>
 615 <p>Default value: NULL</p>
 616 </div>
 617 </div>
 618 <div class="refsect1">
 619 <a name="GMountOperation.signal-details"></a><h2>Signal Details</h2>
 620 <div class="refsect2">
 621 <a name="GMountOperation-aborted"></a><h3>The <code class="literal">"aborted"</code> signal</h3>
 622 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *arg0,
 623                                                         <a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 624 <p>
 625 Emitted by the backend when e.g. a device becomes unavailable
 626 while a mount operation is in progress.
 627 </p>
 628 <p>
 629 Implementations of GMountOperation should handle this signal
 630 by dismissing open password dialogs.
 631 </p>
 632 <div class="variablelist"><table border="0">
 633 <col align="left" valign="top">
 634 <tbody><tr>
 635 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 636 <td>user data set when the signal handler was connected.</td>
 637 </tr></tbody>
 638 </table></div>
 639 <p class="since">Since 2.20</p>
 640 </div>
 641 <hr>
 642 <div class="refsect2">
 643 <a name="GMountOperation-ask-password"></a><h3>The <code class="literal">"ask-password"</code> signal</h3>
 644 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>  *op,
 645                                                         <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>            *message,
 646                                                         <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>            *default_user,
 647                                                         <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>            *default_domain,
 648                                                         <a class="link" href="GMountOperation.html#GAskPasswordFlags" title="enum GAskPasswordFlags"><span class="type">GAskPasswordFlags</span></a> flags,
 649                                                         <a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)           : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 650 <p>
 651 Emitted when a mount operation asks the user for a password.
 652 </p>
 653 <p>
 654 If the message contains a line break, the first line should be
 655 presented as a heading. For example, it may be used as the
 656 primary text in a <a href="http://developer.gnome.org/devel/gtk/GtkMessageDialog.html"><span class="type">GtkMessageDialog</span></a>.
 657 </p>
 658 <div class="variablelist"><table border="0">
 659 <col align="left" valign="top">
 660 <tbody>
 661 <tr>
 662 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 663 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> requesting a password.</td>
 664 </tr>
 665 <tr>
 666 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
 667 <td>string containing a message to display to the user.</td>
 668 </tr>
 669 <tr>
 670 <td><p><span class="term"><em class="parameter"><code>default_user</code></em> :</span></p></td>
 671 <td>string containing the default user name.</td>
 672 </tr>
 673 <tr>
 674 <td><p><span class="term"><em class="parameter"><code>default_domain</code></em> :</span></p></td>
 675 <td>string containing the default domain.</td>
 676 </tr>
 677 <tr>
 678 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 679 <td>a set of <a class="link" href="GMountOperation.html#GAskPasswordFlags" title="enum GAskPasswordFlags"><span class="type">GAskPasswordFlags</span></a>.</td>
 680 </tr>
 681 <tr>
 682 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 683 <td>user data set when the signal handler was connected.</td>
 684 </tr>
 685 </tbody>
 686 </table></div>
 687 </div>
 688 <hr>
 689 <div class="refsect2">
 690 <a name="GMountOperation-ask-question"></a><h3>The <code class="literal">"ask-question"</code> signal</h3>
 691 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op,
 692                                                         <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>           *message,
 693                                                         <a href="./../gobject/gobject/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a>            choices,
 694                                                         <a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 695 <p>
 696 Emitted when asking the user a question and gives a list of
 697 choices for the user to choose from.
 698 </p>
 699 <p>
 700 If the message contains a line break, the first line should be
 701 presented as a heading. For example, it may be used as the
 702 primary text in a <a href="http://developer.gnome.org/devel/gtk/GtkMessageDialog.html"><span class="type">GtkMessageDialog</span></a>.
 703 </p>
 704 <div class="variablelist"><table border="0">
 705 <col align="left" valign="top">
 706 <tbody>
 707 <tr>
 708 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 709 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> asking a question.</td>
 710 </tr>
 711 <tr>
 712 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
 713 <td>string containing a message to display to the user.</td>
 714 </tr>
 715 <tr>
 716 <td><p><span class="term"><em class="parameter"><code>choices</code></em> :</span></p></td>
 717 <td>an array of strings for each possible choice.</td>
 718 </tr>
 719 <tr>
 720 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 721 <td>user data set when the signal handler was connected.</td>
 722 </tr>
 723 </tbody>
 724 </table></div>
 725 </div>
 726 <hr>
 727 <div class="refsect2">
 728 <a name="GMountOperation-reply"></a><h3>The <code class="literal">"reply"</code> signal</h3>
 729 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>      *op,
 730                                                         <a class="link" href="GMountOperation.html#GMountOperationResult" title="enum GMountOperationResult"><span class="type">GMountOperationResult</span></a> result,
 731                                                         <a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              user_data)      : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 732 <p>
 733 Emitted when the user has replied to the mount operation.
 734 </p>
 735 <div class="variablelist"><table border="0">
 736 <col align="left" valign="top">
 737 <tbody>
 738 <tr>
 739 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 740 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 741 </tr>
 742 <tr>
 743 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
 744 <td>a <a class="link" href="GMountOperation.html#GMountOperationResult" title="enum GMountOperationResult"><span class="type">GMountOperationResult</span></a> indicating how the request was handled</td>
 745 </tr>
 746 <tr>
 747 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 748 <td>user data set when the signal handler was connected.</td>
 749 </tr>
 750 </tbody>
 751 </table></div>
 752 </div>
 753 <hr>
 754 <div class="refsect2">
 755 <a name="GMountOperation-show-processes"></a><h3>The <code class="literal">"show-processes"</code> signal</h3>
 756 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> *op,
 757                                                         <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>           *message,
 758                                                         <a href="./../glib/glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a>          *processes,
 759                                                         <a href="./../gobject/gobject/gobject-Boxed-Types.html#GStrv"><span class="type">GStrv</span></a>            choices,
 760                                                         <a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="./../gobject/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 761 <p>
 762 Emitted when one or more processes are blocking an operation
 763 e.g. unmounting/ejecting a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> or stopping a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.
 764 </p>
 765 <p>
 766 Note that this signal may be emitted several times to update the
 767 list of blocking processes as processes close files. The
 768 application should only respond with <a class="link" href="GMountOperation.html#g-mount-operation-reply" title="g_mount_operation_reply ()"><code class="function">g_mount_operation_reply()</code></a> to
 769 the latest signal (setting <a class="link" href="GMountOperation.html#GMountOperation--choice" title='The "choice" property'><span class="type">"choice"</span></a> to the choice
 770 the user made).
 771 </p>
 772 <p>
 773 If the message contains a line break, the first line should be
 774 presented as a heading. For example, it may be used as the
 775 primary text in a <a href="http://developer.gnome.org/devel/gtk/GtkMessageDialog.html"><span class="type">GtkMessageDialog</span></a>.
 776 </p>
 777 <div class="variablelist"><table border="0">
 778 <col align="left" valign="top">
 779 <tbody>
 780 <tr>
 781 <td><p><span class="term"><em class="parameter"><code>op</code></em> :</span></p></td>
 782 <td>a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>.</td>
 783 </tr>
 784 <tr>
 785 <td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
 786 <td>string containing a message to display to the user.</td>
 787 </tr>
 788 <tr>
 789 <td><p><span class="term"><em class="parameter"><code>processes</code></em> :</span></p></td>
 790 <td>an array of <a href="./../glib/glib/glib-The-Main-Event-Loop.html#GPid"><span class="type">GPid</span></a> for processes
 791 blocking the operation. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GPid]</span>
 792 </td>
 793 </tr>
 794 <tr>
 795 <td><p><span class="term"><em class="parameter"><code>choices</code></em> :</span></p></td>
 796 <td>an array of strings for each possible choice.</td>
 797 </tr>
 798 <tr>
 799 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 800 <td>user data set when the signal handler was connected.</td>
 801 </tr>
 802 </tbody>
 803 </table></div>
 804 <p class="since">Since 2.22</p>
 805 </div>
 806 </div>
 807 </div>
 808 <div class="footer">
 809 <hr>
 810           Generated by GTK-Doc V1.18</div>
 811 </body>
 812 </html>