remctl_close

Langue: en

Version: 2007-06-29 (fedora - 05/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

remctl_close - Close a remctl connection and free the client object

SYNOPSIS

#include <remctl.h>

void remctl_close(struct remctl *r);

DESCRIPTION

remctl_close() cleanly closes any connection to a remote server created via remctl_open() for the given client object and then frees the object created by remctl_new(). It should be called when the caller is finished with a remctl client object to avoid resource leaks. Following the call to remctl_close(), the r pointer to the remctl client object is no longer valid.

remctl_close() is always successful, even if it is unable to send a clean protocol quit command to the remote server.

SEE ALSO

remctl_new(3), remctl_open(3)

The current version of the remctl library and complete details of the remctl protocol are available from its web page at <http://www.eyrie.org/~eagle/software/remctl/>.

AUTHOR

Russ Allbery <rra@stanford.edu>