1REMCTL_CLOSE(3) remctl Library Reference REMCTL_CLOSE(3)
2
3
4
6 remctl_close - Close a remctl connection and free the client object
7
9 #include <remctl.h>
10
11 void remctl_close(struct remctl *r);
12
14 remctl_close() cleanly closes any connection to a remote server created
15 via remctl_open() for the given client object and then frees the object
16 created by remctl_new(). It should be called when the caller is
17 finished with a remctl client object to avoid resource leaks.
18 Following the call to remctl_close(), the r pointer to the remctl
19 client object is no longer valid.
20
21 remctl_close() is always successful, even if it is unable to send a
22 clean protocol quit command to the remote server.
23
25 This interface has been provided by the remctl client library since its
26 initial release in version 2.0.
27
29 Russ Allbery <eagle@eyrie.org>
30
32 Copyright 2007, 2009, 2014 The Board of Trustees of the Leland Stanford
33 Junior University
34
35 Copying and distribution of this file, with or without modification,
36 are permitted in any medium without royalty provided the copyright
37 notice and this notice are preserved. This file is offered as-is,
38 without any warranty.
39
41 remctl_new(3), remctl_open(3)
42
43 The current version of the remctl library and complete details of the
44 remctl protocol are available from its web page at
45 <http://www.eyrie.org/~eagle/software/remctl/>.
46
47
48
493.14 2018-04-01 REMCTL_CLOSE(3)