debian man page for lfc_starttrans

LFC_STARTTRANS(3)					       LFC Library Functions						 LFC_STARTTRANS(3)

NAME
       lfc_starttrans - start transaction mode

SYNOPSIS
       #include <sys/types.h>
       #include "lfc_api.h"

       int lfc_starttrans (char *server, char *comment);

DESCRIPTION
       lfc_starttrans  starts  transaction  mode.   The  connection  to the Name Server is kept open until one of the DB update operation fails or
       lfc_aborttrans or lfc_endtrans is explicitly called.  If all the DB update operations between lfc_starttrans and lfc_endtrans are  success-
       ful,  a	COMMIT	is  done.   If any DB update operation fails or if an explicit lfc_aborttrans is done, a ROLLBACK is done.  The comment is
       logged in the server log.

RETURN VALUE
       This routine returns 0 if the operation was successful or -1 if the operation failed. In the latter case, serrno is set appropriately.

ERRORS
       EINVAL	    The length of comment exceeds CA_MAXCOMMENTLEN.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       ENSNACT	    Name server is not running or is being shutdown.

SEE ALSO
       lfc_aborttrans(3), lfc_endtrans(3)

LFC
					       $Date: 2010-04-05 09:51:26 +0200 (Mon, 05 Apr 2010) $				 LFC_STARTTRANS(3)