← Back to branch summary

~ubuntu-branches/debian/squeeze/glib2.0/squeeze

« back to all changes in this revision

Viewing changes to docs/reference/gio/xml/gmountoperation.xml

  • Committer: Bazaar Package Importer
  • Author(s): Gustavo Noronha Silva
  • Date: 2009-02-15 13:00:43 UTC
  • mfrom: (1.3.1 upstream) (69.1.10 intrepid)
  • Revision ID: james.westby@ubuntu.com-20090215130043-q47fbt3owmt42m2f
Tags: 2.18.4-2
* Release to unstable
* debian/rules:
- bump SHVER, since we are already forcing a 2.18.0 dependecy on the
  symbols introduced in the development versions
* debian/control.in:
- added Homepage and Vcs-* control fields

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gio/xml/gmountoperation.xml
5
5
]>
6
6
<refentry id="GMountOperation">
7
7
<refmeta>
8
 
<refentrytitle role="top_of_page">GMountOperation</refentrytitle>
 
8
<refentrytitle role="top_of_page" id="GMountOperation.top_of_page">GMountOperation</refentrytitle>
9
9
<manvolnum>3</manvolnum>
10
10
<refmiscinfo>GIO Library</refmiscinfo>
11
11
</refmeta>
13
13
<refnamediv>
14
14
<refname>GMountOperation</refname>
15
15
<refpurpose>Authentication methods for mountable locations</refpurpose>
16
 
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
17
16
</refnamediv>
18
17
 
19
 
<refsynopsisdiv role="synopsis">
 
18
<refsynopsisdiv id="GMountOperation.synopsis" role="synopsis">
20
19
<title role="synopsis.title">Synopsis</title>
21
20
 
22
21
<synopsis>
23
22
 
24
23
#include &lt;gio/gio.h&gt;
25
24
 
26
 
 
27
25
enum                <link linkend="GAskPasswordFlags">GAskPasswordFlags</link>;
28
26
enum                <link linkend="GPasswordSave">GPasswordSave</link>;
29
27
                    <link linkend="GMountOperation-struct">GMountOperation</link>;
30
28
enum                <link linkend="GMountOperationResult">GMountOperationResult</link>;
31
 
<link linkend="GMountOperation">GMountOperation</link>*    <link linkend="g-mount-operation-new">g_mount_operation_new</link>               (void);
32
 
const <link linkend="char">char</link>*         <link linkend="g-mount-operation-get-username">g_mount_operation_get_username</link>      (<link linkend="GMountOperation">GMountOperation</link> *op);
 
29
<link linkend="GMountOperation">GMountOperation</link> *   <link linkend="g-mount-operation-new">g_mount_operation_new</link>               (void);
 
30
const <link linkend="char">char</link> *        <link linkend="g-mount-operation-get-username">g_mount_operation_get_username</link>      (<link linkend="GMountOperation">GMountOperation</link> *op);
33
31
<link linkend="void">void</link>                <link linkend="g-mount-operation-set-username">g_mount_operation_set_username</link>      (<link linkend="GMountOperation">GMountOperation</link> *op,
34
32
                                                         const <link linkend="char">char</link> *username);
35
 
const <link linkend="char">char</link>*         <link linkend="g-mount-operation-get-password">g_mount_operation_get_password</link>      (<link linkend="GMountOperation">GMountOperation</link> *op);
 
33
const <link linkend="char">char</link> *        <link linkend="g-mount-operation-get-password">g_mount_operation_get_password</link>      (<link linkend="GMountOperation">GMountOperation</link> *op);
36
34
<link linkend="void">void</link>                <link linkend="g-mount-operation-set-password">g_mount_operation_set_password</link>      (<link linkend="GMountOperation">GMountOperation</link> *op,
37
35
                                                         const <link linkend="char">char</link> *password);
38
36
<link linkend="gboolean">gboolean</link>            <link linkend="g-mount-operation-get-anonymous">g_mount_operation_get_anonymous</link>     (<link linkend="GMountOperation">GMountOperation</link> *op);
39
37
<link linkend="void">void</link>                <link linkend="g-mount-operation-set-anonymous">g_mount_operation_set_anonymous</link>     (<link linkend="GMountOperation">GMountOperation</link> *op,
40
38
                                                         <link linkend="gboolean">gboolean</link> anonymous);
41
 
const <link linkend="char">char</link>*         <link linkend="g-mount-operation-get-domain">g_mount_operation_get_domain</link>        (<link linkend="GMountOperation">GMountOperation</link> *op);
 
39
const <link linkend="char">char</link> *        <link linkend="g-mount-operation-get-domain">g_mount_operation_get_domain</link>        (<link linkend="GMountOperation">GMountOperation</link> *op);
42
40
<link linkend="void">void</link>                <link linkend="g-mount-operation-set-domain">g_mount_operation_set_domain</link>        (<link linkend="GMountOperation">GMountOperation</link> *op,
43
41
                                                         const <link linkend="char">char</link> *domain);
44
42
<link linkend="GPasswordSave">GPasswordSave</link>       <link linkend="g-mount-operation-get-password-save">g_mount_operation_get_password_save</link> (<link linkend="GMountOperation">GMountOperation</link> *op);
49
47
                                                         <link linkend="int">int</link> choice);
50
48
<link linkend="void">void</link>                <link linkend="g-mount-operation-reply">g_mount_operation_reply</link>             (<link linkend="GMountOperation">GMountOperation</link> *op,
51
49
                                                         <link linkend="GMountOperationResult">GMountOperationResult</link> result);
52
 
 
53
 
 
54
50
</synopsis>
55
51
</refsynopsisdiv>
56
52
 
57
 
<refsect1 role="object_hierarchy">
 
53
<refsect1 id="GMountOperation.object-hierarchy" role="object_hierarchy">
58
54
<title role="object_hierarchy.title">Object Hierarchy</title>
59
55
<synopsis>
60
 
 
61
56
  <link linkend="GObject">GObject</link>
62
57
   +----GMountOperation
63
58
</synopsis>
64
 
 
65
59
</refsect1>
66
60
 
67
61
 
68
62
 
69
63
 
70
64
 
71
 
<refsect1 role="properties">
 
65
<refsect1 id="GMountOperation.properties" role="properties">
72
66
<title role="properties.title">Properties</title>
73
67
<synopsis>
74
 
 
75
68
  &quot;<link linkend="GMountOperation--anonymous">anonymous</link>&quot;                <link linkend="gboolean">gboolean</link>              : Read / Write
