dpns_starttrans man page

DPNS_STARTTRANS(3)          DPNS Library Functions          DPNS_STARTTRANS(3)

[1mNAME[0m
      dpns_starttrans - start transaction mode

[1mSYNOPSIS[0m
      [1m#include <sys/types.h>[0m
      [1m#include "dpns_api.h"[0m

      [1mint dpns_starttrans (char *[4m[22mserver[24m[1m, char *[4m[22mcomment[24m[1m);[0m

[1mDESCRIPTION[0m
      [1mdpns_starttrans  [22mstarts  transaction  mode.  The connection to the Name
      Server is kept open until one of  the  DB  update  operation  fails  or
      [1mdpns_aborttrans  [22mor  [1mdpns_endtrans [22mis explicitly called.  If all the DB
      update operations between [1mdpns_starttrans [22mand  [1mdpns_endtrans  [22mare  suc-
      cessful,  a  COMMIT is done.  If any DB update operation fails or if an
      explicit [1mdpns_aborttrans [22mis done, a ROLLBACK is done.  The  [4mcomment[24m  is
      logged in the server log.

[1mRETURN VALUE[0m
      This  routine  returns  0  if the operation was successful or -1 if the
      operation failed. In the latter case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
      [1mEINVAL       [22mThe length of [4mcomment[24m exceeds [1mCA_MAXCOMMENTLEN[22m.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

      [1mENSNACT      [22mName server is not running or is being shutdown.

[1mSEE ALSO[0m
      [1mdpns_aborttrans(3)[22m, [1mdpns_endtrans(3)[0m

DPNS         $Date: 2010-04-05 09:51:26 +0200 (Mon, 05 Apr 20D1P0N)S_$STARTTRANS(3)