fstadm.1m (2010 09)

f
fstadm(1M) fstadm(1M)
NAME
fstadm - defines and manages file system stack templates
SYNOPSIS
/usr/sbin/fstadm create
[-o] -f filename [
-n name]
/usr/sbin/fstadm create
[-o] -t template_string
-n name
/usr/sbin/fstadm list
/usr/sbin/fstadm display
template_name
/usr/sbin/fstadm delete
template_name
/usr/sbin/fstadm fdel
template_name
/usr/sbin/fstadm help
DESCRIPTION
The fstadm command performs basic administrative operations on file system stack templates. Opera-
tions include creating and deleting templates, listing all templates on the system, and displaying the con-
tents of templates.
File system stack templates are used to describe the structure of a file system module stack. They contain
information about the modules on a stack and the mount options for each module on the stack.
All stack templates on a system reside in the system’s stack template database. The only supported way
to access and edit templates in the system template database is to use the
fstadm command.
The
fstadm command also validates all templates at the time that they are created, to make sure that
any dependency and compatibility constraints for modules on a stack are not violated. Dependency and
compatibility constraints are specified by individual module developers, and
fstadm enforces the con-
straints as needed.
Note that end users do not need to be concerned about what constraints exist and how they are imple-
mented: they only need to use
fstadm to create all their templates, and fstadm will report on any prob-
lems with a user’s proposed stack template. It is then easy to modify the inputs to
fstadm to build a
correctly validated template.
Once a stack template is created and exists in the system template database, it can be used at mount time
by specifying its name as a
stackfs mount option. For example, the command below will mount the
desired hfs file system, with a stack described by template mytemplate built above it. The file system
on /mnt will now have the features of hfs plus those of all of the modules on the stack described by
mytemplate.
mount -F hfs -o largefiles,stackfs=mytemplate /dev/dsk/c2t0d0 /mnt
Note that templates do not include information about the base file system to be mounted (e.g.
vxfs or
hfs), so the base file system must still be specified on the mount
command line in the traditional way.
(Support for templates that include base file systems is not included in the current versions of HP-UX.)
fstadm can be invoked only by a user who has appropriate privileges.
The behavior of the
fstadm command depends upon the command name keyword specified as the first
operand.
Command Keywords and Options
The following command keywords, arguments, and options are currently supported.
create -f | -t
Creates a new template. To describe a template, this command takes two types of input:
• a text file that describes a template, specified with the
-f option, or
• a string that describes a template directly in the command line, specified with the
-t option.
The
-t option cannot be used in conjunction with the -f option.
A template can contain information about the mount options to use at each level of a stack. For
information about the specific mount options that are available for each stackable file system
module, consult the manpage for the module itself.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1