1DPNS_STARTTRANS(3)           DPNS  Library Functions          DP‐
2NS_STARTTRANS(3)
3
4
5
6[1mNAME[0m
7       dpns_starttrans ‐ start transaction mode
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpns_api.h"[0m
12
13       [1mint dpns_starttrans (char  *[4m[22mserver[24m[1m,  char
14*[4m[22mcomment[24m[1m);[0m
15
16[1mDESCRIPTION[0m
17       [1mdpns_starttrans   [22mstarts   transaction   mode.  The
18connection to the Name
19       Server is kept open until one of  the  DB  update   opera‐
20tion  fails  or
21       [1mdpns_aborttrans   [22mor   [1mdpns_endtrans  [22mis ex‐
22plicitly called.  If all the DB
23       update  operations  between   [1mdpns_starttrans   [22mand
24[1mdpns_endtrans  [22mare  suc‐
25       cessful,   a   COMMIT is done.  If any DB update operation
26fails or if an
27       explicit [1mdpns_aborttrans [22mis  done,  a  ROLLBACK  is
28done.  The  [4mcomment[24m  is
29       logged in the server log.
30
31[1mRETURN VALUE[0m
32       This  routine  returns  0  if the operation was successful
33or ‐1 if the
34       operation failed. In the latter case, [1mserrno [22mis set
35appropriately.
36
37[1mERRORS[0m
38       [1mEINVAL        [22mThe  length of [4mcomment[24m exceeds
39[1mCA_MAXCOMMENTLEN[22m.
40
41       [1mSENOSHOST    [22mHost unknown.
42
43       [1mSENOSSERV    [22mService unknown.
44
45       [1mSECOMERR     [22mCommunication error.
46
47       [1mENSNACT      [22mName server is not running or is being
48shutdown.
49
50[1mSEE ALSO[0m
51       [1mdpns_aborttrans(3)[22m, [1mdpns_endtrans(3)[0m
52
53
54
55DPNS                                 $Date$                   DP‐
56NS_STARTTRANS(3)
57
58
59
60
61
62
63
64
65
66
Impressum