Svcexpand() - VeriFone MX800 series Programmer's Manual

S F
ERVICE UNCTIONS

svcExpand()

svcExpand()
172
M X 800 S P
ERIES ROGRAMMERS
Prototype
int svcExpand(char *inFile, int keepinFile, char *uowner)
Parameters
inFile Pointer to a string containing the name of the file to expand. This file
should be in a tar format with or without either GNU zipped or binary
zipped compression. The file should be named appropriately with the
correct extension following customary Linux naming conventions
regarding tar files. Either .TAR for a regular tar archive or .TGZ or
.GZ for a GNU zipped format. For a binary zipped format, it should
have the extension .BZ2. These are the only formats supported at
this time. The file extension is not case sensitive.
keepinFile A flag to indicate whether to keep the tar file after expansion takes
place. Default is to delete the tar file.
uowner Pointer to a string containing the name of the user that the expansion
is taking place for. If an application calls this function, then it should
be set to the user name of the user that the application is running
under. If this file is called from System Mode via a download, then
currently, the user will be set to the primary user: usr1.
The svcExpand() function first checks if the inFile parameter contains a valid
TAR formatted file as described above under inFile description. If it does, then
all files are extracted in the users home directory for the user specified in the
uowner parameter. After all files are extracted, all non-root owned files and
directories within the user's home directory are set to the user's ownership.
Permissions are set for each file to what they were at the time the file was
archived.
G
UIDE