~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed

<a class="link" href="GUnixConnection.html#g-unix-connection-send-credentials" title="g_unix_connection_send_credentials ()">g_unix_connection_send_credentials</a> ()

</tr>

<tr>

100

101

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

101

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

102

</td>

103

104

<a class="link" href="GUnixConnection.html#g-unix-connection-send-credentials-finish" title="g_unix_connection_send_credentials_finish ()">g_unix_connection_send_credentials_finish</a> ()

122

</div>

123

124

<a name="GUnixConnection.object-hierarchy"></a><h2>Object Hierarchy</h2>

125

<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>

125

<pre class="screen"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

126

╰── <a class="link" href="GIOStream.html" title="GIOStream">GIOStream</a>

127

╰── <a class="link" href="GSocketConnection.html" title="GSocketConnection">GSocketConnection</a>

128

╰── GUnixConnection

147

<a name="GUnixConnection.functions_details"></a><h2>Functions</h2>

148

149

<a name="g-unix-connection-receive-fd"></a><h3>g_unix_connection_receive_fd ()</h3>

150

150

151

g_unix_connection_receive_fd (<code><a class="link" href="GUnixConnection.html" title="GUnixConnection">GUnixConnection</a> *connection</code>,

152

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

153

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

153

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

154

Receives a file descriptor from the sending end of the connection.

155

The sending end has to call <a class="link" href="GUnixConnection.html#g-unix-connection-send-fd" title="g_unix_connection_send_fd ()"><code class="function">g_unix_connection_send_fd()</code></a> for this

156

to work.

173

</tr>

174

<tr>

175

<td class="parameter_name">cancellable</td>

176

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

176

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

177

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

178

</tr>

179

<tr>

180

<td class="parameter_name">error</td>

181

<td class="parameter_description"> <a href="../glib/glib-Error-Reporting.html#GError">GError</a> for error reporting, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

181

<td class="parameter_description"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> for error reporting, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

182

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

183

</tr>

184

</tbody>

194

<hr>

195

196

<a name="g-unix-connection-send-fd"></a><h3>g_unix_connection_send_fd ()</h3>

197

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

197

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

198

g_unix_connection_send_fd (<code><a class="link" href="GUnixConnection.html" title="GUnixConnection">GUnixConnection</a> *connection</code>,

199

<code><a href="../glib/glib-Basic-Types.html#gint">gint</a> fd</code>,

199

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> fd</code>,

200

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

201

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

201

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

202

Passes a file descriptor to the receiving side of the

203

connection. The receiving end has to call <a class="link" href="GUnixConnection.html#g-unix-connection-receive-fd" title="g_unix_connection_receive_fd ()"><code class="function">g_unix_connection_receive_fd()</code></a>

204

to accept the file descriptor.

226

</tr>

227

<tr>

228

<td class="parameter_name">cancellable</td>

229

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

230

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

231

</tr>

232

<tr>

233

<td class="parameter_name">error</td>

234

235

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

236

</tr>

237

</tbody>

239

</div>

240

241

<a name="id-1.4.14.4.8.3.7"></a><h4>Returns</h4>

242

a <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

242

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

243

244

</div>

245

Since 2.22

250

<pre class="programlisting"><a class="link" href="GCredentials.html" title="GCredentials">GCredentials</a> *

251

g_unix_connection_receive_credentials (<code><a class="link" href="GUnixConnection.html" title="GUnixConnection">GUnixConnection</a> *connection</code>,

252

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

253

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

253

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

254

Receives credentials from the sending end of the connection. The

255

sending end has to call <a class="link" href="GUnixConnection.html#g-unix-connection-send-credentials" title="g_unix_connection_send_credentials ()"><code class="function">g_unix_connection_send_credentials()</code></a> (or

256

similar) for this to work.

275

</tr>

276

<tr>

277

<td class="parameter_name">cancellable</td>

278

<td class="parameter_description"> A <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

278

<td class="parameter_description"> A <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

279

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

280

</tr>

281

<tr>

282

<td class="parameter_name">error</td>

283

<td class="parameter_description">Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

283

<td class="parameter_description">Return location for error or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

284

285

</tr>

286

</tbody>

289

290

<a name="id-1.4.14.4.8.4.8"></a><h4>Returns</h4>

291

Received credentials on success (free with

292

<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>), <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

292

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>), <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>error</code>

293

is set.

294

[<acronym title="Free data after the code is done.">transfer full</acronym>]

295

</div>

303

(<code><a class="link" href="GUnixConnection.html" title="GUnixConnection">GUnixConnection</a> *connection</code>,

304

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

305

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

306

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

306

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

307

Asynchronously receive credentials.

308

For more details, see <a class="link" href="GUnixConnection.html#g-unix-connection-receive-credentials" title="g_unix_connection_receive_credentials ()"><code class="function">g_unix_connection_receive_credentials()</code></a> which is

309

the synchronous version of this call.

326

</tr>

327

<tr>

328

<td class="parameter_name">cancellable</td>

329

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

330

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

331

</tr>

332

<tr>

351

g_unix_connection_receive_credentials_finish

352

(<code><a class="link" href="GUnixConnection.html" title="GUnixConnection">GUnixConnection</a> *connection</code>,

353

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

354

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

354

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

355

Finishes an asynchronous receive credentials operation started with

356

<a class="link" href="GUnixConnection.html#g-unix-connection-receive-credentials-async" title="g_unix_connection_receive_credentials_async ()"><code class="function">g_unix_connection_receive_credentials_async()</code></a>.

357

375

</tr>

376

<tr>

377

<td class="parameter_name">error</td>

378

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

378

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

379

380

</tr>

381

</tbody>

383

</div>

384

385

<a name="id-1.4.14.4.8.6.6"></a><h4>Returns</h4>

386

a <a class="link" href="GCredentials.html" title="GCredentials">GCredentials</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

387

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

386

a <a class="link" href="GCredentials.html" title="GCredentials">GCredentials</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

387

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

388

[<acronym title="Free data after the code is done.">transfer full</acronym>]

389

</div>

390

Since 2.32

392

<hr>

393

394

<a name="g-unix-connection-send-credentials"></a><h3>g_unix_connection_send_credentials ()</h3>

395

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

395

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

396

g_unix_connection_send_credentials (<code><a class="link" href="GUnixConnection.html" title="GUnixConnection">GUnixConnection</a> *connection</code>,

397

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

398

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

398

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

399

Passes the credentials of the current user the receiving side

400

of the connection. The receiving end has to call

401

<a class="link" href="GUnixConnection.html#g-unix-connection-receive-credentials" title="g_unix_connection_receive_credentials ()"><code class="function">g_unix_connection_receive_credentials()</code></a> (or similar) to accept the

421

</tr>

422

<tr>

423

<td class="parameter_name">cancellable</td>

424

425

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

426

</tr>

427

<tr>

428

<td class="parameter_name">error</td>

429

<td class="parameter_description">Return location for error or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

429

430

431

</tr>

432

</tbody>

434

</div>

435

436

<a name="id-1.4.14.4.8.7.8"></a><h4>Returns</h4>

437

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

437

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if <code>error</code>

438

is set.

439

440

</div>

448

(<code><a class="link" href="GUnixConnection.html" title="GUnixConnection">GUnixConnection</a> *connection</code>,

449

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

450

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

451

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

451

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

452

Asynchronously send credentials.

453

For more details, see <a class="link" href="GUnixConnection.html#g-unix-connection-send-credentials" title="g_unix_connection_send_credentials ()"><code class="function">g_unix_connection_send_credentials()</code></a> which is

454

the synchronous version of this call.

471

</tr>

472

<tr>

473

<td class="parameter_name">cancellable</td>

474

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

475

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

476

</tr>

477

<tr>

492

<hr>

493

494

<a name="g-unix-connection-send-credentials-finish"></a><h3>g_unix_connection_send_credentials_finish ()</h3>

495

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

495

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

496

g_unix_connection_send_credentials_finish

497

(<code><a class="link" href="GUnixConnection.html" title="GUnixConnection">GUnixConnection</a> *connection</code>,

498

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

499

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

499

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

500

Finishes an asynchronous send credentials operation started with

501

<a class="link" href="GUnixConnection.html#g-unix-connection-send-credentials-async" title="g_unix_connection_send_credentials_async ()"><code class="function">g_unix_connection_send_credentials_async()</code></a>.

502

520

</tr>

521

<tr>

522

<td class="parameter_name">error</td>

523

524

525

</tr>

526

</tbody>

528

</div>

529

530

<a name="id-1.4.14.4.8.9.6"></a><h4>Returns</h4>

531

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

531

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation was successful, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

532

533

</div>

534

Since 2.32

Older »