System Administration Commands                       sharectl(1M)



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 opera-
     tional  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 Manage-
     ment  rights  profile  in  the  /etc/userattr   file.   See
     userattr(4)   and  rbac(5).  An  authorized  user  can  use
     sharectl to set global values for Solaris CIFS  server  pro-
     perties  in  the  Solaris  server  management  facility. See
     smb(4).

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]




SunOS 5.11          Last change: 16 Mar 2009                    1






System Administration Commands                       sharectl(1M)



     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 pro-
         tocol 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 serverversmin=3 nfs



     Example 2 Getting Properties


     The following command gets the properties for the NFS proto-
     col.


       % sharectl get nfs
       lockdlistenbacklog=32
       lockdservers=20
       lockdretransmittimeout=5
       graceperiod=90
       nfsmapiddomain=sun.com
       servers=16
       serverversmin=2
       serverversmax=4
       maxconnections=-1







SunOS 5.11          Last change: 16 Mar 2009                    2






System Administration Commands                       sharectl(1M)



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


       % sharectl get -p graceperiod nfs
       graceperiod=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 \
       -p timeout=5 smbfs
       # sharectl set -p section=FSERVER -p addr=fserv.ex.com smbfs
       # sharectl set -p section=RSERVER -p workgroup=REMGROUP \
       -p addr=rserv.ex.com smbfs
       # sharectl set -p section=RSERVER:george -p timeout=30 smbfs
       # sharectl set -p section="SERV:*:POKY" -p addr=sserv.ex.com \
       -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 pre-
     vious example.


       % # sharectl get smbfs



SunOS 5.11          Last change: 16 Mar 2009                    3






System Administration Commands                       sharectl(1M)



       [default]
       workgroup=SALES
       timeout=5
       [FSERVER]
       addr=fserv.ex.com
       [RSERVER]
       workgroup=REMGROUP
       addr=rserv.ex.com
       [RSERVER:george]
       timeout=30
       [SERV:*:POKY]
       addr=sserv.ex.com
       timeout=25



EXIT STATUS
     0           Successful completion.


     non-zero    Command failed.


FILES
     /usr/include/libshare.h    Error codes used for exit status.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    
     Interface Stability          Committed                   
    


SEE ALSO
     sharemgr(1M),  nfs(4),   nsmbrc(4),   userattr(4),   attri-
     butes(5), rbac(5), smb(4), smf(5), standards(5)










SunOS 5.11          Last change: 16 Mar 2009                    4