From 4b4c5c6741d189f250f71dbe9cd77472375254a7 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Tue, 19 Jul 2016 17:42:36 +0200 Subject: m + add libcoopgamma_get_methods.3 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- doc/man/libcoopgamma.h.0 | 2 +- doc/man/libcoopgamma_get_methods.3 | 61 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 62 insertions(+), 1 deletion(-) create mode 100644 doc/man/libcoopgamma_get_methods.3 diff --git a/doc/man/libcoopgamma.h.0 b/doc/man/libcoopgamma.h.0 index 4dba1e4..15fb38f 100644 --- a/doc/man/libcoopgamma.h.0 +++ b/doc/man/libcoopgamma.h.0 @@ -1,4 +1,4 @@ -.TH LIBCOOPGAMMA 7 LIBCOOPGAMMA +.TH LIBCOOPGAMMA.H 0 LIBCOOPGAMMA .SH "NAME" libcoopgamma.h - Cooperative gamma library header .SH "SYNOPSIS" diff --git a/doc/man/libcoopgamma_get_methods.3 b/doc/man/libcoopgamma_get_methods.3 new file mode 100644 index 0000000..f154262 --- /dev/null +++ b/doc/man/libcoopgamma_get_methods.3 @@ -0,0 +1,61 @@ +.TH LIBCOOPGAMMA_GET_METHODS 3 LIBCOOPGAMMA +.SH "NAME" +libcoopgamma_get_methods - List all recognised adjustment method +.SH "SYNOPSIS" +.nf +#include + +char** libcoopgamma_get_methods(void); +.fi +.P +Link with +.IR -lcoopgamma . +.SH "DESCRIPTION" +The +.BR libcoopgamma_get_methods () +function consults +.BR coopgammad (1) +to construct a list of all adjustment method name +recognised by +.BR coopgammad (1). +.P +For the duration of the function call, +.I SIGCHLD +most neither be ignored nor blocked. It is the +user of this library's responsibility to ensure +this. The +.BR libcoopgamma_get_methods () +function will not temporarily reset handling of +.I SIGCHLD +itself. +.SH "RETURN VALUES" +The +.BR libcoopgamma_get_methods () +function returns a list of recognised +adjustment method name. The list is terminated +by a +.I NULL +element and will contain no other +.I NULL +elements. Elements in the list are subpointers +of the returned pointer and most not be freed. +The user shall however free the returned pointer, +effectively freeing all elements stored in the list. +On error, +.I NULL +is returned and +.I errno +is set appropriately. +.SH "ERRORS" +The +.BR libcoopgamma_get_methods () +function may fail for any reason specified for +.BR malloc (3), +.BR realloc (3), +and +.BR libcoopgamma_get_method_and_site (3). +.SH "SEE ALSO" +.BR libcoopgamma_get_method_and_site (3), +.BR libcoopgamma_get_pid_file (3), +.BR libcoopgamma_get_socket_file (3), +.BR libcoopgamma_connect (3) -- cgit v1.2.3-70-g09d2