Other xfsm Dialogs
Prev | Chapter 3. xfsm | Next

## Other xfsm Dialogs

The following sections detail all `xfsm` dialogs except the Create File System dialog, which is described in “Create File System Dialog”. The following dialogs are covered:

- “xfsm Search For Filesystems Dialog”.

- “xfsm Volume/Partition Search Dialog”.

- “xfsm Mount Dialog”

- “xfsm Delete Filesystems Dialog”.

- “The xfsm Export Filesystems Dialog”.

- “xfsm Unmount Filesystems Dialog”

- “xfsm Unexport Filesystems Dialog”

- “xfsm File System Information Dialog”.

### xfsm Search For Filesystems Dialog

The Search For File Systems dialog allows you to select the host system for the display area and the types of filesystems that are displayed. The filesystems of the types selected on the host you select are displayed in the display area. The dialog is similar to that shown in Figure 3-10:

Figure 3-10. The xfsm Search For Filesystems Dialog

There is a pulldown menu called the Host List that is activated by clicking the arrow button to the right of the Host Name field. By default, the Host List section of the window lists all hosts in the `/etc/hosts` database of the system that launched this instance of `xfsm`. You can select an alternate host list by setting the X11 resource hostsFile to point to an alternate file that contains entries of the same format as the `/etc/hosts` file. An alternate host list is a useful feature if you have a long `/etc/hosts` file and only a few systems running the XFS Manager software. You can set this resource with any of the following actions:

- Specify the resource on the command line. For example:

      xfsm -xrm “*hostsFile: /usr/tmp/my_hosts_file”

- Place the following entry in your `~/.Xdefaults` file:

      Xfsm*hostsFile: /usr/tmp/my_hosts_file

- Create a personal resource file in your home directory. For `xfsm`, the file should be called `Xfsm`, and it should contain the line:

      *hostsFile: /usr/tmp/my_hosts_file

When you see the host list in the dialog window, you can use the slider on the right to scroll through the list. The Selection field allows you to enter the name of the desired host, or you can fill the field by clicking on a host name from the Host List.

At the bottom of the window are three buttons:

OK |  | This button selects the host in the Selection field.
Cancel |  | This button dismisses the window without selecting a new host.
Help |  | This button displays this help topic.

The following fields and buttons are used:

Host Name |  | This is a text entry field for you to enter the selected hostname, and a button with a down arrow immediately to the right of the text entry field. If you click the down-arrow button, you see a list that contains an entry for each host found in the `/etc/hosts` file on the system on which the `xfsm` application was launched. To select a host, you may either click on an item from the host list or directly type in the name of a host.
Name Matches |  | This is a text field in which to enter a `glob` text pattern to match against the names of the discovered filesystems. Only those filesystem names matching the pattern are displayed in the icon panel. An empty pattern matches all object names. For more information on `glob` expressions, see the `glob` reference page.
Type Matches |  | This is a group of toggle buttons allowing you to specify which type(s) of objects are to be displayed in the main window icon panel. Any File System Type - If checked, all filesystem types are included in the search. EFS - If checked, EFS filesystems are included in the search. XFS - If checked, XFS filesystems are included in the search. NFS - If checked, NFS filesystems are included in the search.
Flush Cache |  | When a search for filesystems is executed on a given host, all filesystems are retrieved and placed in a cache. Subsequent searches on that host use the cache rather than requesting a new list of objects from the host. If this toggle button is selected, the cache is emptied and a new list is retrieved from the host.

### xfsm Volume/Partition Search Dialog

The Volume/Partition Search dialog allows you to search for partitions or logical volumes on the selected host. You may specialize your search through a `glob` regular expression. For more information on `glob` expressions, see the `glob` reference page. The Volume/Partition Search Dialog is shown in Figure 3-11:

Figure 3-11. xfsm Volume/Partition Search Dialog

At the bottom of the dialog are four buttons:

Accept |  | Collects the search criteria from the dialog, executes the search, and dismisses the dialog.
Apply |  | Collects the search criteria from the dialog and executes the search, leaving the dialog on-screen.
Cancel |  | Dismisses the dialog without conducting any search. All information in the dialog is discarded.
Help |  | Displays this help topic.

