1DPNS_STARTTRANS(3)          DPNS Library Functions          DPNS_STARTTRANS(3)
2
3
4

NAME

6       dpns_starttrans - start transaction mode
7

SYNOPSIS

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

DESCRIPTION

15       dpns_starttrans  starts  transaction  mode.  The connection to the Name
16       Server is kept open until one of  the  DB  update  operation  fails  or
17       dpns_aborttrans  or  dpns_endtrans is explicitly called.  If all the DB
18       update operations between dpns_starttrans and  dpns_endtrans  are  suc‐
19       cessful,  a  COMMIT is done.  If any DB update operation fails or if an
20       explicit dpns_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       dpns_aborttrans(3), dpns_endtrans(3)
40
41
42
43DPNS         $Date: 2010-04-05 09:51:26 +0200 (Mon, 05 Apr 20D1P0N)S_$STARTTRANS(3)
Impressum