stfsdriver

Loads the file-system driver as a kernel extension.

Read syntax diagramSkip visual syntax diagram
>>-stfsdriver--+---------------------------------+-------------->
               +- -load--+---------------------+-+
               |         +- -fstypename--name--+ |
               |         '- -fstypenum--number-' |
               +- -unload------------------------+
               '- -query-------------------------'

>--+-------------+---------------------------------------------->
   '- -debuginit-'

>--+-----------------------------------------+------------------>
   '- -tracefile--file_name--+-------------+-'
                             '- -synctrace-'

>--driver_file_name--------------------------------------------><

Parameters

–load
Loads the kernel extension and create an instance of the file-system driver.
–unload
Unloads the kernel extension and destroys the instance of the file-system driver.
–query
Displays information about the kernel extension matching the specified criteria. For example, you can query the kernel extension ID to use in commands instead of the kernel module name.
–fstypename name
Specifies the name of the file-system type to use for the file-system-driver instance. 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 will use this name to create the virtual client.

–fstypenum number
Identifies the number associated with 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.

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

Restriction: Do not specify the number 1, 3, 16, an any already loaded file-system type number, or a number greater than 39.
–debuginit
Enables the file-system driver to issue diagnostic messages of the CONFIG class. Messages in this class are issued only during initialization.

If specified, the file-system driver does not issue diagnostic messages. You can turn the messages on after the file-system driver is running using the stfsdebug command.

Note: This parameter is intended for use only by trained service technicians.
–tracefile file_name
Specifies that the file-system driver is to write diagnostic information to the specified file.
Note: The specified file must already exist.
–synctrace
Specifies that the file-system drive is to write diagnostic information to the specified trace file synchronously rather than using buffered writes.
driver_file_name
Specifies the name and location of the file-system driver that you want to load, unload, or query. The file name is typically "sanfs".

The file-system driver is loaded as a kernel extension. To identify the instance of the file-system drive, you identify the kernel extension. The kernel-extension name is the same as name and location of the file-system driver that was used to load the driver (for example, /usr/tank/client/bin/sanfs).

Prerequisites

You must have root privileges to use this command.

Description

This command creates a file-system-driver instance by loading the file-system driver as a kernel extension. This command also unloads or queries the kernel extension.

After loading the file-system driver, you can use the stfsclient command to create a virtual client and then use the stfsmount command to mount the global namespace.

Example

Loads the file-system driver The following example loads the file-system driver on a client for AIX®:
stfsdriver -load /usr/tank/client/bin/sanfs

Parent topic: AIX-client commands

Related reference
rmstclient
stfsclient
stfsdisk
stfsmount
stfsumount

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