share_nfs.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

share_nfs(1M) share_nfs(1M)

NAME

share_nfs: share - make local NFS ﬁle systems available for mounting by remote systems

SYNOPSIS

/sbin/fs/nfs/share

[-d description ][-F nfs

][-o speciﬁc_options ] pathname

DESCRIPTION

The

share utility makes local ﬁle systems available for mounting by remote systems.

If no argument is speciﬁed, then

share displays all ﬁle systems currently shared, including NFS ﬁle sys-

tems and ﬁle systems shared through other distributed ﬁle system packages.

Options

The following options are supported:

-d description

Provide a comment that describes the ﬁle system to be shared.

-F nfs

Share NFS ﬁle system type.

-o specific_options

Specify speciﬁc_options in a comma-separated list of keywords and attribute-value-assertions for

interpretation by the ﬁle-system-type-speciﬁc command. If speciﬁc_options is not speciﬁed, then

by default sharing will be read-write to all clients. speciﬁc_options can be any combination of the

following:

async All NFS Protocol Version 2 mounts will be asynchronous. This option is ignored for

NFS PV3. Specifying async increases write performance on the NFS server by

causing asynchronous writes on the NFS server. The async option can be speciﬁed

anywhere on the command line after directory. Before using this option, refer to

APPLICATION USAGE section below.

anon=uid Set uid to be the effective user ID of unknown users. By default, unknown users

are given the effective user ID UID_NOBODY.Ifuid is set to -1

, access is denied.

fsid=num Force the ﬁle system identiﬁcation portion of the ﬁle handle to be num instead of a

number derived from the major and minor number of the block device on which the

ﬁle system is mounted. A value between 1 and 32767 may be used, but it must be

unique among the shared ﬁle systems.

This option is useful for NFS failover to ensure that both servers of the failover pair

use the same NFS ﬁle handles for the shared ﬁle systems. This avoids stale ﬁle

handles if a failover occurs.

index=file Load ﬁle rather than a listing of the directory containing this ﬁle when the directory

is referenced by an NFS URL.

log[=tag] Enables NFS server logging for the speciﬁed ﬁle system. The optional tag deter-

mines the location of the related log ﬁles. The tag is deﬁned in

/etc/nfs/nfslog.conf.Ifnotag is speciﬁed, the default values associated

with the "global" tag in /etc/nfs/nfslog.conf will be used.

nosub Prevents clients from mounting subdirectories of shared directories. For example, if

/export is shared with the nosub option on server fooey, then a NFS client will

not be able to do:

mount -F nfs fooey:/export/home/mnt

nosuid By default, clients are allowed to create ﬁles on the shared ﬁle system with the

setuid or setgid mode enabled. Specifying nosuid causes the server ﬁle sys-

tem to silently ignore any attempt to enable the setuid or setgid mode bits.

public Moves the location of the public ﬁle handle from root (/) to the exported directory

for Web NFS-enabled browsers and clients. This option does not enable Web NFS

service; Web NFS is always on. Only one ﬁle system per server may use this option.

All other options, including the refer, ro=access_list , and rw=access_list options

may be included with the public option.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (6 pages)

PAGE 1
share_nfs(1M) share_nfs(1M) NAME share_nfs: share - make local NFS file systems available for mounting by remote systems SYNOPSIS /sbin/fs/nfs/share [-d description ] [-F nfs] [-o specific_options ] pathname DESCRIPTION The share utility makes local file systems available for mounting by remote systems. If no argument is specified, then share displays all file systems currently shared, including NFS file systems and file systems shared through other distributed file system packages.
PAGE 2
share_nfs(1M) share_nfs(1M) refer=path @host[+host][:path @host[+host]] Refer the client accessing the specified shared file system to an alternative location on the provided host. Sharing will be read-only to all clients. ro ro=access_list Sharing will be read-only to the clients listed in access_list ; overrides the rw suboption for the clients specified. See access_list below. root=access_list Only root users from the hosts specified in access_list will have root access. See access_list below.
PAGE 3
share_nfs(1M) share_nfs(1M) services like NIS cannot be used to resolve hostnames on the server, because when mapping an IP address to a hostname they do not return domain information. For example, NIS 129.144.45.9 --> "myhost" DNS or LDAP 129.144.45.9 --> "myhost.mydomain.mycompany.com" The domain name suffix is distinguished from hostnames and netgroups by a prefixed dot. For example, rw=.mydomain.mycompany.com A single dot can be used to match a hostname with no suffix. For example, rw=.
PAGE 4
share_nfs(1M) share_nfs(1M) APPLICATION USAGE If the async option is used, an unreported data loss may occur ONLY on a write and ONLY if the NFS server experiences a failure after the write reply has been sent to the client. Specifically, blocks which have been queued for the server’s disk, but have not yet been written to the disk may be lost. You cannot export either a parent directory or a subdirectory of an exported directory that resides within the same file system .
PAGE 5
share_nfs(1M) share_nfs(1M) share -F nfs -o ro=hostb,root=hostb /var The following will give read-write permissions to hostb: share -F nfs -o ro=hosta,rw=hostb,root=hostb /var If the file system being shared is a symbolic link to a valid pathname, the canonical path (the path which the symbolic link follows) will be shared.
PAGE 6
(Notes) A (Notes) sA 6 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010