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)