Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
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).