76
69
  &quot;<link linkend="GMountOperation--choice">choice</link>&quot;                   <link linkend="gint">gint</link>                  : Read / Write
77
 
  &quot;<link linkend="GMountOperation--domain">domain</link>&quot;                   <link linkend="gchararray">gchararray</link>            : Read / Write
78
 
  &quot;<link linkend="GMountOperation--password">password</link>&quot;                 <link linkend="gchararray">gchararray</link>            : Read / Write
 
70
  &quot;<link linkend="GMountOperation--domain">domain</link>&quot;                   <link linkend="gchar">gchar</link>*                : Read / Write
 
71
  &quot;<link linkend="GMountOperation--password">password</link>&quot;                 <link linkend="gchar">gchar</link>*                : Read / Write
79
72
  &quot;<link linkend="GMountOperation--password-save">password-save</link>&quot;            <link linkend="GPasswordSave">GPasswordSave</link>         : Read / Write
80
 
  &quot;<link linkend="GMountOperation--username">username</link>&quot;                 <link linkend="gchararray">gchararray</link>            : Read / Write
 
73
  &quot;<link linkend="GMountOperation--username">username</link>&quot;                 <link linkend="gchar">gchar</link>*                : Read / Write
81
74
</synopsis>
82
75
</refsect1>
83
76
 
84
 
<refsect1 role="signal_proto">
 
77
<refsect1 id="GMountOperation.signals" role="signal_proto">
85
78
<title role="signal_proto.title">Signals</title>
86
79
<synopsis>
87
 
 
88
80
  &quot;<link linkend="GMountOperation-ask-password">ask-password</link>&quot;                                   : Run Last
89
81
  &quot;<link linkend="GMountOperation-ask-question">ask-question</link>&quot;                                   : Run Last
90
82
  &quot;<link linkend="GMountOperation-reply">reply</link>&quot;                                          : Run Last
92
84
</refsect1>
93
85
 
94
86
 
95
 
<refsect1 role="desc">
 
87
<refsect1 id="GMountOperation.description" role="desc">
96
88
<title role="desc.title">Description</title>
97
89
<para>
98
90
<link linkend="GMountOperation"><type>GMountOperation</type></link> provides a mechanism for authenticating mountable 
108
100
</para>
109
101
<para>
110
102
Users should instantiate a subclass of this that implements all
111
 
the various callbacks to show the required dialogs.</para>
 
103
the various callbacks to show the required dialogs, such as 
 
104
<link linkend="GtkMountOperation"><type>GtkMountOperation</type></link>.</para>
112
105
<para>
113
 
 
114
106
</para>
115
107
</refsect1>
116
108
 
117
 
<refsect1 role="details">
 
109
<refsect1 id="GMountOperation.details" role="details">
118
110
<title role="details.title">Details</title>
119
 
<refsect2>
120
 
<title><anchor id="GAskPasswordFlags" role="enum"/>enum GAskPasswordFlags</title>
121
 
