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)