fstadm.1m (2010 09)

f
fstadm(1M) fstadm(1M)
The create command uses the information in its input to validate and build a new template. If
the new template’s structure fails validation, this command will abort and print an error message
describing the problem. If validation succeeds, this command will create the template in the sys-
tem template database and make it available for use with future mounts.
The arguments that can be used with the
create keyword are:
-f filename
Specifies the name of a text file that describes the contents of a stack template. Information
in the text file will be used as a guide to construct the desired stack template. The format
of each line in the text file is:
module options
That is, each line of the text file describes one level of the desired stack. Within each line,
a module and its mount options are separated by a single space character. The first line of
the file represents the top of the stack, and the last line of the file represents the bottom.
The format of these text files is identical to that of the output of the
display command
keyword.
-t template_string
Specifies the contents of a stack template. The format for this string is:
module1
:options1;module2:options2;...;moduleN:optionsN
That is, an entire stack is described within the string, and each level of a stack is separated
by a semicolon (
;). Within a level, a module and its mount options are separated by a colon
(:). (But the colon does not need to be included for modules without mount options.) The
leftmost module in the string represents the top of the stack, and the right-most module
represents the bottom of the stack.
-n name
Specifies the name of the template to be created. The maximum supported length for the
template name is 128 characters.
This is a required argument whenever
-t is used. For -f, if it is omitted, the name of the
new template defaults to the name of the file specified with -f
.
-o Overwrite option. If a template with the same name as the new template being created
already exists, overwrites the old template. If this option is not specified, the create
com-
mand will fail whenever a template of the same name already exists.
Note however that if a template of the same name exists AND is currently in use (in
/etc/fstab or /etc/mnttab), the create command will always fail, even if -o was
specified. The rationale for this is that templates for stacks that are currently in use can-
not be allowed to change.
list List all the templates in the system. This command displays the names of all templates
currently stored in the system template database. Each template name is listed in its own line of
output.
display template_name
Displays the contents of the specified template. This command will display the contents of the
named template as text output, with each level of the stack described by one line of output. That
is, each line of output will contain a module name, a space, and then the module’s mount options
(if any). The first line displayed represents the top of the stack, and the last line represents the
bottom of the stack.
Optionally, if it is redirected to a file, this output can also be used as input to
fstadm create
via the -f option.
delete template_name
Deletes the specified template from the system template database. If the template is currently in
use (in /etc/fstab or /etc/mnttab), deletion is not allowed. In all other cases, the tem-
plate will be removed from the system template database after user confirmation of the delete
operation. (Template deletion is permanent and irrecoverable.)
fdel template_name
Forced delete of the specified template. Identical to delete, but performs the deletion without
asking for user confirmation. This command is provided for use by non-interactive scripts.
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010