Solaris Express Reference Manual Collection >> man pages section 1M: System Administration Commands >> System Administration Commands - Part 2 >> sharectl(1M) – configure and manage file sharing service

sharectl(1M)

NAME | Synopsis | Description | Options | Examples | Exit Status | Files | Attributes | See Also

NAME

sharectl – configure and manage file sharing service

Synopsis

sharectl  [-h]

sharectl  status [-h] [protocol]

sharectl  get [-h] [-p property]... protocol

sharectl  set [-h] [-p property=value]... protocol

Description

The sharectl command operates on file-sharing protocols, such as NFS. The command sets the client and server operational properties, takes and restores configuration snapshots, and gets status of the protocol service.

The get and set subcommands (see below) require root privileges or that you assume the Primary Administrator role.

Options

The following options are supported:

-h

Displays usage message.

-p property[=value]

Specifies a property. See “Subcommands,” below.

Subcommands

sharectl supports the subcommands described below. The form of a sharectl command is:

# sharectl subcommand [option]

get [-p property] protocol

Get the property values for the specified protocol. If no -p option is provided, get all the properties for the specified protocol. For NFS, properties correspond to entries in the /etc/default/nfs file. See nfs(4).

set [-p property=value]... protocol

Set properties for the specified file sharing protocol.

status [protocol]

Display status of the specified protocol, or, if no protocol is specified, of all file-sharing protocols.

Examples

---

Example 1 Setting a Property




The following command sets the minimum version of the server NFS protocol to version 3.

% sharectl -p server_versmin=3 nfs

---

---

Example 2 Getting Properties




The following command gets the properties for the NFS protocol.

% sharectl get nfs lockd_listen_backlog=32 lockd_servers=20 lockd_retransmit_timeout=5 grace_period=90 nfsmapid_domain=sun.com servers=16 server_versmin=2 server_versmax=4 max_connections=-1

The following command gets the value of the grace_period property for the NFS protocol.

% sharectl get -p grace_period nfs grace_period=90

---

---

Example 3 Obtaining Status




The following command obtains the status of all file-sharing protocols on a system.

% sharectl status nfs enabled

---

Exit Status

0

Successful completion.

non-zero

Command failed.

Files

/usr/include/libshare.h

Error codes used for exit status.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu
Interface Stability	Evolving

See Also

sharemgr(1M), nfs(4), attributes(5), smf(5), standards(5)

NAME | Synopsis | Description | Options | Examples | Exit Status | Files | Attributes | See Also