sam_mig_create_file - Creates an offline SAM-QFS file from
cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsamut [library ... ]
int sam_mig_create_file(char *path, struct sam_stat *buf);
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
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
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; /* Any 31 characters */
char media; /* 2nd character of media type (must be 'z') */
char media; /* 3rd character of media type */
/* (must be a digit or lowercase alpha)*/
position Any 8 bytes that the 3rd party media program
This is the time that the archive was made. If
creation_time is zero, it will be set to the value
offset Any 4 bytes that the 3rd party media program
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
The example Migration Toolkit program.
The configuration file for Sun QFS and
SAM-QFS file systems.