The following fields are used. If no criteria are selected, the Accept and Apply buttons are greyed-out and not usable:

Type Matches |  | This group of toggle buttons is available only during a partition search. These buttons allow you to specify which type(s) of partitions are to be returned from the search. If the Type Matches toggle button is not selected, all partition types are matched.
Name Matches |  | This field is a toggle button and text field in which to enter a `glob` expression to use as a search pattern for logical volumes or partitions. Only those volume or partition names matching the pattern are returned from the search. If the Name Matches toggle button is not selected, all volume or partition names are matched. For more information on `glob` expressions, see the `glob` reference page.
Size is |  | This button allows you to limit the volumes or partitions returned from the search by using the size of the volume or partition as a search factor. The size is always interpreted in megabytes. The following options are available from the selection button to the right of the Size is button: = (equal) - Only those volumes/partitions that are of the exact size specified are returned. > (greater than) - Only those volumes/partitions that are greater than the size specified are returned. < (less than) - Only those volumes/partitions that are less than the size specified are returned. Enter the size, in megabytes, of the partitions or volumes you wish to search for in the text field to the right of this button.
Flush Cache |  | When a search is executed on a given host, all volumes or partitions on the host are retrieved and placed in a cache. Subsequent searches on that host use the cache rather than requesting a new list of volumes or partitions from that host. If this toggle button is selected, the cache is discarded and a new list is retrieved from the host.

### xfsm Mount Dialog

The Mount dialog appears when you select the “ Mount” option from the Selected menu. This dialog is used to set up mount instructions to place a filesystem in your directory hierarchy. The Mount dialog is shown in Figure 3-12:

Figure 3-12. xfsm Mount Dialog

At the bottom of the dialog are four buttons:

Accept |  | Collects the parameters from the dialog, executes the mount operation, then dismisses the dialog.
Apply |  | Collects the parameters from the dialog and executes the mount operation, leaving the dialog on-screen.
Cancel |  | Dismisses the dialog without taking any action. All information in the dialog is discarded.
Help |  | Displays this help topic.

The following fields and buttons are used:

Host Name |  | This label displays the name of the current host.
Mount Type |  | This field is a set of three radio buttons that indicate the type of filesystem being mounted. The options are: XFS EFS NFS
File System |  | This is a text field in which you enter the name of the filesystem to be mounted. If you click the down-arrow button on the right of the field, you see a list of unmounted filesystems. Clicking a name from this list places the filesystem name in the text field. Each item in the list has two fields. The first field indicates the filesystem name. The second field, which is in parentheses, is the mount point for that filesystem. If the mount point cannot be determined the field displays a dash (-). When a filesystem is chosen from this list, the Mount Point field is automatically filled in.
Remote Host |  | If the NFS type of filesystem has been selected in the Mount Type field, a text field is added to specify the remote host from which the filesystem is mounted. If you click the button at the right of the text field, you see a list of known hosts. Clicking a host name in this list places the hostname in the text field. When a hostname is selected from the list, the application retrieves the list of exported filesystems from that host and puts them in the File System field. This field is visible only when the Mount Type is set to NFS.
Mount Point |  | This is a text field in which to enter the mount point directory pathname and some buttons and text fields to specify mounting instructions for the new filesystem. See “Mount Point and Mount Information” for complete information on these buttons and fields.
Update /etc/fstab |  | A toggle button that indicates that the `/etc/fstab` file should be updated with the information from the dialog.

#### The Mount Dialog Advanced Options

These options are the same as those found in the Desktop “NFS Mount Manager.” When you click the Advanced Options button of the Mount dialog, the following options are displayed, as shown in Figure 3-13:

Figure 3-13. xfsm Mount Dialog Advanced Options

The Mount dialog advanced options are:

