NAME

sam_mig_create_file - Creates an offline Oracle HSM 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 StorageTek QFS or Oracle HSM file from a foreign (non- StorageTek QFS or Oracle HSM) 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 (3x)).

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

_tmode      ulong_t	"File mode (see mknod (2))"
_tuid       ulong_t	"User ID of the file's owner"
_tgid       ulong_t	"Group ID of the file's owner"
_tsize      u_longlong_t	"File size in bytes"
_tatime     ulong_t	"Time of last access"
_tctime     ulong_t	"Time of last file status change"
_tmtime     ulong_t	"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:

Table 1: Elements of the sam_stat structure
position;	u_longlong_t	Any 8 bytes
creation_time;	time_t	The time the archive file is created
offset;	uint_t	Any 4 bytes
vsn[32];	char	Any 31 characters
media[2];	char	2nd character of media type (must be 'z')
media[3];	char	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.

RETURN VALUES

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 StorageTek QFS and Oracle HSM file systems.