bionic (3) lfc_starttrans.3.gz

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 successful, 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)