Read |  | This button indicates the filesystem is readable.
Write |  | This button indicates the filesystem is writable.
Automatically mount at startup |  | This button indicates that the filesystem should be mounted whenever a `mount -a` command is issued by root.
Use parent group id when creating files |  | This button indicates that files created within this filesystem receive the group ID of their parent directory rather than the group ID of the creating process.
'setuid' execution not allowed for non super-users |  | This button indicates that `setuid' execution is not allowed for non-superusers (root).
Disallow access to character and block special files |  | This button indicates that users are not allowed to read or list character and block special device files for this filesystem.
Use local file and record locking |  | This button indicates that the system should use local file and record locking instead of a remote lock manager. This minimizes delayed write flushing. This option is provided mainly for the convenience of diskless clients.
Allow accesses to be interrupted by select signals |  | This button indicates that the system should allow filesystem access to be interrupted before completion on the receipt of certain signals from the kernel. The following signals are honored: SIGHUP, SIGINT, SIGQUIT, SIGKILL, SIGTERM and SIGTSTP. This feature is off by default.
If the first mount attempt fails, retry in the background |  | This button indicates that if the mount attempt fails, that is, if the filesystem cannot be read by the local host or if the mount directory has been removed, the system should display an error message to the console and system log and continue attempting to mount the filesystem in the background.
Retry request until server responds |  | This button indicates that if the remote host does not respond when the local host attempts to mount the filesystem or access files, the request should be repeated until the server responds.
Allow attribute caching |  | Default values are provided in all numeric input fields. If a value is present in the “Set all minimum and maximum...” field, this value overrides all defaults in the four related fields. Set the regular file minimum attribute cache timeout (in seconds) to the given number. Set the regular file maximum attribute cache timeout (in seconds) to the given number. Set the directory file minimum attribute cache timeout (in seconds) to the given number. Set the directory file maximum attribute cache timeout (in seconds) to the given number. Set all minimum and maximum attribute cache timeouts (in seconds) to the given number.
Read Buffer Size |  | This numeric input field changes the read buffer to the specified size in bytes. A default value is provided.
Write Buffer Size |  | This numeric input field changes the write buffer to the specified size in bytes. A default value is provided.
Set number of mount fail retries to |  | This numeric input field sets the number of times to retry a failed mount operation. A default value is provided.
Set NFS timeout to (tenths of a second) |  | This numeric input field specifies, in tenths of a second, the time to wait before timing out on an NFS request. A default value is provided.
Set number of NFS retransmissions to |  | This numeric input field specifies the number of times failed NFS operations are to be retried. A default value is provided.
Set server UDP port number to |  | This numeric input field specifies an alternate UDP port number for NFS on the NFS server. A default value is provided.

### xfsm Delete Filesystems Dialog

This dialog appears when you select the “ Remove” option from the Selected Menu. It allows you to remove filesystems from the current host. The dialog is shown in Figure 3-14:

Figure 3-14. xfsm Delete Filesystems Dialog

The following buttons are used with the Delete Filesystems Dialog:

`Yes` |  | Deletes the selected filesystems and dismisses the dialog.
No |  | No action is taken and the dialog is dismissed.
Help |  | Displays this help topic.

The following fields are used:

Filesystem name |  | If one filesystem has been selected for removal, this label displays the name of the filesystem. If more than one filesystem has been selected, this label lists the names of all filesystems to be removed.
Force unmount |  | This button indicates that the filesystem or systems selected should be unmounted even if currently in use.
Remove entry from /etc/fstab |  | This button indicates that the `/etc/fstab` entry for the filesystem or systems should be deleted.
Remove entry from /etc/exports |  | This button indicates that the `/etc/exports` entry for the filesystem or systems should be deleted.

### The xfsm Export Filesystems Dialog

The Export Filesystems dialog appears when you select the “ Export” option from the Selected menu. It allows you to set the export options for a filesystem and then export the filesystem. The dialog window is shown in Figure 3-15:

Figure 3-15. xfsm Export Dialog

The following buttons are used:

Accept |  | Collects the information from the dialog, exports the filesystem, and dismisses the dialog.
Reset |  | Restores the values in the dialog to the last committed values for the given filesystem.
Cancel |  | No action is taken and the dialog is dismissed.
Help |  | Displays this help topic.

This dialog includes all the fields in the Advanced Options: Export panel of the Create File System dialog. For a discussion of those fields, see “Export Advanced Options” (page 45). This dialog has the following additional fields:

Host Name |  | This is a label that displays the name of the currently selected host.
File System |  | This is a text field in which you enter the name of the filesystem to be exported. If you click on the button on the right of the field, you see a list of unexported filesystems. Clicking a name from this list places the filesystem name in the text field.

### xfsm Unmount Filesystems Dialog

The Unmount Filesystems dialog appears when you select the “ Unmount” option from the Selected menu. It allows you to unmount a selected filesystem from the host system's directory hierarchy. The Unmount Filesystems dialog is shown in Figure 3-16:

Figure 3-16. xfsm Unmount Filesystems Dialog

The following buttons are provided at the bottom of the dialog for basic operations.

Yes |  | Unmounts the selected filesystem or systems and dismisses the dialog.
No |  | No action is taken and the dialog is dismissed.
Help |  | Displays this help topic.

The following fields are used:

Filesystem name |  | If one filesystem has been selected for unmount, this label displays the name of the filesystem. If more than one filesystem has been selected, this label lists the names of all filesystems to be unmounted.
Force unmount |  | This button indicates that the selected filesystem or systems should be unmounted even if currently in use.

### xfsm Unexport Filesystems Dialog

The Unexport Filesystems dialog appears when you select the “ Unexport” option from the Selected menu. This dialog appears in two different formats, depending on the state of the icon panel. The standard version of the dialog appears if one or more filesystems are selected in the icon panel. If no filesystems are selected in the icon panel, the alternate dialog appears. The reason for the difference is that directories can be exported as well as whole filesystems, but exported directories have no icon that you can select in the icon panel. This dialog allows you to unexport directories as well as filesystems.

If you have a filesystem or systems selected in the `xfsm` icon panel and you choose the “ Unexport” option from the Selected menu, you see the dialog shown in Figure 3-17:

Figure 3-17. The xfsm Unexport File System Dialog

The following buttons are provided along the bottom of the dialog for basic operations:

Yes |  | Unexports the selected filesystem or systems and dismisses the dialog.
No |  | No action is taken and the dialog is dismissed.
Help |  | Displays this help topic.

The following fields are used:

Filesystem name |  | If one filesystem has been selected for unexport, this label displays the name of the filesystem. If more than one filesystem has been selected, this label lists the names of all filesystems to be unexported.
Remove entry from /etc/exports |  | This button indicates that the `/etc/exports` entry for the selected filesystem or systems should be deleted.

#### Unexport Directory Dialog

If you have no filesystem selected in the `xfsm` icon panel and you choose the “ Unexport” option from the Selected menu, you see the dialog shown in Figure 3-18:

Figure 3-18. xfsm Unexport Directory Dialog

The following buttons are provided along the bottom of the dialog for basic operations.

Accept |  | Collects the information from the dialog, executes the unexport, and dismisses the dialog.
Apply |  | Collects the information from the dialog and executes the unexport, leaving the dialog window on-screen.
Cancel |  | Dismisses the dialog. No action is taken.
Help |  | Displays this help topic

The following fields are used:

Host Name |  | This label displays the name of the current host.
Filesystem |  | This is a text field in which you enter the pathname of the directory on the current host to be unexported. If you click on the button on the right of the field, you see a list of exported directories and filesystems. Clicking a name from this list places the name in the text field.
Remove entry from /etc/exports |  | This button indicates that the /etc/exports entry for the directory should be deleted.

### xfsm File System Information Dialog

The File System Information dialog appears when you select the “ Get Info” option from the Selected menu. This dialog displays pertinent information about the selected filesystem or systems. A sample dialog is shown in Figure 3-19:

Figure 3-19. xfsm File System Information Dialog

The following items are displayed:

Mount Point |  | The directory where the filesystem is mounted
File System |  | The pathname of the filesystem device special file.
Type |  | The type of filesystem.
Mount Options |  | The options specified for use when mounting this filesystem. See the fstab(4) reference page for further information.
Fsck Pass |  | The pass number used during parallel `fsck`(1M) execution.
Dump Freq The dump frequency (in days) for backup purposes. |  |

Prev | Table of Contents | Next
Create File System Dialog |  | Chapter 4. xlvm