1LFC_STARTTRANS(3)            LFC Library Functions           LFC_STARTTRANS(3)
2
3
4

NAME

6       lfc_starttrans - start transaction mode
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "lfc_api.h"
11
12       int lfc_starttrans (char *server, char *comment);
13

DESCRIPTION

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

RETURN VALUE

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

ERRORS

28       EINVAL       The length of comment exceeds CA_MAXCOMMENTLEN.
29
30       SENOSHOST    Host unknown.
31
32       SENOSSERV    Service unknown.
33
34       SECOMERR     Communication error.
35
36       ENSNACT      Name server is not running or is being shutdown.
37

SEE ALSO

39       lfc_aborttrans(3), lfc_endtrans(3)
40
41
42
43LFC          $Date: 2010-04-05 09:51:26 +0200 (Mon, 05 Apr 201L0F)C_$STARTTRANS(3)
Impressum