stfsmount

Mounts the global namespace.

Read syntax diagramSkip visual syntax diagram
>>-stfsmount--+-------------+--mount_point---------------------->
              '-client_name-'

>--+--------------------+--+------------------------+----------->
   '- -fstypename--name-'  '- -fstypenumber--number-'

>--+------------+--+----------+--+---------+--+---------+------><
   +- -readonly-+  '- -nosuid-'  '- -nodev-'  '- -quiet-'
   '- -ro-------'

Parameters

client_name
Identifies the unique name of the virtual client to which you want to mount the global namespace. The client must be up and running. The default client name is the host name of the client system.
mount_point
Specifies the directory associated with the global namespace image that you want to mount.
–fstypename name
Specifies the name of the file-system type to use for the file-system-driver instance. This is the same name used to load the file-system driver.

This name relates to a specific file-system-type number. The file /etc/vfs maps the file-system-type name to the number.

If you do not specify a file-system-type name or number, the system defaults to the file-system-type named "sanfs." If there is no such type in the /etc/vfs file, the system defaults to the file-system-type number 20.

You would use this parameter only when you load multiple instances of the file-system driver on the same client system.

–fstypenumber number
The number that identifies the file-system type for the file-system-driver instance. All mount requests for a file system of this type are routed to this file-system-driver instance.
–readonly | –ro
Sets the global namespace image to read only. If specified, an attempt to update data or metadata in the global namespace will fail, and an attempt to access a file-system object will not update its access-time attribute.
–nosuid
Disallows any invocation of the setuid or setgid commands from this file-system image.
–nodev
Disallows any attempts to open device nodes in this file-system image.
–quiet
Turns off informational messages for this command. This parameter does not affect error messages.

Prerequisites

You must have root privileges to use this command.

Description

This command creates an image of the global namespace on the client system by mounting a directory. The global namespace maintains a list of its directories that are available to the clients. When a client mounts a directory in the global namespace, that directory and its subdirectories become part of the client's directory hierarchy.

Note: This command is used in place of the mount command to mount the global namespace.

Before you can mount the global namespace, you must have a virtual client running on the client system. To create the virtual client, use the stfsclient –create command.

Remounting the global namespace image is not the same as unmounting the global namespace and then mounting it again. Rather, it changes the attributes of an existing global namespace image, such as changing from read-write to read-only mode. To remount the global namespace image or to see what global namespace images currently exist, use the stfsmount command.

To unmount the global namespace, use the stfsumount command.

Example

Mount the global namespace The following example mounts the global namespace:
stfsmount mnt/SANFS_MOUNTPT -fstypename sanfs

Parent topic: AIX-client commands

Related reference
rmstclient
stfsclient
stfsdriver
stfsdisk
stfsumount

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.