sam_mig_create_file(3)

NAME
sam_mig_create_file - Creates an offline Sun StorageTek 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 StorageTek SAM-FS or Sun SAM-QFS file from a foreign (non- Sun StorageTek SAM-FS or Sun SAM-QFS) media. sam_mig_create_file() creates an offline file using information 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 fields of this struct are ignored: st_ino, st_dev, st_rdev, st_nlink, st_blksize, st_blocks, cs_algo, flags, gen, residence_time, and attribute_time.

These members in the sam_stat structure must be filled in:

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 StorageTek SAM-FS and Sun SAM-QFS file systems.

SEE ALSO
sam_stat(3).