Adds an export entry, in the form of a UNIX path name, to the
export database for a Network File System (NFS) file system. The
path name is a name that is mapped to one of the following:
o An OpenVMS disk
o A subdirectory on an OpenVMS disk
o A UNIX container file system
Related commands: MAP, REMOVE EXPORT, SET CONFIGURATION MAP, SHOW
EXPORT, SHOW HOST
Applies to: NFS server
Format
ADD EXPORT "/path/name"
/HOST=host
[ /OPTIONS=
{ CASE_BLIND|CASE_SENSITIVE }
[NO]DATA_CONVERSION
[NO]NAME_CONVERSION
[NO]PURGE_VERSIONS
[NO]TYPELESS_DIRECTORIES ]
1 – Restrictions and Tips
This command requires read and write access to the export
database. The following restrictions and instructions apply:
o Do not use wildcards within a UNIX directory specification.
o For each host, define both its host name and any alias names.
o For each entry, use uppercase and lowercase consistently.
o If you remove an export entry and replace the entry using
different options; each client must dismount and remount for
the new options to take effect.
2 – Parameters
"/path/name"
Required.
File system to add to the export database.
Separate directory and subdirectory names with slashes.
If the TYPELESS-DIRECTORIES option is set and the path name is
mapped to an OpenVMS ODS-5 disk volume, omit the file extension
.DIR from the directory name used in the path name. For example,
specify the path name for directory dove.dir;1 as dove, as in the
following command line:
ADD EXPORT "/white/dove"
If TYPELESS_DIRECTORIES is not set (the default is NOTYPELESS_
DIRECTORIES), then specify the path name for directory dove.dir;1
as dove.dir.
3 – Qualifiers
3.1 /HOST
/HOST=host
Required.
The NFS client host or hosts that will have access to the
specified NFS file system.
You can use a wildcard to allow access to all hosts.
3.2 /OPTIONS
/OPTIONS= { { CASE_BLIND|CASE_SENSITIVE } |[NO]DATA_CONVERSION
|[NO]NAME_CONVERSION |[NO]PURGE_VERSIONS |[NO]TYPELESS_
DIRECTORIES }
Optional.
NOTE
For clients operating in OpenVMS to OpenVMS mode, the
server ignores the options in the export record and uses
the settings required for OpenVMS to OpenVMS mode.
Options for the specified directory:
o CASE_BLIND, CASE_SENSITIVE
- CASE_BLIND (default)
The NFS server ignores the case of file names when looking
up files.
- CASE_SENSITIVE
The NFS server is case-sensitive when looking up files.
For example, NFS would preserve the case in the file names
AaBBc.TXT and AABBC.TXT, regarding them as two different
files.
o DATA_CONVERSION, NODATA_CONVERSION
- DATA_CONVERSION (default)
Converts the following kinds of sequential files:
* Variable
* Variable with fixed-length control (VFC)
* Fixed-record formats
Converts sequential files according to the rules applied by
the following record attributes:
* Carriage return/carriage control (CR)
* Fortran carriage control (FTN)
* Print file-format control (PRN)
Stream formats are returned unconverted.
The data in files with nonstream records cannot be written
back to the file.
- NODATA_CONVERSION
File data is considered raw and is returned without
conversion. Nonstream records are returned with their
record control information mixed with the record data.
Files can be rewritten randomly.
o NAME_CONVERSION, NONAME_CONVERSION
- NAME_CONVERSION
A non-OpenVMS client can create files with mixed-case
names and names containing characters that are invalid
for OpenVMS file names. The server converts such names to
valid OpenVMS file names, and reverses the conversion when
displaying the file names to a non-OpenVMS client.
- NONAME_CONVERSION (default)
Clients can only create files with valid OpenVMS names.
The server performs case-insensitive lookups and displays
directories in lowercase.
o PURGE_VERSIONS, NOPURGE_VERSIONS
Default: NOPURGE_VERSIONS
Deletes multiple versions of files. (The NFS CREATE and RENAME
calls can create multiple versions. The NFS READDIR call can
sense multiple versions.)
o TYPELESS_DIRECTORIES, NOTYPELESS_DIRECTORIES
- TYPELESS_DIRECTORIES
Removes .dir.1 from the name of directories. A naming
conflict could arise if, for example, two files exist in
the parent directory:
DOVE.;1 (regular file)
DOVE.DIR;1 (directory file)
The name of the regular file is returned as dove., rather
than dove, if a file and a conflicting directory exist.
- NOTYPELESS_DIRECTORIES (default)
Returns names as file.ext and file.dir.
4 – Examples
1.TCPIP> ADD EXPORT "/gold/finch" /HOST=GOLD
Adds the name of UNIX directory /gold/finch to the export
database and gives NFS client users on the remote host gold
access to this directory.
2.TCPIP> ADD EXPORT "/gold/finch" /HOST=(PURPLE,FINCH)
Adds the directory /gold/finch to the export database and gives
NFS client users on multiple remote hosts (PURPLE and FINCH)
access to this directory.