lfc_starttrans man page

LFC_STARTTRANS(3)            LFC Library Functions           LFC_STARTTRANS(3)

[1mNAME[0m
      lfc_starttrans - start transaction mode

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

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

[1mDESCRIPTION[0m
      [1mlfc_starttrans  [22mstarts  transaction  mode.   The connection to the Name
      Server is kept open until one of  the  DB  update  operation  fails  or
      [1mlfc_aborttrans  [22mor  [1mlfc_endtrans  [22mis  explicitly called.  If all the DB
      update operations between [1mlfc_starttrans [22mand [1mlfc_endtrans [22mare  success-
      ful,  a  COMMIT  is  done.   If  any DB update operation fails or if an
      explicit [1mlfc_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
      [1mlfc_aborttrans(3)[22m, [1mlfc_endtrans(3)[0m

LFC          $Date: 2010-04-05 09:51:26 +0200 (Mon, 05 Apr 201L0F)C_$STARTTRANS(3)