swpackage.4 (2010 09)

s
swpackage(4) swpackage(4)
All attributes for the destination file object are taken from the source file, unless a
file_permissions
keyword is active, or the -m, -o,or
-g, options are also included in the
file specification.
destination
Defines the destination path at which the file will be installed. If
destination is a relative
path, the active destination directory set by the
directory keyword will be prefixed to it. If
it is a relative path, and no destination directory is active, swpackage generates an error. If
the destination is not specified, the source is used as the destination , with the appropriate
mapping done with the active destination directory (if any).
-m mode
Defines the (octal) mode of a file or directory.
-o [owner[,]][uid
]
Defines the destination file’s owner name and/or or uid. If only the owner is specified, the
owner and uid attributes are set for the destination file object, based on the packaging host’s
/etc/passwd. If only the uid is specified, it is set as the uid attribute for the destination
object and no owner name is assigned. If both are specified, each sets the corresponding attri-
bute for the file object. To specify a numeric username on systems that support numeric user
names for owners, you must specify both the numeric owner username and the uid. If only one
value is supplied for owner, it will be interpreted as an id if the value is numeric. Otherwise,
it will be interpreted as a name. During an installation, the owner attribute is used to set the
owner name and uid, unless the owner name is not defined in the target system’s
/etc/passwd. In this case, the uid attribute is used to set the uid.
-g [group[,]][gid]
Defines the destination file’s group name and/or or gid. If only the group is specified, the group
and gid attributes are set for the destination file object, based on the packaging host’s
/etc/group. If only the group is specified, and it contains digits only, it is interpreted as the
gid, and is set as the gid attribute for the destination object; no group name is assigned to the
object. If both are specified, each sets the corresponding attribute for the file object. To specify
a numeric groupname on systems that support numeric group names for groups, you must
specify both the numeric group groupname and the gid. If only one value is supplied for
group, it will be interpreted as an id if the value is numeric. Otherwise, it will be interpreted
as a name. During an installation, the group attribute is used to set the group name and gid,
unless the group name is not defined in the target system’s
/etc/group. In this case, the gid
attribute is used to set the gid.
-t type [ mode_options ] source [ filename ]
Defines a file of type d (directory), h (hard link), or s (symbolic link). Caution, some releases of
swpackage do not work correctly with -t type, see WARNINGS section for details.
d Create a directory
If only source is specified, it is used as the destination path at which the directory will be
created, and nothing is accessed on the packaging system. If source and filename are
specified, source is used to retrieve the attributes for the directory to be created at
filename, unless redefined by mode_options.
h Create a hard link
Both source and filename must be specified. The source path must be the installed loca-
tion of a regular file elsewhere in the fileset. At install time the hard link will be created
at filename. Nothing is accessed on the packaging system.
s Create a symbolic link
Both source and filename must be specified. At install time the symbolic link will be
created at filename to point to source. The source string can be a relative or absolute
path, and that string is not modified in any way before being used as the path pointed to
by the installed symbolic link. Nothing is accessed on the packaging system.
-v Marks the file as volatile, meaning it can be modified (that is, deleted) after installed without
impacting the fileset.
When processing existing files in a source directory, a number of problems may be encountered. Errors or
warning messages are printed for each problem. (The
swpackage command terminates when errors
are encountered in reading the PSF or accessing the source files.)
22 Hewlett-Packard Company − 22 − HP-UX 11i Version 3: September 2010