<indexterm><primary>GAskPasswordFlags</primary></indexterm><programlisting>typedef enum {
122
 
  G_ASK_PASSWORD_NEED_PASSWORD       = 1&lt;&lt;0,
123
 
  G_ASK_PASSWORD_NEED_USERNAME       = 1&lt;&lt;1,
124
 
  G_ASK_PASSWORD_NEED_DOMAIN         = 1&lt;&lt;2,
125
 
  G_ASK_PASSWORD_SAVING_SUPPORTED    = 1&lt;&lt;3,
126
 
  G_ASK_PASSWORD_ANONYMOUS_SUPPORTED = 1&lt;&lt;4
 
111
<refsect2 id="GAskPasswordFlags" role="enum">
 
112
<title>enum GAskPasswordFlags</title>
 
113
<indexterm zone="GAskPasswordFlags"><primary sortas="GAskPasswordFlags">GAskPasswordFlags</primary></indexterm><programlisting>typedef enum {
 
114
  G_ASK_PASSWORD_NEED_PASSWORD       = (1 &lt;&lt; 0),
 
115
  G_ASK_PASSWORD_NEED_USERNAME       = (1 &lt;&lt; 1),
 
116
  G_ASK_PASSWORD_NEED_DOMAIN         = (1 &lt;&lt; 2),
 
117
  G_ASK_PASSWORD_SAVING_SUPPORTED    = (1 &lt;&lt; 3),
 
118
  G_ASK_PASSWORD_ANONYMOUS_SUPPORTED = (1 &lt;&lt; 4)
127
119
} GAskPasswordFlags;
128
120
</programlisting>
129
121
<para>
130
 
<link linkend="GAskPasswordFlags"><type>GAskPasswordFlags</type></link> are used to request specific information from the 
 
122
<link linkend="GAskPasswordFlags"><type>GAskPasswordFlags</type></link> are used to request specific information from the
131
123
user, or to notify the user of their choices in an authentication
132
124
situation.</para>
133
125
<para>
134
 
 
135
126
</para><variablelist role="enum">
136
 
<varlistentry>
137
 
<term><anchor id="G-ASK-PASSWORD-NEED-PASSWORD:CAPS" role="constant"/><literal>G_ASK_PASSWORD_NEED_PASSWORD</literal></term>
 
127
<varlistentry id="G-ASK-PASSWORD-NEED-PASSWORD--CAPS" role="constant">
 
128
<term><literal>G_ASK_PASSWORD_NEED_PASSWORD</literal></term>
138
129
<listitem><simpara> operation requires a password.
139
130
</simpara></listitem>
140
131
</varlistentry>
141
 
<varlistentry>
142
 
<term><anchor id="G-ASK-PASSWORD-NEED-USERNAME:CAPS" role="constant"/><literal>G_ASK_PASSWORD_NEED_USERNAME</literal></term>
 
132
<varlistentry id="G-ASK-PASSWORD-NEED-USERNAME--CAPS" role="constant">
 
133
<term><literal>G_ASK_PASSWORD_NEED_USERNAME</literal></term>
143
134
<listitem><simpara> operation requires a username.
144
135
</simpara></listitem>
145
136
</varlistentry>
146
 
<varlistentry>
147
 
<term><anchor id="G-ASK-PASSWORD-NEED-DOMAIN:CAPS" role="constant"/><literal>G_ASK_PASSWORD_NEED_DOMAIN</literal></term>
 
137
<varlistentry id="G-ASK-PASSWORD-NEED-DOMAIN--CAPS" role="constant">
 
138
<term><literal>G_ASK_PASSWORD_NEED_DOMAIN</literal></term>
148
139
<listitem><simpara> operation requires a domain.
149
140
</simpara></listitem>
150
141
</varlistentry>
151
 
<varlistentry>
152
 
<term><anchor id="G-ASK-PASSWORD-SAVING-SUPPORTED:CAPS" role="constant"/><literal>G_ASK_PASSWORD_SAVING_SUPPORTED</literal></term>
 
142
<varlistentry id="G-ASK-PASSWORD-SAVING-SUPPORTED--CAPS" role="constant">
 
143
<term><literal>G_ASK_PASSWORD_SAVING_SUPPORTED</literal></term>
153
144
<listitem><simpara> operation supports saving settings.
154
145
</simpara></listitem>
155
146
</varlistentry>
156
 
<varlistentry>
157
 
<term><anchor id="G-ASK-PASSWORD-ANONYMOUS-SUPPORTED:CAPS" role="constant"/><literal>G_ASK_PASSWORD_ANONYMOUS_SUPPORTED</literal></term>
 
147
<varlistentry id="G-ASK-PASSWORD-ANONYMOUS-SUPPORTED--CAPS" role="constant">
 
148
<term><literal>G_ASK_PASSWORD_ANONYMOUS_SUPPORTED</literal></term>
158
149
<listitem><simpara> operation supports anonymous users.
159
150
</simpara></listitem>
160
151
</varlistentry>
161
152
</variablelist></refsect2>
162
 
<refsect2>
163
 
<title><anchor id="GPasswordSave" role="enum"/>enum GPasswordSave</title>
164
 
<indexterm><primary>GPasswordSave</primary></indexterm><programlisting>typedef enum {
 
153
<refsect2 id="GPasswordSave" role="enum">
 
154
<title>enum GPasswordSave</title>
 
155
<indexterm zone="GPasswordSave"><primary sortas="GPasswordSave">GPasswordSave</primary></indexterm><programlisting>typedef enum {
165
156
  G_PASSWORD_SAVE_NEVER,
166
157
  G_PASSWORD_SAVE_FOR_SESSION,
167
158
  G_PASSWORD_SAVE_PERMANENTLY
168
159
} GPasswordSave;
169
160
</programlisting>
170
161
<para>
171
 
<link linkend="GPasswordSave"><type>GPasswordSave</type></link> is used to indicate the lifespan of a saved password.</para>
172
 
<para>
173
 
 
 
162
<link linkend="GPasswordSave"><type>GPasswordSave</type></link> is used to indicate the lifespan of a saved password.
 
163
</para>
 
164
<para>
 
165
<link linkend="Gvfs"><type>Gvfs</type></link> stores passwords in the Gnome keyring when this flag allows it
 
166
to, and later retrieves it again from there.</para>
 
167
<para>
174
168
</para><variablelist role="enum">
175
 
<varlistentry>
176
 
<term><anchor id="G-PASSWORD-SAVE-NEVER:CAPS" role="constant"/><literal>G_PASSWORD_SAVE_NEVER</literal></term>
 
169
<varlistentry id="G-PASSWORD-SAVE-NEVER--CAPS" role="constant">
 
170
<term><literal>G_PASSWORD_SAVE_NEVER</literal></term>
177
171
<listitem><simpara> never save a password.
178
172
</simpara></listitem>
179
173
</varlistentry>
180
 
<varlistentry>
181
 
<term><anchor id="G-PASSWORD-SAVE-FOR-SESSION:CAPS" role="constant"/><literal>G_PASSWORD_SAVE_FOR_SESSION</literal></term>
 
174
<varlistentry id="G-PASSWORD-SAVE-FOR-SESSION--CAPS" role="constant">
 
175
<term><literal>G_PASSWORD_SAVE_FOR_SESSION</literal></term>
182
176
<listitem><simpara> save a password for the session.
183
177
</simpara></listitem>
184
178
</varlistentry>
185
 
<varlistentry>
186
 
<term><anchor id="G-PASSWORD-SAVE-PERMANENTLY:CAPS" role="constant"/><literal>G_PASSWORD_SAVE_PERMANENTLY</literal></term>
 
179
<varlistentry id="G-PASSWORD-SAVE-PERMANENTLY--CAPS" role="constant">
 
180
<term><literal>G_PASSWORD_SAVE_PERMANENTLY</literal></term>
187
181
<listitem><simpara> save a password permanently.
188
182
</simpara></listitem>
189
183
</varlistentry>
190
184
</variablelist></refsect2>
191
 
<refsect2>
192
 
<title><anchor id="GMountOperation-struct" role="struct"/>GMountOperation</title>
193
 
<indexterm><primary>GMountOperation</primary></indexterm><programlisting>typedef struct _GMountOperation GMountOperation;</programlisting>
 
185
<refsect2 id="GMountOperation-struct" role="struct">
 
186
<title>GMountOperation</title>
 
187
<indexterm zone="GMountOperation-struct"><primary sortas="GMountOperation">GMountOperation</primary></indexterm><programlisting>typedef struct _GMountOperation GMountOperation;</programlisting>
194
188
<para>
195
 
Class for providing authentication methods for mounting operations, 
 
189
Class for providing authentication methods for mounting operations,
196
190
such as mounting a file locally, or authenticating with a server.</para>
197
191
<para>
198
 
 
199
192
</para></refsect2>
200
 
<refsect2>
201
 
<title><anchor id="GMountOperationResult" role="enum"/>enum GMountOperationResult</title>
202
 
<indexterm><primary>GMountOperationResult</primary></indexterm><programlisting>typedef enum {
 
193
<refsect2 id="GMountOperationResult" role="enum">
 
194
<title>enum GMountOperationResult</title>
 
195
<indexterm zone="GMountOperationResult"><primary sortas="GMountOperationResult">GMountOperationResult</primary></indexterm><programlisting>typedef enum {
203
196
  G_MOUNT_OPERATION_HANDLED,
204
197
  G_MOUNT_OPERATION_ABORTED,
205
198
  G_MOUNT_OPERATION_UNHANDLED
206
199
} GMountOperationResult;
207
200
</programlisting>
208
201
<para>
209
 
<link linkend="GMountOperationResult"><type>GMountOperationResult</type></link> is returned as a result when a request for information
210
 
is send by the mounting operation.</para>
 
202
<link linkend="GMountOperationResult"><type>GMountOperationResult</type></link> is returned as a result when a request for
 
203
information is send by the mounting operation.</para>
211
204
<para>
212
 
 
213
205
</para><variablelist role="enum">
214
 
<varlistentry>
215
 
<term><anchor id="G-MOUNT-OPERATION-HANDLED:CAPS" role="constant"/><literal>G_MOUNT_OPERATION_HANDLED</literal></term>
216
 
<listitem><simpara> The request was fulfilled and the user specified data is now availible
217
 
</simpara></listitem>
218
 
</varlistentry>
219
 
<varlistentry>
220
 
<term><anchor id="G-MOUNT-OPERATION-ABORTED:CAPS" role="constant"/><literal>G_MOUNT_OPERATION_ABORTED</literal></term>
221
 
<listitem><simpara> The user requested the mount operation to be aborted
222
 
</simpara></listitem>
223
 
</varlistentry>
224
 
<varlistentry>
225
 
<term><anchor id="G-MOUNT-OPERATION-UNHANDLED:CAPS" role="constant"/><literal>G_MOUNT_OPERATION_UNHANDLED</literal></term>
226
 
<listitem><simpara> The request was unhandled (i.e. not implemented)
 
206
<varlistentry id="G-MOUNT-OPERATION-HANDLED--CAPS" role="constant">
 
207
<term><literal>G_MOUNT_OPERATION_HANDLED</literal></term>
 
208
<listitem><simpara> The request was fulfilled and the
 
209
    user specified data is now available
 
210
</simpara></listitem>
 
211
</varlistentry>
 
212
<varlistentry id="G-MOUNT-OPERATION-ABORTED--CAPS" role="constant">
 
213
<term><literal>G_MOUNT_OPERATION_ABORTED</literal></term>
 
214
<listitem><simpara> The user requested the mount operation
 
215
    to be aborted
 
216
</simpara></listitem>
 
217
</varlistentry>
 
218
<varlistentry id="G-MOUNT-OPERATION-UNHANDLED--CAPS" role="constant">
 
219
<term><literal>G_MOUNT_OPERATION_UNHANDLED</literal></term>
 
220
<listitem><simpara> The request was unhandled (i.e. not
 
221
    implemented)
227
222
</simpara></listitem>
228
223
</varlistentry>
229
224
</variablelist></refsect2>
230
 
<refsect2>
231
 
<title><anchor id="g-mount-operation-new" role="function"/>g_mount_operation_new ()</title>
232
 
<indexterm><primary>g_mount_operation_new</primary></indexterm><programlisting><link linkend="GMountOperation">GMountOperation</link>*    g_mount_operation_new               (void);</programlisting>
 
225
<refsect2 id="g-mount-operation-new" role="function">
 
226
<title>g_mount_operation_new ()</title>
 
227
<indexterm zone="g-mount-operation-new"><primary sortas="g_mount_operation_new">g_mount_operation_new</primary></indexterm><programlisting><link linkend="GMountOperation">GMountOperation</link> *   g_mount_operation_new               (void);</programlisting>
233
228
<para>
234
229
Creates a new mount operation.</para>
235
230
<para>
236
 
 
237
231
</para><variablelist role="params">
238
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
 
232
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
239
233
</simpara></listitem></varlistentry>
240
234
</variablelist></refsect2>
241
 
<refsect2>
242
 
<title><anchor id="g-mount-operation-get-username" role="function"/>g_mount_operation_get_username ()</title>
243
 
<indexterm><primary>g_mount_operation_get_username</primary></indexterm><programlisting>const <link linkend="char">char</link>*         g_mount_operation_get_username      (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
 
235
<refsect2 id="g-mount-operation-get-username" role="function">
 
236
<title>g_mount_operation_get_username ()</title>
 
237
<indexterm zone="g-mount-operation-get-username"><primary sortas="g_mount_operation_get_username">g_mount_operation_get_username</primary></indexterm><programlisting>const <link linkend="char">char</link> *        g_mount_operation_get_username      (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
244
238
<para>
245
239
Get the user name from the mount operation.</para>
246
240
<para>
247
 
 
248
241
</para><variablelist role="params">
249
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
242
<varlistentry><term><parameter>op</parameter>&#160;:</term>
250
243
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
251
244
</simpara></listitem></varlistentry>
252
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a string containing the user name.
 
245
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a string containing the user name.
253
246
</simpara></listitem></varlistentry>
254
247
</variablelist></refsect2>
255
 
<refsect2>
256
 
<title><anchor id="g-mount-operation-set-username" role="function"/>g_mount_operation_set_username ()</title>
257
 
<indexterm><primary>g_mount_operation_set_username</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_username      (<link linkend="GMountOperation">GMountOperation</link> *op,
 
248
<refsect2 id="g-mount-operation-set-username" role="function">
 
249
<title>g_mount_operation_set_username ()</title>
 
250
<indexterm zone="g-mount-operation-set-username"><primary sortas="g_mount_operation_set_username">g_mount_operation_set_username</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_username      (<link linkend="GMountOperation">GMountOperation</link> *op,
258
251
                                                         const <link linkend="char">char</link> *username);</programlisting>
259
252
<para>
260
253
Sets the user name within <parameter>op</parameter> to <parameter>username</parameter>.</para>
261
254
<para>
262
 
 
263
255
</para><variablelist role="params">
264
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
256
<varlistentry><term><parameter>op</parameter>&#160;:</term>
265
257
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
266
258
</simpara></listitem></varlistentry>
267
 
<varlistentry><term><parameter>username</parameter>&nbsp;:</term>
 
259
<varlistentry><term><parameter>username</parameter>&#160;:</term>
268
260
<listitem><simpara> input username.
269
261
</simpara></listitem></varlistentry>
270
262
</variablelist></refsect2>
271
 
<refsect2>
272
 
<title><anchor id="g-mount-operation-get-password" role="function"/>g_mount_operation_get_password ()</title>
273
 
<indexterm><primary>g_mount_operation_get_password</primary></indexterm><programlisting>const <link linkend="char">char</link>*         g_mount_operation_get_password      (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
 
263
<refsect2 id="g-mount-operation-get-password" role="function">
 
264
<title>g_mount_operation_get_password ()</title>
 
265
<indexterm zone="g-mount-operation-get-password"><primary sortas="g_mount_operation_get_password">g_mount_operation_get_password</primary></indexterm><programlisting>const <link linkend="char">char</link> *        g_mount_operation_get_password      (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
274
266
<para>
275
267
Gets a password from the mount operation.</para>
276
268
<para>
277
 
 
278
269
</para><variablelist role="params">
279
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
270
<varlistentry><term><parameter>op</parameter>&#160;:</term>
280
271
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
281
272
</simpara></listitem></varlistentry>
282
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a string containing the password within <parameter>op</parameter>.
 
273
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a string containing the password within <parameter>op</parameter>.
283
274
</simpara></listitem></varlistentry>
284
275
</variablelist></refsect2>
285
 
<refsect2>
286
 
<title><anchor id="g-mount-operation-set-password" role="function"/>g_mount_operation_set_password ()</title>
287
 
<indexterm><primary>g_mount_operation_set_password</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_password      (<link linkend="GMountOperation">GMountOperation</link> *op,
 
276
<refsect2 id="g-mount-operation-set-password" role="function">
 
277
<title>g_mount_operation_set_password ()</title>
 
278
<indexterm zone="g-mount-operation-set-password"><primary sortas="g_mount_operation_set_password">g_mount_operation_set_password</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_password      (<link linkend="GMountOperation">GMountOperation</link> *op,
288
279
                                                         const <link linkend="char">char</link> *password);</programlisting>
289
280
<para>
290
281
Sets the mount operation's password to <parameter>password</parameter>.</para>
291
282
<para>
292
 
 
293
283
</para><variablelist role="params">
294
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
284
<varlistentry><term><parameter>op</parameter>&#160;:</term>
295
285
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
296
286
</simpara></listitem></varlistentry>
297
 
<varlistentry><term><parameter>password</parameter>&nbsp;:</term>
 
287
<varlistentry><term><parameter>password</parameter>&#160;:</term>
298
288
<listitem><simpara> password to set.
299
289
</simpara></listitem></varlistentry>
300
290
</variablelist></refsect2>
301
 
<refsect2>
302
 
<title><anchor id="g-mount-operation-get-anonymous" role="function"/>g_mount_operation_get_anonymous ()</title>
303
 
<indexterm><primary>g_mount_operation_get_anonymous</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_mount_operation_get_anonymous     (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
 
291
<refsect2 id="g-mount-operation-get-anonymous" role="function">
 
292
<title>g_mount_operation_get_anonymous ()</title>
 
293
<indexterm zone="g-mount-operation-get-anonymous"><primary sortas="g_mount_operation_get_anonymous">g_mount_operation_get_anonymous</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_mount_operation_get_anonymous     (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
304
294
<para>
305
295
Check to see whether the mount operation is being used 
306
296
for an anonymous user.</para>
307
297
<para>
308
 
 
309
298
</para><variablelist role="params">
310
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
299
<varlistentry><term><parameter>op</parameter>&#160;:</term>
311
300
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
312
301
</simpara></listitem></varlistentry>
313
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if mount operation is anonymous. 
 
302
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if mount operation is anonymous. 
314
303
</simpara></listitem></varlistentry>
315
304
</variablelist></refsect2>
316
 
<refsect2>
317
 
<title><anchor id="g-mount-operation-set-anonymous" role="function"/>g_mount_operation_set_anonymous ()</title>
318
 
<indexterm><primary>g_mount_operation_set_anonymous</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_anonymous     (<link linkend="GMountOperation">GMountOperation</link> *op,
 
305
<refsect2 id="g-mount-operation-set-anonymous" role="function">
 
306
<title>g_mount_operation_set_anonymous ()</title>
 
307
<indexterm zone="g-mount-operation-set-anonymous"><primary sortas="g_mount_operation_set_anonymous">g_mount_operation_set_anonymous</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_anonymous     (<link linkend="GMountOperation">GMountOperation</link> *op,
319
308
                                                         <link linkend="gboolean">gboolean</link> anonymous);</programlisting>
320
309
<para>
321
 
Sets the mount operation to use an anonymous user if <parameter>anonymous</parameter> is <link linkend="TRUE:CAPS"><literal>TRUE</literal></link>.</para>
 
310
Sets the mount operation to use an anonymous user if <parameter>anonymous</parameter> is <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>.</para>
322
311
<para>
323
 
 
324
312
</para><variablelist role="params">
325
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
313
<varlistentry><term><parameter>op</parameter>&#160;:</term>
326
314
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
327
315
</simpara></listitem></varlistentry>
328
 
<varlistentry><term><parameter>anonymous</parameter>&nbsp;:</term>
 
316
<varlistentry><term><parameter>anonymous</parameter>&#160;:</term>
329
317
<listitem><simpara> boolean value.
330
318
</simpara></listitem></varlistentry>
331
319
</variablelist></refsect2>
332
 
<refsect2>
333
 
<title><anchor id="g-mount-operation-get-domain" role="function"/>g_mount_operation_get_domain ()</title>
334
 
<indexterm><primary>g_mount_operation_get_domain</primary></indexterm><programlisting>const <link linkend="char">char</link>*         g_mount_operation_get_domain        (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
 
320
<refsect2 id="g-mount-operation-get-domain" role="function">
 
321
<title>g_mount_operation_get_domain ()</title>
 
322
<indexterm zone="g-mount-operation-get-domain"><primary sortas="g_mount_operation_get_domain">g_mount_operation_get_domain</primary></indexterm><programlisting>const <link linkend="char">char</link> *        g_mount_operation_get_domain        (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
335
323
<para>
336
324
Gets the domain of the mount operation.</para>
337
325
<para>
338
 
 
339
326
</para><variablelist role="params">
340
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
327
<varlistentry><term><parameter>op</parameter>&#160;:</term>
341
328
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
342
329
</simpara></listitem></varlistentry>
343
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a string set to the domain. 
 
330
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a string set to the domain. 
344
331
</simpara></listitem></varlistentry>
345
332
</variablelist></refsect2>
346
 
<refsect2>
347
 
<title><anchor id="g-mount-operation-set-domain" role="function"/>g_mount_operation_set_domain ()</title>
348
 
<indexterm><primary>g_mount_operation_set_domain</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_domain        (<link linkend="GMountOperation">GMountOperation</link> *op,
 
333
<refsect2 id="g-mount-operation-set-domain" role="function">
 
334
<title>g_mount_operation_set_domain ()</title>
 
335
<indexterm zone="g-mount-operation-set-domain"><primary sortas="g_mount_operation_set_domain">g_mount_operation_set_domain</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_domain        (<link linkend="GMountOperation">GMountOperation</link> *op,
349
336
                                                         const <link linkend="char">char</link> *domain);</programlisting>
350
337
<para>
351
338
Sets the mount operation's domain.</para>
352
339
<para>
353
 
 
354
340
</para><variablelist role="params">
355
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
341
<varlistentry><term><parameter>op</parameter>&#160;:</term>
356
342
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
357
343
</simpara></listitem></varlistentry>
358
 
<varlistentry><term><parameter>domain</parameter>&nbsp;:</term>
 
344
<varlistentry><term><parameter>domain</parameter>&#160;:</term>
359
345
<listitem><simpara> the domain to set.
360
346
</simpara></listitem></varlistentry>
361
347
</variablelist></refsect2>
362
 
<refsect2>
363
 
<title><anchor id="g-mount-operation-get-password-save" role="function"/>g_mount_operation_get_password_save ()</title>
364
 
<indexterm><primary>g_mount_operation_get_password_save</primary></indexterm><programlisting><link linkend="GPasswordSave">GPasswordSave</link>       g_mount_operation_get_password_save (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
 
348
<refsect2 id="g-mount-operation-get-password-save" role="function">
 
349
<title>g_mount_operation_get_password_save ()</title>
 
350
<indexterm zone="g-mount-operation-get-password-save"><primary sortas="g_mount_operation_get_password_save">g_mount_operation_get_password_save</primary></indexterm><programlisting><link linkend="GPasswordSave">GPasswordSave</link>       g_mount_operation_get_password_save (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
365
351
<para>
366
352
Gets the state of saving passwords for the mount operation.</para>
367
353
<para>
368
 
 
369
354
</para><variablelist role="params">
370
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
355
<varlistentry><term><parameter>op</parameter>&#160;:</term>
371
356
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
372
357
</simpara></listitem></varlistentry>
373
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a <link linkend="GPasswordSave"><type>GPasswordSave</type></link> flag. 
 
358
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="GPasswordSave"><type>GPasswordSave</type></link> flag. 
374
359
</simpara></listitem></varlistentry>
375
360
</variablelist></refsect2>
376
 
<refsect2>
377
 
<title><anchor id="g-mount-operation-set-password-save" role="function"/>g_mount_operation_set_password_save ()</title>
378
 
<indexterm><primary>g_mount_operation_set_password_save</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_password_save (<link linkend="GMountOperation">GMountOperation</link> *op,
 
361
<refsect2 id="g-mount-operation-set-password-save" role="function">
 
362
<title>g_mount_operation_set_password_save ()</title>
 
363
<indexterm zone="g-mount-operation-set-password-save"><primary sortas="g_mount_operation_set_password_save">g_mount_operation_set_password_save</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_password_save (<link linkend="GMountOperation">GMountOperation</link> *op,
379
364
                                                         <link linkend="GPasswordSave">GPasswordSave</link> save);</programlisting>
380
365
<para>
381
366
Sets the state of saving passwords for the mount operation.</para>
382
367
<para>
383
 
 
384
368
</para><variablelist role="params">
385
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
369
<varlistentry><term><parameter>op</parameter>&#160;:</term>
386
370
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
387
371
</simpara></listitem></varlistentry>
388
 
<varlistentry><term><parameter>save</parameter>&nbsp;:</term>
 
372
<varlistentry><term><parameter>save</parameter>&#160;:</term>
389
373
<listitem><simpara> a set of <link linkend="GPasswordSave"><type>GPasswordSave</type></link> flags.
390
374
</simpara></listitem></varlistentry>
391
375
</variablelist></refsect2>
392
 
<refsect2>
393
 
<title><anchor id="g-mount-operation-get-choice" role="function"/>g_mount_operation_get_choice ()</title>
394
 
<indexterm><primary>g_mount_operation_get_choice</primary></indexterm><programlisting><link linkend="int">int</link>                 g_mount_operation_get_choice        (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
 
376
<refsect2 id="g-mount-operation-get-choice" role="function">
 
377
<title>g_mount_operation_get_choice ()</title>
 
378
<indexterm zone="g-mount-operation-get-choice"><primary sortas="g_mount_operation_get_choice">g_mount_operation_get_choice</primary></indexterm><programlisting><link linkend="int">int</link>                 g_mount_operation_get_choice        (<link linkend="GMountOperation">GMountOperation</link> *op);</programlisting>
395
379
<para>
396
380
Gets a choice from the mount operation.</para>
397
381
<para>
398
 
 
399
382
</para><variablelist role="params">
400
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
383
<varlistentry><term><parameter>op</parameter>&#160;:</term>
401
384
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
402
385
</simpara></listitem></varlistentry>
403
 
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> an integer containing an index of the user's choice from 
404
 
the choice's list, or <link linkend="0:CAPS"><literal>0</literal></link>.
 
386
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> an integer containing an index of the user's choice from 
 
387
the choice's list, or <link linkend="0--CAPS"><literal>0</literal></link>.
405
388
</simpara></listitem></varlistentry>
406
389
</variablelist></refsect2>
407
 
<refsect2>
408
 
<title><anchor id="g-mount-operation-set-choice" role="function"/>g_mount_operation_set_choice ()</title>
409
 
<indexterm><primary>g_mount_operation_set_choice</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_choice        (<link linkend="GMountOperation">GMountOperation</link> *op,
 
390
<refsect2 id="g-mount-operation-set-choice" role="function">
 
391
<title>g_mount_operation_set_choice ()</title>
 
392
<indexterm zone="g-mount-operation-set-choice"><primary sortas="g_mount_operation_set_choice">g_mount_operation_set_choice</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_set_choice        (<link linkend="GMountOperation">GMountOperation</link> *op,
410
393
                                                         <link linkend="int">int</link> choice);</programlisting>
411
394
<para>
412
395
Sets a default choice for the mount operation.</para>
413
396
<para>
414
 
 
415
397
</para><variablelist role="params">
416
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
398
<varlistentry><term><parameter>op</parameter>&#160;:</term>
417
399
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
418
400
</simpara></listitem></varlistentry>
419
 
<varlistentry><term><parameter>choice</parameter>&nbsp;:</term>
 
401
<varlistentry><term><parameter>choice</parameter>&#160;:</term>
420
402
<listitem><simpara> an integer.
421
403
</simpara></listitem></varlistentry>
422
404
</variablelist></refsect2>
423
 
<refsect2>
424
 
<title><anchor id="g-mount-operation-reply" role="function"/>g_mount_operation_reply ()</title>
425
 
<indexterm><primary>g_mount_operation_reply</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_reply             (<link linkend="GMountOperation">GMountOperation</link> *op,
 
405
<refsect2 id="g-mount-operation-reply" role="function">
 
406
<title>g_mount_operation_reply ()</title>
 
407
<indexterm zone="g-mount-operation-reply"><primary sortas="g_mount_operation_reply">g_mount_operation_reply</primary></indexterm><programlisting><link linkend="void">void</link>                g_mount_operation_reply             (<link linkend="GMountOperation">GMountOperation</link> *op,
426
408
                                                         <link linkend="GMountOperationResult">GMountOperationResult</link> result);</programlisting>
427
409
<para>
428
410
Emits the <link linkend="GMountOperation-reply"><type>"reply"</type></link> signal.</para>
429
411
<para>
430
 
 
431
412
</para><variablelist role="params">
432
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
413
<varlistentry><term><parameter>op</parameter>&#160;:</term>
433
414
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>
434
415
</simpara></listitem></varlistentry>
435
 
<varlistentry><term><parameter>result</parameter>&nbsp;:</term>
 
416
<varlistentry><term><parameter>result</parameter>&#160;:</term>
436
417
<listitem><simpara> a <link linkend="GMountOperationResult"><type>GMountOperationResult</type></link>
437
418
</simpara></listitem></varlistentry>
438
419
</variablelist></refsect2>
439
420
 
440
421
</refsect1>
441
 
<refsect1 role="property_details">
 
422
<refsect1 id="GMountOperation.property-details" role="property_details">
442
423
<title role="property_details.title">Property Details</title>
443
 
<refsect2><title><anchor id="GMountOperation--anonymous"/>The <literal>&quot;anonymous&quot;</literal> property</title>
444
 
<indexterm><primary>GMountOperation:anonymous</primary></indexterm><programlisting>  &quot;anonymous&quot;                <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
 
424
<refsect2 id="GMountOperation--anonymous" role="property"><title>The <literal>&quot;anonymous&quot;</literal> property</title>
 
425
<indexterm zone="GMountOperation--anonymous"><primary sortas="GMountOperation:anonymous">GMountOperation:anonymous</primary></indexterm><programlisting>  &quot;anonymous&quot;                <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
445
426
<para>
446
427
Whether to use an anonymous user when authenticating.</para>
447
428
<para>
448
 
 
449
429
</para><para>Default value: FALSE</para>
450
430
</refsect2>
451
 
<refsect2><title><anchor id="GMountOperation--choice"/>The <literal>&quot;choice&quot;</literal> property</title>
452
 
<indexterm><primary>GMountOperation:choice</primary></indexterm><programlisting>  &quot;choice&quot;                   <link linkend="gint">gint</link>                  : Read / Write</programlisting>
 
431
<refsect2 id="GMountOperation--choice" role="property"><title>The <literal>&quot;choice&quot;</literal> property</title>
 
432
<indexterm zone="GMountOperation--choice"><primary sortas="GMountOperation:choice">GMountOperation:choice</primary></indexterm><programlisting>  &quot;choice&quot;                   <link linkend="gint">gint</link>                  : Read / Write</programlisting>
453
433
<para>
454
 
The index of the user's choice when a question is asked during the 
 
434
The index of the user's choice when a question is asked during the
455
435
mount operation. See the <link linkend="GMountOperation-ask-question"><type>"ask-question"</type></link> signal.</para>
456
436
<para>
457
 
 
458
437
</para><para>Allowed values: &gt;= 0</para>
459
438
<para>Default value: 0</para>
460
439
</refsect2>
461
 
<refsect2><title><anchor id="GMountOperation--domain"/>The <literal>&quot;domain&quot;</literal> property</title>
462
 
<indexterm><primary>GMountOperation:domain</primary></indexterm><programlisting>  &quot;domain&quot;                   <link linkend="gchararray">gchararray</link>            : Read / Write</programlisting>
 
440
<refsect2 id="GMountOperation--domain" role="property"><title>The <literal>&quot;domain&quot;</literal> property</title>
 
441
<indexterm zone="GMountOperation--domain"><primary sortas="GMountOperation:domain">GMountOperation:domain</primary></indexterm><programlisting>  &quot;domain&quot;                   <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
463
442
<para>
464
443
The domain to use for the mount operation.</para>
465
444
<para>
466
 
 
467
445
</para><para>Default value: NULL</para>
468
446
</refsect2>
469
 
<refsect2><title><anchor id="GMountOperation--password"/>The <literal>&quot;password&quot;</literal> property</title>
470
 
<indexterm><primary>GMountOperation:password</primary></indexterm><programlisting>  &quot;password&quot;                 <link linkend="gchararray">gchararray</link>            : Read / Write</programlisting>
 
447
<refsect2 id="GMountOperation--password" role="property"><title>The <literal>&quot;password&quot;</literal> property</title>
 
448
<indexterm zone="GMountOperation--password"><primary sortas="GMountOperation:password">GMountOperation:password</primary></indexterm><programlisting>  &quot;password&quot;                 <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
471
449
<para>
472
450
The password that is used for authentication when carrying out
473
451
the mount operation.</para>
474
452
<para>
475
 
 
476
453
</para><para>Default value: NULL</para>
477
454
</refsect2>
478
 
<refsect2><title><anchor id="GMountOperation--password-save"/>The <literal>&quot;password-save&quot;</literal> property</title>
479
 
<indexterm><primary>GMountOperation:password-save</primary></indexterm><programlisting>  &quot;password-save&quot;            <link linkend="GPasswordSave">GPasswordSave</link>         : Read / Write</programlisting>
 
455
<refsect2 id="GMountOperation--password-save" role="property"><title>The <literal>&quot;password-save&quot;</literal> property</title>
 
456
<indexterm zone="GMountOperation--password-save"><primary sortas="GMountOperation:password-save">GMountOperation:password-save</primary></indexterm><programlisting>  &quot;password-save&quot;            <link linkend="GPasswordSave">GPasswordSave</link>         : Read / Write</programlisting>
480
457
<para>
481
458
Determines if and how the password information should be saved.</para>
482
459
<para>
483
 
 
484
460
</para><para>Default value: G_PASSWORD_SAVE_NEVER</para>
485
461
</refsect2>
486
 
<refsect2><title><anchor id="GMountOperation--username"/>The <literal>&quot;username&quot;</literal> property</title>
487
 
<indexterm><primary>GMountOperation:username</primary></indexterm><programlisting>  &quot;username&quot;                 <link linkend="gchararray">gchararray</link>            : Read / Write</programlisting>
 
462
<refsect2 id="GMountOperation--username" role="property"><title>The <literal>&quot;username&quot;</literal> property</title>
 
463
<indexterm zone="GMountOperation--username"><primary sortas="GMountOperation:username">GMountOperation:username</primary></indexterm><programlisting>  &quot;username&quot;                 <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
488
464
<para>
489
465
The user name that is used for authentication when carrying out
490
466
the mount operation.</para>
491
467
<para>
492
 
 
493
468
</para><para>Default value: NULL</para>
494
469
</refsect2>
495
470
 
496
471
</refsect1>
497
472
 
498
 
<refsect1 role="signals">
 
473
<refsect1 id="GMountOperation.signal-details" role="signals">
499
474
<title role="signals.title">Signal Details</title>
500
 
<refsect2><title><anchor id="GMountOperation-ask-password"/>The <literal>&quot;ask-password&quot;</literal> signal</title>
501
 
<indexterm><primary>GMountOperation::ask-password</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GMountOperation">GMountOperation</link>  *op,
 
475
<refsect2 id="GMountOperation-ask-password" role="signal"><title>The <literal>&quot;ask-password&quot;</literal> signal</title>
 
476
<indexterm zone="GMountOperation-ask-password"><primary sortas="GMountOperation::ask-password">GMountOperation::ask-password</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GMountOperation">GMountOperation</link>  *op,
502
477
                                                        <link linkend="gchar">gchar</link>            *message,
503
478
                                                        <link linkend="gchar">gchar</link>            *default_user,
504
479
                                                        <link linkend="gchar">gchar</link>            *default_domain,
507
482
<para>
508
483
Emitted when a mount operation asks the user for a password.</para>
509
484
<para>
510
 
 
511
485
</para><variablelist role="params">
512
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
486
<varlistentry><term><parameter>op</parameter>&#160;:</term>
513
487
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link> requesting a password.
514
488
</simpara></listitem></varlistentry>
515
 
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
 
489
<varlistentry><term><parameter>message</parameter>&#160;:</term>
516
490
<listitem><simpara> string containing a message to display to the user.
517
491
</simpara></listitem></varlistentry>
518
 
<varlistentry><term><parameter>default_user</parameter>&nbsp;:</term>
 
492
<varlistentry><term><parameter>default_user</parameter>&#160;:</term>
519
493
<listitem><simpara> string containing the default user name.
520
494
</simpara></listitem></varlistentry>
521
 
<varlistentry><term><parameter>default_domain</parameter>&nbsp;:</term>
 
495
<varlistentry><term><parameter>default_domain</parameter>&#160;:</term>
522
496
<listitem><simpara> string containing the default domain.
523
497
</simpara></listitem></varlistentry>
524
 
<varlistentry><term><parameter>flags</parameter>&nbsp;:</term>
 
498
<varlistentry><term><parameter>flags</parameter>&#160;:</term>
525
499
<listitem><simpara> a set of <link linkend="GAskPasswordFlags"><type>GAskPasswordFlags</type></link>.
526
500
</simpara></listitem></varlistentry>
527
 
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
 
501
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
528
502
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
529
 
</variablelist></refsect2><refsect2><title><anchor id="GMountOperation-ask-question"/>The <literal>&quot;ask-question&quot;</literal> signal</title>
530
 
<indexterm><primary>GMountOperation::ask-question</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GMountOperation">GMountOperation</link> *op,
 
503
</variablelist></refsect2><refsect2 id="GMountOperation-ask-question" role="signal"><title>The <literal>&quot;ask-question&quot;</literal> signal</title>
 
504
<indexterm zone="GMountOperation-ask-question"><primary sortas="GMountOperation::ask-question">GMountOperation::ask-question</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GMountOperation">GMountOperation</link> *op,
531
505
                                                        <link linkend="gchar">gchar</link>           *message,
532
506
                                                        <link linkend="GStrv">GStrv</link>           *choices,
533
507
                                                        <link linkend="gpointer">gpointer</link>         user_data)      : Run Last</programlisting>
534
508
<para>
535
 
Emitted when asking the user a question and gives a list of 
 
509
Emitted when asking the user a question and gives a list of
536
510
choices for the user to choose from.</para>
537
511
<para>
538
 
 
539
512
</para><variablelist role="params">
540
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
513
<varlistentry><term><parameter>op</parameter>&#160;:</term>
541
514
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link> asking a question.
542
515
</simpara></listitem></varlistentry>
543
 
<varlistentry><term><parameter>message</parameter>&nbsp;:</term>
 
516
<varlistentry><term><parameter>message</parameter>&#160;:</term>
544
517
<listitem><simpara> string containing a message to display to the user.
545
518
</simpara></listitem></varlistentry>
546
 
<varlistentry><term><parameter>choices</parameter>&nbsp;:</term>
 
519
<varlistentry><term><parameter>choices</parameter>&#160;:</term>
547
520
<listitem><simpara> an array of strings for each possible choice.
548
521
</simpara></listitem></varlistentry>
549
 
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
 
522
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
550
523
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
551
 
</variablelist></refsect2><refsect2><title><anchor id="GMountOperation-reply"/>The <literal>&quot;reply&quot;</literal> signal</title>
552
 
<indexterm><primary>GMountOperation::reply</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GMountOperation">GMountOperation</link>      *op,
553
 
                                                        <link linkend="GMountOperationResult">GMountOperationResult</link> abort,
 
524
</variablelist></refsect2><refsect2 id="GMountOperation-reply" role="signal"><title>The <literal>&quot;reply&quot;</literal> signal</title>
 
525
<indexterm zone="GMountOperation-reply"><primary sortas="GMountOperation::reply">GMountOperation::reply</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GMountOperation">GMountOperation</link>      *op,
 
526
                                                        <link linkend="GMountOperationResult">GMountOperationResult</link> result,
554
527
                                                        <link linkend="gpointer">gpointer</link>              user_data)      : Run Last</programlisting>
555
528
<para>
556
529
Emitted when the user has replied to the mount operation.</para>
557
530
<para>
558
 
 
559
531
</para><variablelist role="params">
560
 
<varlistentry><term><parameter>op</parameter>&nbsp;:</term>
 
532
<varlistentry><term><parameter>op</parameter>&#160;:</term>
561
533
<listitem><simpara> a <link linkend="GMountOperation"><type>GMountOperation</type></link>.
562
534
</simpara></listitem></varlistentry>
563
 
<varlistentry><term><parameter>abort</parameter>&nbsp;:</term>
564
 
<listitem><simpara> a boolean indicating <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the operation was aborted.
 
535
<varlistentry><term><parameter>result</parameter>&#160;:</term>
 
536
<listitem><simpara> a <link linkend="GMountOperationResult"><type>GMountOperationResult</type></link> indicating how the request was handled
565
537
</simpara></listitem></varlistentry>
566
 
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
 
538
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
567
539
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
568
540
</variablelist></refsect2>
569
541
</refsect1>
570
542
 
571
543
 
572
544
 
573
 
 
574
 
<refsect1><refsect2 /><refsect2 /></refsect1>
575
545
</refentry>