1LFC_STARTTRANS(3)                 LFC      Library      Functions
2LFC_STARTTRANS(3)
3
4
5
6[1mNAME[0m
7       lfc_starttrans ‐ start transaction mode
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "lfc_api.h"[0m
12
13       [1mint lfc_starttrans  (char  *[4m[22mserver[24m[1m,  char
14*[4m[22mcomment[24m[1m);[0m
15
16[1mDESCRIPTION[0m
17       [1mlfc_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       [1mlfc_aborttrans   [22mor   [1mlfc_endtrans   [22mis  ex‐
22plicitly called.  If all the DB
23       update  operations   between   [1mlfc_starttrans   [22mand
24[1mlfc_endtrans [22mare  success‐
25       ful,   a   COMMIT  is  done.   If  any DB update operation
26fails or if an
27       explicit [1mlfc_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       [1mlfc_aborttrans(3)[22m, [1mlfc_endtrans(3)[0m
52
53
54
55LFC                                                        $Date$
56LFC_STARTTRANS(3)
57
58
59
60
61
62
63
64
65
66
Impressum