NSR_DATA(5)                 Legato NetWorker 3.0                 NSR_DATA(5)


NAME
       nsr_data - Data formats for NetWorker Save and Recover

DESCRIPTION
       All data in the NetWorker system is encoded using the eXternal Data
       Representation (XDR) standard.  When files are passed between client
       (see save(8) and recover(8)) and server (see nsrd(8)) or server and
       media (see nsrmmd(8)), they are represented as a savestream, which is
       represented as a linked list of savefiles.  A savefile consists of
       information describing the file, a ssaverec, and file data, which is
       represented by a reference to a bucketlist.

       The XDR language description of the data structures is shown below.

       const NSRMAGIC         = 0x09265900;
       const NSRIDLEN         = 1024;  /* length of file id */
       const NSRMAXNAMELEN    = 1024;  /* max length of file system name */
       const NSRMAXCATTRSIZE  = 8192;  /* max size of client attributes */
       const NSRMAXBUCKETDATA = 8192;  /* max size of file bucket's data */
       const NSRMAXBUCKETSIZE = 9000;  /* max total size of file bucket */
       const NSRMAXCLNTSIZE   = 16384; /* max size of a clntrec */

       typedef opaque fid<NSRIDLEN>;              /* file identifier */
       typedef string nsrname<NSRMAXNAMELEN>;     /* file name type */
       typedef opaque clientattr<NSRMAXCATTRSIZE>;/* client attributes */
       typedef opaque bucket<NSRMAXBUCKETSIZE>;   /* file bucket contents */
       typedef long checksum;                      /* 4 bytes for checksum */
       typedef ulong sfidt;

       struct id {
           string  idstr<>;            /* id string */
           id        *idnext;            /* next such structure */
       };

       struct asmrec {
           id      *arinfo;            /* name and args to ASM */
           nsrname *arpath;            /* path name where applied */
           asmrec  *arnext;            /* next such structure */
       };

       struct saverec {
           nsrname srfilename;         /* name of this file */
           fid     srfid;              /* client specific file id */
           asmrec  *srar;              /* ASM list for this file */
           ulong  srcatype;           /* client specific attribute type */
           clientattr srcattr;         /* client specific file attributes */
       };

       struct ssaverec {
           sfidt  srid;               /* savefile id in the savestream */
           ulong  srsize;             /* size of encoded savefile */
           ulong  srsavetime;         /* savetime of this saveset */
           wrapclntrec srwcr;          /* must be a wrapped saverec */
       };



Licensed material--property of copyright holder(s)                         1

NSR_DATA(5)                 Legato NetWorker 3.0                 NSR_DATA(5)


       /* file data is broken up into a linked list of buckets.  */
       struct bucketlist {
           bucket  blbucket;
           bucketlist *blnext;
       };

       struct savefile {
           long    sfmagic;            /* magic number must be NSRMAGIC */
           bool    sfckflag;           /* is this file checksummed */
           ssaverec sfsaverec;         /* file attributes */
           bucketlist *sfdata;         /* file data */
           checksum sfchecksum;        /* checksum bytes */
       };

       /* linked list of savefiles */
       struct savestream {
           savefile sssavefile;
           savestream *ssnext;
       };


SEE ALSO
       mmdata(5), nsr(8), nsrmmd(8), nsrd(8), recover(8), save(8), xdr(3n).
       RFC 1014 XDR Protocol Spec.

































Licensed material--property of copyright holder(s)                         2