sam_mig_create_file(3)

NAME
     sam_mig_create_file - Creates an offline SAM-QFS  file  from
     foreign media

SYNOPSIS
     cc [ flag  ... ] file  ...  -L/opt/SUNWsamfs/lib  -lsamut  [library ... ]

     #include "/opt/SUNWsamfs/include/mig.h"
     #include "/opt/SUNWsamfs/include/stat.h"

     int sam_mig_create_file(char *path, struct sam_stat *buf);

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     sam_mig_create_file() creates an offline Sun QFS or  SAM-QFS
     file  from  a  foreign  (non-  Sun  QFS  or  SAM-QFS) media.
     sam_mig_create_file() creates an offline file using informa-
     tion  supplied  by  a  foreign  data migration program.  The
     information used to identify the location  of  the  file  is
     stored in the file inode in the archive record.

     Note that the program calling this function  is  responsible
     for  creating all directories in the path before calling the
     function.

     path is the pathname to the file to be created.  It  may  be
     an  absolute or relative pathname but must be no longer than
     PATH_MAX (see the /usr/include/limits.h file).

     buf is a sam_stat structure (see sam_stat(3)).

     The following members in  the  sam_stat  structure  must  be
     filled in.  All other fields are ignored.

     ulong_t       st_mode      /* File mode (see mknod(2)) */
     ulong_t       st_uid       /* User ID of the file's owner */
     ulong_t       st_gid       /* Group ID of the file's owner */
     u_longlong_t  st_size      /* File size in bytes */
     ulong_t       st_atime     /* Time of last access      */
     ulong_t       st_ctime     /* Time of last file status change */
     ulong_t       st_mtime     /* Time of last data modification  */

     These members in the sam_copy_s structure  for  the  desired
     copy  (copy[] part of the sam_stat structure) must be filled
     in:
     u_longlong_t  position;       /* Any 8 bytes */
     time_t        creation_time;  /* The time the archive file is created */
     uint_t        offset;         /* Any 4 bytes */
     char          vsn[32];        /* Any 31 characters */
     char          media[2];       /* 2nd character of media type (must be 'z') */
     char          media[3];       /* 3rd character of media type */
                                   /* (must be a digit or lowercase alpha)*/

     position  Any 8 bytes  that  the  3rd  party  media  program
               requires.

     creation_time
               This is the time that the archive  was  made.   If
               creation_time is zero, it will be set to the value
               of time().

     offset    Any 4 bytes  that  the  3rd  party  media  program
               requires.

     vsn       This is any 31  characters.   The  32nd  character
               must  be a zero byte.  Other utilities may require
               this to be a valid VSN.

     media     The second character of the  two  character  media
               type.   If this field is zero, then this copy does
               not contain any archive information  and  will  be
               ignored.  At least one of the entries must contain
               information.  Upon succesful creation of a file  a
               value  of 0 is returned.  Otherwise, a value of -1
               is returned and  errno  is  set  to  indicate  the
               error.

FILES
     /opt/SUNWsamfs/migkit/mig_build_cd.c
                         The example Migration Toolkit program.

     /etc/opt/SUNWsamfs/mcf
                         The configuration file for Sun  QFS  and
                         SAM-QFS file systems.

SEE ALSO
     sam_stat(3).