Sun Microsystems Documentation
Begin Tab Sub LinksActive Sub LinkView this Book Download this Book

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

SunOS 5.11  Last Revised 11 Sep 2007

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

ContactAbout SunNewsEmploymentSite MapPrivacyTerms of UseTrademarksCopyright Sun Microsystems, Inc.