te
Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
sharectl - configure and manage file sharing service

sharectl [-h]

sharectl status [-h] [protocol]

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

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

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. A non-privileged user can change the Solaris CIFS client's persistent settings when granted the SMBFS Management rights profile in the /etc/user_attr file. See user_attr(4) and rbac(5). An authorized user can use sharectl to set global values for Solaris CIFS server properties in the Solaris server management facility. See smb(4).

The following options are supported: -h

-p property[=value]

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

# sharectl subcommand [option]

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

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

Example 4 Configuring Global Settings

The following command shows how an authorized user can use sharectl commands to configure global settings for the ex.com environment in the service management facility (SMF). See nsmbrc(4) for a description of the example environment, ex.com. See smf(5) for a description of the SMF.

# sharectl set -p section=default -p workgroup=SALES \e
-p timeout=5 smbfs
# sharectl set -p section=FSERVER -p addr=fserv.ex.com smbfs
# sharectl set -p section=RSERVER -p workgroup=REMGROUP \e
-p addr=rserv.ex.com smbfs
# sharectl set -p section=RSERVER:george -p timeout=30 smbfs
# sharectl set -p section="SSERV:*:POKY" -p addr=sserv.ex.com \e
-p timeout=25 smbfs

Example 5 Displaying Current Settings

The following command shows how an authorized user can use the sharectl get command to view the global settings for smbfs in the SMF. The values shown are those set by the previous example.

% # sharectl get smbfs
[default]
workgroup=SALES
timeout=5
[FSERVER]
addr=fserv.ex.com
[RSERVER]
workgroup=REMGROUP
addr=rserv.ex.com
[RSERVER:george]
timeout=30
[SSERV:*:POKY]
addr=sserv.ex.com
timeout=25

0 non-zero /usr/include/libshare.h

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

ATTRIBUTE TYPE ATTRIBUTE VALUE

Interface Stability Committed

sharemgr(1M), nfs(4), nsmbrc(4), user_attr(4), attributes(5), rbac(5), smb(4), smf(5), standards(5)