fstadm(1M)fstadm(1M)NAMEfstadm - defines and manages file system stack templates
SYNOPSIS
filename name]
template_name
template_name
template_name
DESCRIPTION
The command performs basic administrative operations on file system
stack templates. Operations include creating and deleting templates,
listing all templates on the system, and displaying the contents 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 command.
The command also validates all templates at the time that they are cre‐
ated, 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 enforces
the constraints as needed.
Note that end users do not need to be concerned about what constraints
exist and how they are implemented: they only need to use to create all
their templates, and will report on any problems with a user's proposed
stack template. It is then easy to modify the inputs to 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
mount option. For example, the command below will mount the desired
file system, with a stack described by template built above it. The
file system on will now have the features of plus those of all of the
modules on the stack described by
Note that templates do not include information about the base file sys‐
tem to be mounted (e.g. or so the base file system must still be spec‐
ified on the command line in the traditional way. (Support for tem‐
plates that include base file systems is not included in the current
versions of HP-UX.)
can be invoked only by a user who has appropriate privileges.
The behavior of the command depends upon the command name keyword spec‐
ified as the first operand.
Command Keywords and Options
The following command keywords, arguments, and options are currently
supported.
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
option, or
· a string that describes a template directly in the command
line, specified with the option.
The option cannot be used in conjunction with the option.
A template can contain information about the mount options to
use at each level of a stack. For information about the spe‐
cific mount options that are available for each stackable file
system module, consult the manpage for the module itself.
The 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 system template database and
make it available for use with future mounts.
The arguments that can be used with the keyword are:
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:
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 bot‐
tom. The format of these text files is identical to that
of the output of the command keyword.
Specifies the contents of a stack template.
The format for this string is:
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 sepa‐
rated 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.
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 is used. For if it
is omitted, the name of the new template defaults to the
name of the file specified with
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 command will fail when‐
ever 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 or the command will always
fail, even if was specified. The rationale for this is
that templates for stacks that are currently in use cannot
be allowed to change.
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.
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 via the option.
Deletes the specified template from the system template database.
If the template is currently in use (in or deletion is not
allowed. In all other cases, the template will be removed from
the system template database after user confirmation of the
delete operation. (Template deletion is permanent and irrecov‐
erable.)
Forced delete of the specified template.
Identical to but performs the deletion without asking for user
confirmation. This command is provided for use by non-interac‐
tive scripts.
Interactive help utility.
Displays basic information about the various command keywords.
RETURN VALUE
exits with one of the following values:
Successful completion.
An error condition occurred.
Because is primarily an interactive command, an explana‐
tion of the error will be printed to standard error.
EXAMPLES
List all the file system stack templates currently on the system:
Display the contents of the stack template named
Create a new template describing a stack that contains stacked modules
named and (with module having a mount option set to 2), and name the
template
Delete the file system stack template named
AUTHOR
was developed by HP.
SEE ALSOmount(1M).
fstadm(1M)