Print this page
Marcel's code review fixes
Marcel's update to 7651
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/sharectl.1m.man.txt
+++ new/usr/src/man/man1m/sharectl.1m.man.txt
1 1 SHARECTL(1M) Maintenance Commands SHARECTL(1M)
2 2
3 3 NAME
4 4 sharectl - configure and manage file sharing services
5 5
6 6 SYNOPSIS
7 7 sharectl subcommand [-h]
8 8 sharectl delsect section protocol
9 9 sharectl get [-p property]... protocol
10 10 sharectl set {-p property=value}... protocol
11 11 sharectl status [protocol]
12 12
13 13 DESCRIPTION
14 14 The sharectl command operates on file sharing services. The command sets
15 15 the client and server operational properties, takes and restores
16 16 configuration snapshots, and gets status of the protocol service.
17 17 Currently supported services are autofs(4), nfs(4), smb(4) and smbfs.
18 18
19 19 The set subcommand requires root privileges or that you assume the
20 20 Primary Administrator role.
21 21
22 22 A non-privileged user can change the persistent settings when granted
23 23 required authorizations, see appropriate sharing protocol man page.
24 24
25 25 Options
26 26 The following options are supported where applicable:
27 27
28 28 -h Displays usage message. Supported for all subcommands.
29 29
30 30 -p property[=value]
31 31 Specifies a property. See Subcommands, below.
32 32
33 33 Subcommands
34 34 sharectl supports the subcommands described below:
35 35
36 36 sharectl delsect section protocol
37 37 Delete configuration section for the specified protocol.
38 38 Currently only protocol that has configuration sections is smbfs
39 39 (see nsmbrc(4) and EXAMPLES).
40 40
41 41 sharectl get [-p property]... protocol
42 42 Get the property values for the specified protocol. If no -p
43 43 option is provided, get all the properties for the specified
44 44 protocol. For NFS, properties correspond to entries in the
45 45 /etc/default/nfs file. See nfs(4).
46 46
47 47 sharectl set {-p property=value}... protocol
48 48 Set properties for the specified file sharing protocol.
49 49
50 50 sharectl status [protocol]
51 51 Display status of the specified protocol, or, if no protocol is
52 52 specified, of all file sharing protocols.
53 53
54 54 FILES
55 55 /usr/include/libshare.h
56 56 Error codes used for exit status.
57 57
58 58 EXIT STATUS
59 59 0 Successful completion.
60 60
61 61 non-zero
62 62 Command failed.
63 63
64 64 EXAMPLES
65 65 Example 1 Setting a Property
|
↓ open down ↓ |
65 lines elided |
↑ open up ↑ |
66 66 The following command sets the minimum version of the server NFS
67 67 protocol to version 3.
68 68
69 69 # sharectl -p server_versmin=3 nfs
70 70
71 71 Example 2 Getting Properties
72 72 The following command gets the properties for the NFS protocol.
73 73
74 74 # sharectl get nfs
75 75 lockd_listen_backlog=32
76 - lockd_servers=20
76 + lockd_servers=256
77 77 lockd_retransmit_timeout=5
78 78 grace_period=90
79 79 nfsmapid_domain=sun.com
80 - servers=16
80 + servers=1024
81 81 server_versmin=2
82 82 server_versmax=4
83 83 max_connections=-1
84 84
85 85 The following command gets the value of the grace_period property
86 86 for the NFS protocol.
87 87
88 88 # sharectl get -p grace_period nfs
89 89 grace_period=90
90 90
91 91 Example 3 Obtaining Status
92 92 The following command obtains the status of all file-sharing
93 93 protocols on a system.
94 94
95 95 # sharectl status
96 96 nfs enabled
97 97
98 98 Example 4 Configuring Global Settings
99 99 The following command shows how an authorized user can use
100 100 sharectl commands to configure global settings for the ex.com
101 101 environment in the service management facility (SMF). See
102 102 nsmbrc(4) for a description of the example environment, ex.com.
103 103 See smf(5) for a description of the SMF.
104 104
105 105 # sharectl set -p section=default -p workgroup=SALES \
106 106 -p timeout=5 smbfs
107 107 # sharectl set -p section=FSERVER -p addr=fserv.ex.com smbfs
108 108 # sharectl set -p section=RSERVER -p workgroup=REMGROUP \
109 109 -p addr=rserv.ex.com smbfs
110 110 # sharectl set -p section=RSERVER:george -p timeout=30 smbfs
111 111 # sharectl set -p section="SSERV:*:POKY" -p addr=sserv.ex.com \
112 112 -p timeout=25 smbfs
113 113
114 114 Example 5 Displaying Current Settings
115 115 The following command shows how an authorized user can use the
116 116 sharectl get command to view the global settings for smbfs in the
117 117 SMF. The values shown are those set by the previous example.
118 118
119 119 # sharectl get smbfs
120 120 [default]
121 121 workgroup=SALES
122 122 timeout=5
123 123 [FSERVER]
124 124 addr=fserv.ex.com
125 125 [RSERVER]
126 126 workgroup=REMGROUP
127 127 addr=rserv.ex.com
128 128 [RSERVER:george]
129 129 timeout=30
130 130 [SSERV:*:POKY]
|
↓ open down ↓ |
40 lines elided |
↑ open up ↑ |
131 131 addr=sserv.ex.com
132 132 timeout=25
133 133
134 134 INTERFACE STABILITY
135 135 Committed
136 136
137 137 SEE ALSO
138 138 sharemgr(1M), autofs(4), nfs(4), nsmbrc(4), smb(4), user_attr(4),
139 139 attributes(5), rbac(5), smf(5), standards(5)
140 140
141 -illumos March 1, 2016 illumos
141 +illumos December 16, 2016 illumos
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX