2 .TH "BUXTON_OPEN" "3" "buxton 1" "buxton_open"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
17 .\" disable justification (adjust text to left margin only)
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
23 buxton_open, buxton_close \- Manage buxton client connections
32 int buxton_open(BuxtonClient *\fIclient\fB)
35 void buxton_close(BuxtonClient \fIclient\fB)
41 These functions are used to manage connections from a buxton client to the
42 buxton daemon, \fBbuxtond\fR(8)\&. Clients must call \fBbuxton_open\fR(3), to
43 create a new connection to the daemon\&. Effectively, creating this connection
44 registers the client with the daemon, allowing the client to make configuration
45 changes, queries, etc\&. This function requires one argument, \fIclient\fR, a
46 pointer to a BuxtonClient owned by the client\&. It returns 0 on success,
47 and a non-zero status code on failure\&.
49 To terminate this connection, the client must call \fBbuxton_close\fR(3)\&. The
50 required argument is a reference to the same BuxtonClient passed to
51 \fBbuxton_open\fR(3)\&.
64 if ((fd = buxton_open(&client)) < 0) {
65 printf("couldn't connect\\n");
69 /* Manipulate data, register for notifications, ... */
78 Copyright 2014 Intel Corporation\&. License: Creative Commons
79 Attribution\-ShareAlike 3.0 Unported\s-2\u[1]\d\s+2, with exception
80 for code examples found in the \fBCODE EXAMPLE\fR section, which are
81 licensed under the MIT license provided in the \fIdocs/LICENSE.MIT\fR
82 file from this buxton distribution\&.
92 Creative Commons Attribution\-ShareAlike 3.0 Unported
94 \%http://creativecommons.org/licenses/by-sa/3.0/