Changeset 988 for vendor/current/docs-xml/manpages
- Timestamp:
- Nov 24, 2016, 1:14:11 PM (9 years ago)
- Location:
- vendor/current/docs-xml/manpages
- Files:
-
- 22 added
- 9 deleted
- 73 edited
- 1 moved
Legend:
- Unmodified
- Added
- Removed
-
vendor/current/docs-xml/manpages/dbwrap_tool.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 20 20 <cmdsynopsis> 21 21 <command>dbwrap_tool</command> 22 <arg choice="opt">--persistent</arg> 23 <arg choice="opt">--non-persistent</arg> 24 <arg choice="opt">-d <debug level></arg> 25 <arg choice="opt">-s <config file></arg> 26 <arg choice="opt">-l <log file base></arg> 27 <arg choice="opt">-V</arg> 28 <arg choice="opt">--option=<name>=<value></arg> 22 29 <arg choice="req"><database></arg> 23 30 <arg choice="req"><operation></arg> 24 31 <arg choice="opt"><key> 25 32 <arg choice="opt"><type> 26 <arg choice="opt"><value></arg> 27 </arg> 28 </arg> 33 <arg choice="opt"><value></arg></arg></arg> 29 34 </cmdsynopsis> 30 35 </refsynopsisdiv> … … 44 49 <listitem><para>store: create or modify a record</para></listitem> 45 50 <listitem><para>delete: remove a record</para></listitem> 51 <listitem><para>exists: test for existence of a record</para></listitem> 46 52 <listitem><para>erase: remove all records</para></listitem> 47 53 <listitem><para>listkeys: list all available records</para></listitem> 54 <listitem><para>listwatchers: list processes, which are waiting for changes in a record</para></listitem> 48 55 </itemizedlist> 49 56 </para> … … 53 60 <listitem><para>uint32: unsigned 32bit integer</para></listitem> 54 61 <listitem><para>string: "hello world"</para></listitem> 62 <listitem><para>hex: hex strings like "68656C6C6F20776F726C6400" ("hello world")</para></listitem> 55 63 </itemizedlist> 56 64 </para> … … 60 68 <title>OPTIONS</title> 61 69 62 <para>None.</para> 70 <variablelist> 71 <varlistentry> 72 <term>--persistent</term> 73 <listitem><para>Open the database as a persistent database. 74 </para> 75 <para> 76 Exactly one of --persistent and --non-persistent must be 77 specified. 78 </para></listitem> 79 </varlistentry> 80 <varlistentry> 81 <term>--non-persistent</term> 82 <listitem><para>Open the database as a non-persistent database. 83 </para> 84 <para> 85 Caveat: opening a database as non-persistent when there 86 is currently no other opener will wipe the database. 87 </para> 88 <para> 89 Exactly one of --persistent and --non-persistent must be 90 specified. 91 </para></listitem> 92 </varlistentry> 93 &popt.common.samba.client; 94 &popt.autohelp; 95 </variablelist> 63 96 </refsect1> 64 97 … … 84 117 </refsect2> 85 118 <refsect2> 119 <title>exists</title> 120 <cmdsynopsis> 121 <command>dbwrap_tool</command> <database> exists <key> 122 </cmdsynopsis> 123 </refsect2> 124 <refsect2> 86 125 <title>erase</title> 87 126 <cmdsynopsis> 88 <command>dbwrap_tool</command> <database> erase 89 </cmdsynopsis> 127 <command>dbwrap_tool</command> <database> erase </cmdsynopsis> 90 128 </refsect2> 91 129 <refsect2> … … 93 131 <cmdsynopsis> 94 132 <command>dbwrap_tool</command> <database> listkeys 133 </cmdsynopsis> 134 </refsect2> 135 <refsect2> 136 <title>listwatchers</title> 137 <cmdsynopsis> 138 <command>dbwrap_tool</command> <database> listwatchers 95 139 </cmdsynopsis> 96 140 </refsect2> … … 101 145 <variablelist> 102 146 <varlistentry><term>List all keys from winbindd_idmap.tdb</term> 103 <listitem><para><command>dbwrap_tool</command> winbindd_idmap.tdb listkeys</para></listitem>147 <listitem><para><command>dbwrap_tool</command> --persistent winbindd_idmap.tdb listkeys</para></listitem> 104 148 </varlistentry> 105 149 <varlistentry><term>Fetch record with key "USER HWM" as uint32</term> 106 <listitem><para><command>dbwrap_tool</command> winbindd_idmap.tdb fetch "USER HWM" uint32</para></listitem>150 <listitem><para><command>dbwrap_tool</command> --persistent winbindd_idmap.tdb fetch "USER HWM" uint32</para></listitem> 107 151 </varlistentry> 108 152 <varlistentry><term>Remove record with key "USER HWM"</term> 109 <listitem><para><command>dbwrap_tool</command> winbindd_idmap.tdb remove "USER HWM"</para></listitem>153 <listitem><para><command>dbwrap_tool</command> --persistent winbindd_idmap.tdb remove "USER HWM"</para></listitem> 110 154 </varlistentry> 111 155 <varlistentry><term>Store and overwrite record "USER HWM" with value 214</term> 112 <listitem><para><command>dbwrap_tool</command> winbindd_idmap.tdb store "USER HWM" uint32 214</para></listitem> 156 <listitem><para>uint32: <command>dbwrap_tool</command> --persistent winbindd_idmap.tdb store "USER HWM" uint32 214</para></listitem> 157 <listitem><para>hex: <command>dbwrap_tool</command> --persistent winbindd_idmap.tdb store "USER HWM" hex D6000000</para></listitem> 113 158 </varlistentry> 114 159 </variablelist> -
vendor/current/docs-xml/manpages/eventlogadm.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/findsmb.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/idmap_ad.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 31 31 32 32 <para> 33 Note that the idmap_ad module has changed considerably since34 Samba versions 3.0 and 3.2.35 33 Currently, the <parameter>ad</parameter> backend 36 does not work as the thedefault idmap backend, but one has34 does not work as the default idmap backend, but one has 37 35 to configure it separately for each domain for which one wants 38 36 to use it, using disjoint ranges. One usually needs to configure … … 64 62 </varlistentry> 65 63 <varlistentry> 66 <term>schema_mode = <rfc2307 | sfu ></term>64 <term>schema_mode = <rfc2307 | sfu | sfu20></term> 67 65 <listitem><para> 68 66 Defines the schema that idmap_ad should use when querying … … 70 68 This can be either the RFC2307 schema support included 71 69 in Windows 2003 R2 or the Service for Unix (SFU) schema. 70 For SFU 3.0 or 3.5 please choose "sfu", for SFU 2.0 71 please choose "sfu20". 72 73 Please note that primary group membership is currently always calculated 74 via the "primaryGroupID" LDAP attribute. 72 75 </para></listitem> 73 76 </varlistentry> … … 89 92 <programlisting> 90 93 [global] 94 workgroup = CORP 95 91 96 idmap config * : backend = tdb 92 97 idmap config * : range = 1000000-1999999 -
vendor/current/docs-xml/manpages/idmap_autorid.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 39 39 <variablelist> 40 40 <varlistentry> 41 <term>range = low - high</term> 42 <listitem><para> 43 Defines the available matching uid and gid 44 range for which the backend is 45 authoritative. Note that the range acts as a 46 filter. If algorithmically determined UID or 47 GID fall outside the range, they are ignored 48 and the corresponding map is discarded. It is 49 intended as a way to avoid accidental UID/GID 50 overlaps between local and remotely defined 51 IDs. 52 </para></listitem> 53 </varlistentry> 54 55 <varlistentry> 41 56 <term>rangesize = numberofidsperdomain</term> 42 57 <listitem><para> 43 Defines the available number of uids/gids per domain. The 44 minimum needed value is 2000. SIDs with RIDs larger than this 45 value cannot be mapped, are ignored and the corresponding map 46 is discarded. Choose this value carefully, as this should 47 not be changed after the first ranges for domains have been 48 defined, otherwise mappings between domains will get intermixed 49 leading to unpredictable results. Please note that RIDs in Windows 50 Domains usually start with 500 for builtin users and 1000 51 for regular users. As the parameter cannot be changed later, please 52 plan accordingly for your expected number of users in a domain 53 with safety margins. 58 Defines the number of uids/gids available per 59 domain range. The minimum needed value is 2000. 60 SIDs with RIDs larger than this value will be mapped 61 into extension ranges depending upon number of available 62 ranges. If the autorid backend runs out of available 63 ranges, mapping requests for new domains (or new 64 extension ranges for domains already known) are ignored 65 and the corresponding map is discarded. 54 66 </para> 55 <para>One range will be used for local users and groups. 67 <para> 68 Example: with rangesize set to 10000, users/groups with 69 a RID up to 10000 will be put into the first range for the 70 domain. When attempting to map the an object with a RID 71 of 25000, an extension range will be allocated that 72 will then be used to map all RIDs from 20000-29999. 73 </para> 74 <para>One range will be used for local users and groups and for 75 non-domain well-known SIDs like Everyone (S-1-1-0) or Creator Owner (S-1-3-0). 76 A chosen list of well-known SIDs will be preallocated on first start 77 to create deterministic mappings for those.</para> 78 <para> 56 79 Thus the number of local users and groups that can be created is 57 80 limited by this option as well. If you plan to create a large amount … … 59 82 </para> 60 83 <para>The default value is 100000.</para> 84 </listitem> 85 </varlistentry> 86 <varlistentry> 87 <term>read only = [ yes | no ]</term> 88 <listitem><para>Turn the module into read-only mode. No new ranges will be allocated 89 nor will new mappings be created in the idmap pool. Defaults to no.</para> 90 </listitem> 91 </varlistentry> 92 <varlistentry> 93 <term>ignore builtin = [ yes | no ]</term> 94 <listitem><para>Ignore any mapping requests for the BUILTIN domain. 95 Defaults to no.</para> 61 96 </listitem> 62 97 </varlistentry> … … 69 104 The Unix ID for a RID is calculated this way: 70 105 <programlisting> 71 ID = IDMAP UID LOW VALUE + DOMAINRANGENUMBER * RANGESIZE + RID106 ID = REDUCED RID + IDMAP RANGE LOW VALUE + RANGE NUMBER * RANGE SIZE 72 107 </programlisting> 108 where REDUCED RID = RID % RANGE_SIZE 109 and a DOMAIN RANGE INDEX = RID / RANGE_SIZE is used together with the 110 domain sid to determine the RANGE NUMBER (stored in the database). 73 111 </para> 74 112 <para> … … 76 114 given Unix ID is this: 77 115 <programlisting> 78 RID = ID - IDMAP UID LOW VALUE - DOMAINRANGENUMBER * RANGESIZE116 RID = (ID - LOW ID) % RANGE SIZE + DOMAIN RANGE INDEX * RANGE SIZE 79 117 </programlisting> 118 Where the DOMAIN RANGE INDEX is retrieved from the database along with the 119 domain sid by the RANGE NUMBER = (ID - LOW ID) / RANGE SIZE . 80 120 </para> 81 121 </refsect1> … … 85 125 <para> 86 126 This example shows you the minimal configuration that will 87 work for the principial domain and 19 trusted domains. 127 work for the principal domain and 19 trusted domains / range 128 extensions. 88 129 </para> 89 130 -
vendor/current/docs-xml/manpages/idmap_hash.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/idmap_ldap.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/idmap_nss.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/idmap_rid.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 29 29 domain that should use the idmap_rid backend, using disjoint ranges. 30 30 One usually needs to define a writeable default idmap range, using 31 a backen tlike <parameter>tdb</parameter> or <parameter>ldap</parameter>31 a backend like <parameter>tdb</parameter> or <parameter>ldap</parameter> 32 32 that can create unix ids, in order to be able to map the BUILTIN sids 33 33 and other domains, and also in order to be able to create group mappings. … … 66 66 The default is not to restrict the allowed rids at all, 67 67 i.e. a base_rid value of 0. 68 A good value for the base_rid can be 1000, since user69 RIDs by default start at 1000 (512 hexadecimal).70 68 </para> 71 69 <para> … … 115 113 idmap config TRUSTED : backend = rid 116 114 idmap config TRUSTED : range = 50000 - 99999 117 idmap config TRUSTED : base_rid = 1000118 115 </programlisting> 119 116 </refsect1> -
vendor/current/docs-xml/manpages/idmap_tdb.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/idmap_tdb2.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/libsmbclient.7.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">7</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/lmhosts.5.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">File Formats and Conventions</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/log2pcap.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/net.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 23 23 <command>net</command> 24 24 <arg choice="req"><ads|rap|rpc></arg> 25 <arg choice="opt">-h </arg>26 <arg choice="opt">-w workgroup</arg>27 <arg choice="opt">-W myworkgroup</arg>28 <arg choice="opt">-U user</arg>29 <arg choice="opt">-I ip-address</arg>30 <arg choice="opt">-p port</arg>25 <arg choice="opt">-h|--help</arg> 26 <arg choice="opt">-w|--workgroup workgroup</arg> 27 <arg choice="opt">-W|--myworkgroup myworkgroup</arg> 28 <arg choice="opt">-U|--user user</arg> 29 <arg choice="opt">-I|--ipaddress ip-address</arg> 30 <arg choice="opt">-p|--port port</arg> 31 31 <arg choice="opt">-n myname</arg> 32 32 <arg choice="opt">-s conffile</arg> 33 <arg choice="opt">-S server</arg> 34 <arg choice="opt">-l</arg> 35 <arg choice="opt">-P</arg> 33 <arg choice="opt">-S|--server server</arg> 34 <arg choice="opt">-l|--long</arg> 35 <arg choice="opt">-v|--verbose</arg> 36 <arg choice="opt">-f|--force</arg> 37 <arg choice="opt">-P|--machine-pass</arg> 36 38 <arg choice="opt">-d debuglevel</arg> 37 39 <arg choice="opt">-V</arg> 38 40 <arg choice="opt">--request-timeout seconds</arg> 41 <arg choice="opt">-t|--timeout seconds</arg> 42 <arg choice="opt">-i|--stdin</arg> 43 <arg choice="opt">--tallocreport</arg> 39 44 </cmdsynopsis> 40 45 </refsynopsisdiv> … … 65 70 66 71 <varlistentry> 67 <term>-w target-workgroup</term>72 <term>-w|--workgroup target-workgroup</term> 68 73 <listitem><para> 69 74 Sets target workgroup or domain. You have to specify … … 73 78 74 79 <varlistentry> 75 <term>-W workgroup</term>80 <term>-W|--myworkgroup workgroup</term> 76 81 <listitem><para> 77 82 Sets client workgroup or domain … … 80 85 81 86 <varlistentry> 82 <term>-U user</term>87 <term>-U|--user user</term> 83 88 <listitem><para> 84 89 User name to use … … 87 92 88 93 <varlistentry> 89 <term>-I ip-address</term>94 <term>-I|--ipaddress ip-address</term> 90 95 <listitem><para> 91 96 IP address of target server to use. You have to … … 96 101 97 102 <varlistentry> 98 <term>-p port</term>103 <term>-p|--port port</term> 99 104 <listitem><para> 100 105 Port on the target server to connect to (usually 139 or 445). … … 107 112 108 113 <varlistentry> 109 <term>-S server</term>114 <term>-S|--server server</term> 110 115 <listitem><para> 111 116 Name of target server. You should specify either … … 115 120 116 121 <varlistentry> 117 <term>-l </term>122 <term>-l|--long</term> 118 123 <listitem><para> 119 124 When listing data, give more information on each item. … … 122 127 123 128 <varlistentry> 124 <term>-P</term> 129 <term>-v|--verbose</term> 130 <listitem><para> 131 When listing data, give more verbose information on each item. 132 </para></listitem> 133 </varlistentry> 134 135 <varlistentry> 136 <term>-f|--force</term> 137 <listitem><para> 138 Enforcing a net command. 139 </para></listitem> 140 </varlistentry> 141 142 <varlistentry> 143 <term>-P|--machine-pass</term> 125 144 <listitem><para> 126 145 Make queries to the external server using the machine account of the local server. … … 136 155 </varlistentry> 137 156 138 &stdarg.server.debug; 157 <varlistentry> 158 <term>-t|--timeout 30</term> 159 <listitem><para> 160 Set timeout for client operations to 30 seconds. 161 </para></listitem> 162 </varlistentry> 163 164 <varlistentry> 165 <term>--use-ccache</term> 166 <listitem><para> 167 Try to use the credentials cached by winbind. 168 </para></listitem> 169 </varlistentry> 170 171 <varlistentry> 172 <term>-i|--stdin</term> 173 <listitem><para> 174 Take input for net commands from standard input. 175 </para></listitem> 176 </varlistentry> 177 178 <varlistentry> 179 <term>--tallocreport</term> 180 <listitem><para> 181 Generate a talloc report while processing a net 182 command. 183 </para></listitem> 184 </varlistentry> 185 186 <varlistentry> 187 <term>-T|--test</term> 188 <listitem><para>Only test command sequence, dry-run. 189 </para></listitem> 190 </varlistentry> 191 192 <varlistentry> 193 <term>-F|--flags FLAGS</term> 194 <listitem><para>Pass down integer flags to a net subcommand. 195 </para></listitem> 196 </varlistentry> 197 198 <varlistentry> 199 <term>-C|--comment COMMENT</term> 200 <listitem><para>Pass down a comment string to a net subcommand. 201 </para></listitem> 202 </varlistentry> 203 204 <varlistentry> 205 <term>-n|--myname MYNAME</term> 206 <listitem><para>Use MYNAME as a requester name for a net subcommand. 207 </para></listitem> 208 </varlistentry> 209 210 <varlistentry> 211 <term>-c|--container CONTAINER</term> 212 <listitem><para>Use a specific AD container for net ads operations. 213 </para></listitem> 214 </varlistentry> 215 216 <varlistentry> 217 <term>-M|--maxusers MAXUSERS</term> 218 <listitem><para>Fill in the maxusers field in net rpc share operations. 219 </para></listitem> 220 </varlistentry> 221 222 <varlistentry> 223 <term>-r|--reboot</term> 224 <listitem><para>Reboot a remote machine after a command has been successfully executed (e.g. in remote join operations). 225 </para></listitem> 226 </varlistentry> 227 228 <!-- Options for net rpc vampire --> 229 230 <varlistentry> 231 <term>--force-full-repl</term> 232 <listitem><para> 233 When calling "net rpc vampire keytab" this option 234 enforces a full re-creation of the generated keytab file. 235 </para></listitem> 236 </varlistentry> 237 238 <varlistentry> 239 <term>--single-obj-repl</term> 240 <listitem><para> 241 When calling "net rpc vampire keytab" this option 242 allows one to replicate just a single object to the generated keytab file. 243 </para></listitem> 244 </varlistentry> 245 246 <varlistentry> 247 <term>--clean-old-entries</term> 248 <listitem><para> 249 When calling "net rpc vampire keytab" this option 250 allows one to cleanup old entries from the generated keytab file. 251 </para></listitem> 252 </varlistentry> 253 254 <!-- Options for net idmap --> 255 256 <varlistentry> 257 <term>--db</term> 258 <listitem><para>Define dbfile for "net idmap" commands. 259 </para></listitem> 260 </varlistentry> 261 262 <varlistentry> 263 <term>--lock</term> 264 <listitem><para>Activates locking of the dbfile for "net idmap check" command. 265 </para></listitem> 266 </varlistentry> 267 268 <varlistentry> 269 <term>-a|--auto</term> 270 <listitem><para>Activates noninteractive mode in "net idmap check". 271 </para></listitem> 272 </varlistentry> 273 274 <varlistentry> 275 <term>--repair</term> 276 <listitem><para>Activates repair mode in "net idmap check". 277 </para></listitem> 278 </varlistentry> 279 280 <!-- Options for net rpc share migrate --> 281 282 <varlistentry> 283 <term>--acls</term> 284 <listitem><para>Includes ACLs to be copied in "net rpc share migrate". 285 </para></listitem> 286 </varlistentry> 287 288 <varlistentry> 289 <term>--attrs</term> 290 <listitem><para>Includes file attributes to be copied in "net rpc share migrate". 291 </para></listitem> 292 </varlistentry> 293 294 <varlistentry> 295 <term>--timestamps</term> 296 <listitem><para>Includes timestamps to be copied in "net rpc share migrate". 297 </para></listitem> 298 </varlistentry> 299 300 <varlistentry> 301 <term>-X|--exclude DIRECTORY</term> 302 <listitem><para>Allows one to exclude directories when copying with "net rpc share migrate". 303 </para></listitem> 304 </varlistentry> 305 306 <varlistentry> 307 <term>--destination SERVERNAME</term> 308 <listitem><para>Defines the target servername of migration process (defaults to localhost). 309 </para></listitem> 310 </varlistentry> 311 312 <!-- Options for net groupmap set --> 313 314 <varlistentry> 315 <term>-L|--local</term> 316 <listitem><para>Sets the type of group mapping to local 317 (used in "net groupmap set"). 318 </para></listitem> 319 </varlistentry> 320 321 <varlistentry> 322 <term>-D|--domain</term> 323 <listitem><para>Sets the type of group mapping to domain 324 (used in "net groupmap set"). 325 </para></listitem> 326 </varlistentry> 327 328 <varlistentry> 329 <term>-N|--ntname NTNAME</term> 330 <listitem><para>Sets the ntname of a group mapping 331 (used in "net groupmap set"). 332 </para></listitem> 333 </varlistentry> 334 335 <varlistentry> 336 <term>-R|--rid RID</term> 337 <listitem><para>Sets the rid of a group mapping 338 (used in "net groupmap set"). 339 </para></listitem> 340 </varlistentry> 341 342 <!-- Options for net registry check --> 343 344 <varlistentry> 345 <term>--reg-version REG_VERSION</term> 346 <listitem><para>Assume database version {n|1,2,3} 347 (used in "net registry check"). 348 </para></listitem> 349 </varlistentry> 350 351 <varlistentry> 352 <term>-o|--output FILENAME</term> 353 <listitem><para>Output database file 354 (used in "net registry check"). 355 </para></listitem> 356 </varlistentry> 357 358 <varlistentry> 359 <term>--wipe</term> 360 <listitem><para>Create a new database from scratch 361 (used in "net registry check"). 362 </para></listitem> 363 </varlistentry> 364 365 <!-- Options for net registry import --> 366 367 <varlistentry> 368 <term>--precheck PRECHECK_DB_FILENAME</term> 369 <listitem><para>Defines filename for database prechecking 370 (used in "net registry import"). 371 </para></listitem> 372 </varlistentry> 373 374 <varlistentry> 375 <term>--no-dns-updates</term> 376 <listitem><para>Do not perform DNS updates as part of 377 "net ads join". 378 </para></listitem> 379 </varlistentry> 380 381 &stdarg.encrypt; 382 &popt.common.samba.client; 383 139 384 </variablelist> 140 385 </refsect1> … … 167 412 168 413 <para>Without any options, the <command>NET TIME</command> command 169 displays the time on the remote server. 414 displays the time on the remote server. The remote server must be 415 specified with the -S option. 170 416 </para> 171 417 … … 175 421 <title>TIME SYSTEM</title> 176 422 177 <para>Displays the time on the remote server in a format ready for <command>/bin/date</command>.</para> 423 <para>Displays the time on the remote server in a format ready for <command>/bin/date</command>. 424 The remote server must be specified with the -S option. 425 </para> 178 426 179 427 </refsect3> … … 182 430 <title>TIME SET</title> 183 431 <para>Tries to set the date and time of the local server to that on 184 the remote server using <command>/bin/date</command>. </para> 432 the remote server using <command>/bin/date</command>. 433 The remote server must be specified with the -S option. 434 </para> 185 435 186 436 </refsect3> … … 189 439 <title>TIME ZONE</title> 190 440 191 <para>Displays the timezone in hours from GMT on the remote computer.</para> 192 193 </refsect3> 194 </refsect2> 195 196 <refsect2> 197 <title>[RPC|ADS] JOIN [TYPE] [-U username[%password]] [createupn=UPN] [createcomputer=OU] [options]</title> 441 <para>Displays the timezone in hours from GMT on the remote server. 442 The remote server must be specified with the -S option. 443 </para> 444 445 </refsect3> 446 </refsect2> 447 448 <refsect2> 449 <title>[RPC|ADS] JOIN [TYPE] [--no-dns-updates] [-U username[%password]] 450 [createupn=UPN] [createcomputer=OU] [machinepass=PASS] 451 [osName=string osVer=string] [options]</title> 198 452 199 453 <para> … … 220 474 and ldap, so it may need to be doubled or quadrupled to pass through, 221 475 and it is not used as a delimiter. 476 </para> 477 <para> 478 [PASS] (ADS only) Set a specific password on the computer account 479 being created by the join. 480 </para> 481 <para> 482 [osName=string osVer=String] (ADS only) Set the operatingSystem and 483 operatingSystemVersion attribute during the join. Both parameters 484 must be specified for either to take effect. 222 485 </para> 223 486 </refsect2> … … 687 950 <title>GROUPMAP MODIFY</title> 688 951 689 <para>Update en existing group entry.</para>952 <para>Update an existing group entry.</para> 690 953 691 954 <para> … … 797 1060 798 1061 </refsect3> 799 <refsect3>800 <title>RPC TRUSTDOM LIST</title>801 802 <para>List all interdomain trust relationships.</para>803 804 </refsect3>805 1062 </refsect2> 806 1063 … … 811 1068 <title>RPC TRUST CREATE</title> 812 1069 813 <para>Create a trust trustobject by calling lsaCreateTrustedDomainEx2.1070 <para>Create a trust object by calling lsaCreateTrustedDomainEx2. 814 1071 The can be done on a single server or on two servers at once with the 815 1072 possibility to use a random trust password.</para> … … 874 1131 <title>RPC TRUST DELETE</title> 875 1132 876 <para>Delete a trust trustobject by calling lsaDeleteTrustedDomain.1133 <para>Delete a trust object by calling lsaDeleteTrustedDomain. 877 1134 The can be done on a single server or on two servers at once.</para> 878 1135 … … 988 1245 <para>Export users, aliases and groups from remote server to 989 1246 local server. You need to run this against the PDC, from a Samba machine joined as a BDC. 1247 This vampire command cannot be used against an Active Directory, only 1248 against an NT4 Domain Controller. 990 1249 </para> 991 1250 </refsect2> … … 1087 1346 1088 1347 </refsect2> 1348 1349 <refsect2> 1350 <title>ADS ENCTYPES</title> 1351 1352 <para> 1353 List, modify or delete the value of the "msDS-SupportedEncryptionTypes" attribute of an account in AD. 1354 </para> 1355 1356 <para> 1357 This attribute allows one to control which Kerberos encryption types are used for the generation of initial and service tickets. The value consists of an integer bitmask with the following values: 1358 </para> 1359 1360 <para>0x00000001 DES-CBC-CRC</para> 1361 <para>0x00000002 DES-CBC-MD5</para> 1362 <para>0x00000004 RC4-HMAC</para> 1363 <para>0x00000008 AES128-CTS-HMAC-SHA1-96</para> 1364 <para>0x00000010 AES256-CTS-HMAC-SHA1-96</para> 1365 1366 </refsect2> 1367 1368 <refsect2> 1369 <title>ADS ENCTYPES LIST <replaceable><ACCOUNTNAME></replaceable></title> 1370 1371 <para> 1372 List the value of the "msDS-SupportedEncryptionTypes" attribute of a given account. 1373 </para> 1374 1375 <para>Example: <userinput>net ads enctypes list Computername</userinput></para> 1376 1377 </refsect2> 1378 1379 <refsect2> 1380 <title>ADS ENCTYPES SET <replaceable><ACCOUNTNAME></replaceable> <replaceable>[enctypes]</replaceable></title> 1381 1382 <para> 1383 Set the value of the "msDS-SupportedEncryptionTypes" attribute of the LDAP object of ACCOUNTNAME to a given value. If the value is omitted, the value is set to 31 which enables all the currently supported encryption types. 1384 </para> 1385 1386 <para>Example: <userinput>net ads enctypes set Computername 24</userinput></para> 1387 1388 </refsect2> 1389 1390 <refsect2> 1391 <title>ADS ENCTYPES DELETE <replaceable><ACCOUNTNAME></replaceable></title> 1392 1393 <para> 1394 Deletes the "msDS-SupportedEncryptionTypes" attribute of the LDAP object of ACCOUNTNAME. 1395 </para> 1396 1397 <para>Example: <userinput>net ads enctypes set Computername 24</userinput></para> 1398 1399 </refsect2> 1400 1089 1401 1090 1402 <refsect2> … … 1389 1701 1390 1702 <refsect2> 1391 <title>IDMAP SE CRET <DOMAIN> <secret></title>1703 <title>IDMAP SET SECRET <DOMAIN> <secret></title> 1392 1704 1393 1705 <para> … … 1400 1712 1401 1713 <refsect2> 1402 1403 <title>IDMAP DELETE [-f] [--db=<DB>] <ID></title> 1714 <title>IDMAP SET RANGE <RANGE> <SID> [index] [--db=<DB>]</title> 1715 1716 <para> 1717 Store a domain-range mapping for a given domain (and index) in autorid database. 1718 </para> 1719 1720 </refsect2> 1721 1722 <refsect2> 1723 <title>IDMAP SET CONFIG <config> [--db=<DB>]</title> 1724 1725 <para> 1726 Update CONFIG entry in autorid database. 1727 </para> 1728 1729 </refsect2> 1730 1731 <refsect2> 1732 <title>IDMAP GET RANGE <SID> [index] [--db=<DB>]</title> 1733 1734 <para> 1735 Get the range for a given domain and index from autorid database. 1736 </para> 1737 1738 </refsect2> 1739 1740 <refsect2> 1741 <title>IDMAP GET RANGES [<SID>] [--db=<DB>]</title> 1742 1743 <para> 1744 Get ranges for all domains or for one identified by given SID. 1745 </para> 1746 1747 </refsect2> 1748 1749 <refsect2> 1750 <title>IDMAP GET CONFIG [--db=<DB>]</title> 1751 1752 <para> 1753 Get CONFIG entry from autorid database. 1754 </para> 1755 1756 </refsect2> 1757 1758 <refsect2> 1759 1760 <title>IDMAP DELETE MAPPING [-f] [--db=<DB>] <ID></title> 1404 1761 1405 1762 <para> … … 1413 1770 <manvolnum>1</manvolnum></citerefentry> manpage for details. 1414 1771 </para> 1772 </refsect2> 1773 1774 <refsect2> 1775 <title>IDMAP DELETE RANGE [-f] [--db=<TDB>] <RANGE>|(<SID> [<INDEX>])</title> 1776 1777 <para> 1778 Delete a domain range mapping identified by 'RANGE' or "domain SID and INDEX" from autorid database. 1779 Use -f to delete invalid mappings. 1780 </para> 1781 1782 </refsect2> 1783 1784 <refsect2> 1785 <title>IDMAP DELETE RANGES [-f] [--db=<TDB>] <SID></title> 1786 1787 <para> 1788 Delete all domain range mappings for a domain identified by SID. 1789 Use -f to delete invalid mappings. 1790 </para> 1791 1415 1792 </refsect2> 1416 1793 … … 1664 2041 1665 2042 <refsect2> 1666 <title> CONF</title>2043 <title>[RPC] CONF</title> 1667 2044 1668 2045 <para>Starting with version 3.2.0, a Samba server can be configured by data 1669 2046 stored in registry. This configuration data can be edited with the new "net 1670 conf" commands. 2047 conf" commands. There is also the possibility to configure a remote Samba server 2048 by enabling the RPC conf mode and specifying the address of the remote server. 1671 2049 </para> 1672 2050 … … 1686 2064 <para>The conf commands are: 1687 2065 <simplelist> 1688 <member>net conf list - Dump the complete configuration in smb.conf like2066 <member>net [rpc] conf list - Dump the complete configuration in smb.conf like 1689 2067 format.</member> 1690 <member>net conf import - Import configuration from file in smb.conf2068 <member>net [rpc] conf import - Import configuration from file in smb.conf 1691 2069 format.</member> 1692 <member>net conf listshares - List the registry shares.</member>1693 <member>net conf drop - Delete the complete configuration from2070 <member>net [rpc] conf listshares - List the registry shares.</member> 2071 <member>net [rpc] conf drop - Delete the complete configuration from 1694 2072 registry.</member> 1695 <member>net conf showshare - Show the definition of a registry share.</member>1696 <member>net conf addshare - Create a new registry share.</member>1697 <member>net conf delshare - Delete a registry share.</member>1698 <member>net conf setparm - Store a parameter.</member>1699 <member>net conf getparm - Retrieve the value of a parameter.</member>1700 <member>net conf delparm - Delete a parameter.</member>1701 <member>net conf getincludes - Show the includes of a share definition.</member>1702 <member>net conf setincludes - Set includes for a share.</member>1703 <member>net conf delincludes - Delete includes from a share definition.</member>2073 <member>net [rpc] conf showshare - Show the definition of a registry share.</member> 2074 <member>net [rpc] conf addshare - Create a new registry share.</member> 2075 <member>net [rpc] conf delshare - Delete a registry share.</member> 2076 <member>net [rpc] conf setparm - Store a parameter.</member> 2077 <member>net [rpc] conf getparm - Retrieve the value of a parameter.</member> 2078 <member>net [rpc] conf delparm - Delete a parameter.</member> 2079 <member>net [rpc] conf getincludes - Show the includes of a share definition.</member> 2080 <member>net [rpc] conf setincludes - Set includes for a share.</member> 2081 <member>net [rpc] conf delincludes - Delete includes from a share definition.</member> 1704 2082 </simplelist> 1705 2083 </para> 1706 2084 1707 2085 <refsect3> 1708 <title> CONF LIST</title>2086 <title>[RPC] CONF LIST</title> 1709 2087 1710 2088 <para> … … 1715 2093 1716 2094 <refsect3> 1717 <title> CONF IMPORT <replaceable>[--test|-T]</replaceable> <replaceable>filename</replaceable> <replaceable>[section]</replaceable></title>2095 <title>[RPC] CONF IMPORT <replaceable>[--test|-T]</replaceable> <replaceable>filename</replaceable> <replaceable>[section]</replaceable></title> 1718 2096 1719 2097 <para> … … 1731 2109 1732 2110 <refsect3> 1733 <title> CONF LISTSHARES</title>2111 <title>[RPC] CONF LISTSHARES</title> 1734 2112 1735 2113 <para> … … 1739 2117 1740 2118 <refsect3> 1741 <title> CONF DROP</title>2119 <title>[RPC] CONF DROP</title> 1742 2120 1743 2121 <para> … … 1747 2125 1748 2126 <refsect3> 1749 <title> CONF SHOWSHARE <replaceable>sharename</replaceable></title>2127 <title>[RPC] CONF SHOWSHARE <replaceable>sharename</replaceable></title> 1750 2128 1751 2129 <para> … … 1757 2135 1758 2136 <refsect3> 1759 <title> CONF ADDSHARE <replaceable>sharename</replaceable> <replaceable>path</replaceable> [<replaceable>writeable={y|N}</replaceable> [<replaceable>guest_ok={y|N}</replaceable> [<replaceable>comment</replaceable>]]] </title>2137 <title>[RPC] CONF ADDSHARE <replaceable>sharename</replaceable> <replaceable>path</replaceable> [<replaceable>writeable={y|N}</replaceable> [<replaceable>guest_ok={y|N}</replaceable> [<replaceable>comment</replaceable>]]] </title> 1760 2138 1761 2139 <para>Create a new share definition in registry. … … 1769 2147 1770 2148 <refsect3> 1771 <title> CONF DELSHARE <replaceable>sharename</replaceable></title>2149 <title>[RPC] CONF DELSHARE <replaceable>sharename</replaceable></title> 1772 2150 1773 2151 <para> … … 1777 2155 1778 2156 <refsect3> 1779 <title> CONF SETPARM <replaceable>section</replaceable> <replaceable>parameter</replaceable> <replaceable>value</replaceable></title>2157 <title>[RPC] CONF SETPARM <replaceable>section</replaceable> <replaceable>parameter</replaceable> <replaceable>value</replaceable></title> 1780 2158 1781 2159 <para> … … 1786 2164 1787 2165 <refsect3> 1788 <title> CONF GETPARM <replaceable>section</replaceable> <replaceable>parameter</replaceable></title>2166 <title>[RPC] CONF GETPARM <replaceable>section</replaceable> <replaceable>parameter</replaceable></title> 1789 2167 1790 2168 <para> … … 1794 2172 1795 2173 <refsect3> 1796 <title> CONF DELPARM <replaceable>section</replaceable> <replaceable>parameter</replaceable></title>2174 <title>[RPC] CONF DELPARM <replaceable>section</replaceable> <replaceable>parameter</replaceable></title> 1797 2175 1798 2176 <para> … … 1802 2180 1803 2181 <refsect3> 1804 <title> CONF GETINCLUDES <replaceable>section</replaceable></title>2182 <title>[RPC] CONF GETINCLUDES <replaceable>section</replaceable></title> 1805 2183 1806 2184 <para> … … 1828 2206 1829 2207 <refsect3> 1830 <title> CONF SETINCLUDES <replaceable>section</replaceable> [<replaceable>filename</replaceable>]+</title>2208 <title>[RPC] CONF SETINCLUDES <replaceable>section</replaceable> [<replaceable>filename</replaceable>]+</title> 1831 2209 1832 2210 <para> … … 1838 2216 1839 2217 <refsect3> 1840 <title> CONF DELINCLUDES <replaceable>section</replaceable></title>2218 <title>[RPC] CONF DELINCLUDES <replaceable>section</replaceable></title> 1841 2219 1842 2220 <para> … … 1877 2255 <member>net registry convert - Convert a registration entries (.reg) file. 1878 2256 </member> 2257 <member>net registry check - Check and repair a registry database. 2258 </member> 1879 2259 </simplelist> 1880 2260 </para> … … 1992 2372 <refsect3> 1993 2373 <title>REGISTRY IMPORT <replaceable>file</replaceable><!-- 1994 --><replaceable>[opt]</replaceable></title> 1995 1996 <para>Import a registration entries (.reg) <emphasis>file</emphasis>. 1997 </para> 2374 --><replaceable> [--precheck <check-file>] [opt]</replaceable></title> 2375 <para>Import a registration entries (.reg) <emphasis>file</emphasis>.</para> 2376 <para>The following options are available:</para> 2377 <variablelist> 2378 <varlistentry><term>--precheck <replaceable>check-file</replaceable></term> 2379 <listitem><para> 2380 This is a mechanism to check the existence or non-existence of 2381 certain keys or values specified in a precheck file before applying 2382 the import file. 2383 The import file will only be applied if the precheck succeeds. 2384 </para> 2385 <para> 2386 The check-file follows the normal registry file syntax with the 2387 following semantics: 2388 </para> 2389 <itemizedlist> 2390 <listitem><para><value name>=<value> checks whether the 2391 value exists and has the given value.</para></listitem> 2392 <listitem><para><value name>=- checks whether the value does 2393 not exist.</para></listitem> 2394 <listitem><para>[key] checks whether the key exists.</para> 2395 </listitem> 2396 <listitem><para>[-key] checks whether the key does not exist.</para> 2397 </listitem> 2398 </itemizedlist> 2399 </listitem> 2400 </varlistentry> 2401 </variablelist> 1998 2402 </refsect3> 1999 2403 … … 2017 2421 </refsect3> 2018 2422 2423 <refsect3> 2424 <title>REGISTRY CHECK [-ravTl] [-o <ODB>] [--wipe] [<DB>]</title> 2425 <para>Check and repair the registry database. If no option is given a read only check of the database is done. Among others an interactive or automatic repair mode may be chosen with one of the following options 2426 2427 <variablelist> 2428 <varlistentry><term>-r|--repair</term> 2429 <listitem><para> 2430 Interactive repair mode, ask a lot of questions. 2431 </para></listitem> 2432 </varlistentry> 2433 2434 <varlistentry><term>-a|--auto</term> 2435 <listitem><para> 2436 Noninteractive repair mode, use default answers. 2437 </para></listitem> 2438 </varlistentry> 2439 2440 <varlistentry><term>-v|--verbose</term> 2441 <listitem><para> 2442 Produce more output. 2443 </para></listitem> 2444 </varlistentry> 2445 2446 <varlistentry><term>-T|--test</term> 2447 <listitem><para> 2448 Dry run, show what changes would be made but don't touch anything. 2449 </para></listitem> 2450 </varlistentry> 2451 2452 <varlistentry><term>-l|--lock</term> 2453 <listitem><para> 2454 Lock the database while doing the check. 2455 </para></listitem> 2456 </varlistentry> 2457 2458 <varlistentry><term>--reg-version={1,2,3}</term> 2459 <listitem><para> 2460 Specify the format of the registry database. If not given it defaults to 2461 the value of the binary or, if an registry.tdb is explizitly stated at 2462 the commandline, to the value found in the INFO/version record. 2463 </para></listitem> 2464 </varlistentry> 2465 2466 <varlistentry><term>[--db] <DB></term> 2467 <listitem><para> 2468 Check the specified database. 2469 </para></listitem> 2470 </varlistentry> 2471 2472 <varlistentry><term>-o|--output <ODB></term> 2473 <listitem><para> 2474 Create a new registry database <ODB> instead of modifying the 2475 input. If <ODB> is already existing --wipe may be used to 2476 overwrite it. 2477 </para></listitem> 2478 </varlistentry> 2479 2480 <varlistentry><term>--wipe</term> 2481 <listitem><para> 2482 Replace the registry database instead of modifying the input or 2483 overwrite an existing output database. 2484 </para></listitem> 2485 </varlistentry> 2486 2487 <varlistentry><term></term> 2488 <listitem><para> 2489 </para></listitem> 2490 </varlistentry> 2491 </variablelist> 2492 </para> 2493 </refsect3> 2019 2494 2020 2495 </refsect2> -
vendor/current/docs-xml/manpages/nmbd.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 21 21 <cmdsynopsis> 22 22 <command>nmbd</command> 23 <arg choice="opt">-D</arg> 24 <arg choice="opt">-F</arg> 25 <arg choice="opt">-S</arg> 26 <arg choice="opt">-a</arg> 27 <arg choice="opt">-i</arg> 28 <arg choice="opt">-o</arg> 29 <arg choice="opt">-h</arg> 23 <arg choice="opt">-D|--daemon</arg> 24 <arg choice="opt">-F|--foreground</arg> 25 <arg choice="opt">-S|--log-stdout</arg> 26 <arg choice="opt">-i|--interactive</arg> 30 27 <arg choice="opt">-V</arg> 31 28 <arg choice="opt">-d <debug level></arg> 32 <arg choice="opt">-H <lmhosts file></arg>29 <arg choice="opt">-H|--hosts <lmhosts file></arg> 33 30 <arg choice="opt">-l <log directory></arg> 34 <arg choice="opt">-p <port number></arg>31 <arg choice="opt">-p|--port <port number></arg> 35 32 <arg choice="opt">-s <configuration file></arg> 33 <arg choice="opt">--no-process-group</arg> 36 34 </cmdsynopsis> 37 35 </refsynopsisdiv> … … 82 80 <variablelist> 83 81 <varlistentry> 84 <term>-D </term>82 <term>-D|--daemon</term> 85 83 <listitem><para>If specified, this parameter causes 86 84 <command>nmbd</command> to operate as a daemon. That is, … … 94 92 95 93 <varlistentry> 96 <term>-F </term>94 <term>-F|--foreground</term> 97 95 <listitem><para>If specified, this parameter causes 98 96 the main <command>nmbd</command> process to not daemonize, … … 109 107 110 108 <varlistentry> 111 <term>-S </term>109 <term>-S|--log-stdout</term> 112 110 <listitem><para>If specified, this parameter causes 113 111 <command>nmbd</command> to log to standard output rather … … 116 114 117 115 <varlistentry> 118 <term>-i </term>116 <term>-i|--interactive</term> 119 117 <listitem><para>If this parameter is specified it causes the 120 118 server to run "interactively", not as a daemon, even if the … … 126 124 </varlistentry> 127 125 128 & stdarg.help;126 &popt.autohelp; 129 127 130 128 <varlistentry> 131 <term>-H <filename></term>129 <term>-H|--hosts <filename></term> 132 130 <listitem><para>NetBIOS lmhosts file. The lmhosts 133 131 file is a list of NetBIOS names to IP addresses that … … 153 151 154 152 <varlistentry> 155 <term>-p <UDP port number></term>153 <term>-p|--port <UDP port number></term> 156 154 <listitem><para>UDP port number is a positive integer value. 157 155 This option changes the default UDP port number (normally 137) … … 159 157 use this option unless you are an expert, in which case you 160 158 won't need help!</para></listitem> 159 </varlistentry> 160 161 <varlistentry> 162 <term>--no-process-group</term> 163 <listitem><para>Do not create a new process group for nmbd. 164 </para></listitem> 161 165 </varlistentry> 162 166 … … 267 271 <manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>smbclient</refentrytitle> 268 272 <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>testparm</refentrytitle> 269 <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>testprns</refentrytitle>270 273 <manvolnum>1</manvolnum></citerefentry>, and the Internet 271 274 RFC's <filename>rfc1001.txt</filename>, <filename>rfc1002.txt</filename>. -
vendor/current/docs-xml/manpages/nmblookup.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 21 21 <cmdsynopsis> 22 22 <command>nmblookup</command> 23 <arg choice="opt">-M</arg> 24 <arg choice="opt">-R</arg> 25 <arg choice="opt">-S</arg> 26 <arg choice="opt">-r</arg> 27 <arg choice="opt">-A</arg> 28 <arg choice="opt">-h</arg> 29 <arg choice="opt">-B <broadcast address></arg> 30 <arg choice="opt">-U <unicast address></arg> 23 <arg choice="opt">-M|--master-browser</arg> 24 <arg choice="opt">-R|--recursion</arg> 25 <arg choice="opt">-S|--status</arg> 26 <arg choice="opt">-r|--root-port</arg> 27 <arg choice="opt">-A|--lookup-by-ip</arg> 28 <arg choice="opt">-B|--broadcast <broadcast address></arg> 29 <arg choice="opt">-U|--unicast <unicast address></arg> 31 30 <arg choice="opt">-d <debug level></arg> 32 31 <arg choice="opt">-s <smb config file></arg> 33 32 <arg choice="opt">-i <NetBIOS scope></arg> 34 <arg choice="opt">-T </arg>35 <arg choice="opt">-f </arg>33 <arg choice="opt">-T|--translate</arg> 34 <arg choice="opt">-f|--flags</arg> 36 35 <arg choice="req">name</arg> 37 36 </cmdsynopsis> … … 56 55 <variablelist> 57 56 <varlistentry> 58 <term>-M </term>59 <listitem><para>Searches for a master browser by looking 60 up the NetBIOS name <replaceable>name</replaceable> with a57 <term>-M|--master-browser</term> 58 <listitem><para>Searches for a master browser by looking 59 up the NetBIOS <replaceable>name</replaceable> with a 61 60 type of <constant>0x1d</constant>. If <replaceable> 62 61 name</replaceable> is "-" then it does a lookup on the special name … … 68 67 69 68 <varlistentry> 70 <term>-R </term>69 <term>-R|--recursion</term> 71 70 <listitem><para>Set the recursion desired bit in the packet 72 71 to do a recursive lookup. This is used when sending a name … … 79 78 80 79 <varlistentry> 81 <term>-S </term>80 <term>-S|--status</term> 82 81 <listitem><para>Once the name query has returned an IP 83 82 address then do a node status query as well. A node status … … 88 87 89 88 <varlistentry> 90 <term>-r </term>89 <term>-r|--root-port</term> 91 90 <listitem><para>Try and bind to UDP port 137 to send and receive UDP 92 91 datagrams. The reason for this option is a bug in Windows 95 … … 101 100 102 101 <varlistentry> 103 <term>-A </term>102 <term>-A|--lookup-by-ip</term> 104 103 <listitem><para>Interpret <replaceable>name</replaceable> as 105 104 an IP Address and do a node status query on this address.</para> … … 110 109 111 110 &popt.common.connection; 112 & stdarg.help;113 114 <varlistentry> 115 <term>-B <broadcast address></term>111 &popt.autohelp; 112 113 <varlistentry> 114 <term>-B|--broadcast <broadcast address></term> 116 115 <listitem><para>Send the query to the given broadcast address. Without 117 116 this option the default behavior of nmblookup is to send the … … 127 126 128 127 <varlistentry> 129 <term>-U <unicast address></term>128 <term>-U|--unicast <unicast address></term> 130 129 <listitem><para>Do a unicast query to the specified address or 131 130 host <replaceable>unicast address</replaceable>. This option … … 138 137 139 138 <varlistentry> 140 <term>-T </term>139 <term>-T|--translate</term> 141 140 <listitem><para>This causes any IP addresses found in the 142 141 lookup to be looked up via a reverse DNS lookup into a … … 149 148 150 149 <varlistentry> 151 <term>-f </term>150 <term>-f|--flags</term> 152 151 <listitem><para> 153 152 Show which flags apply to the name that has been looked up. Possible -
vendor/current/docs-xml/manpages/ntlm_auth.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 20 20 <cmdsynopsis> 21 21 <command>ntlm_auth</command> 22 <arg choice="opt">-d debuglevel</arg>23 <arg choice="opt">-l logdir</arg>24 <arg choice="opt">-s <smb config file></arg>25 22 </cmdsynopsis> 26 23 </refsynopsisdiv> … … 364 361 </varlistentry> 365 362 366 &stdarg.server.debug; 367 &popt.common.samba; 368 &stdarg.help; 369 363 <varlistentry> 364 <term>--pam-winbind-conf=FILENAME</term> 365 <listitem><para>Define the path to the pam_winbind.conf file.</para></listitem> 366 </varlistentry> 367 368 <varlistentry> 369 <term>--target-hostname=HOSTNAME</term> 370 <listitem><para>Define the target hostname.</para></listitem> 371 </varlistentry> 372 373 <varlistentry> 374 <term>--target-service=SERVICE</term> 375 <listitem><para>Define the target service.</para></listitem> 376 </varlistentry> 377 378 <varlistentry> 379 <term>--use-cached-creds</term> 380 <listitem><para>Whether to use credentials cached by winbindd.</para></listitem> 381 </varlistentry> 382 383 <varlistentry> 384 <term>--offline-logon</term> 385 <listitem><para>Allow offline logons for plain text auth. 386 </para></listitem> 387 </varlistentry> 388 389 <varlistentry> 390 <term>--configfile=<configuration file></term> 391 <listitem><para>The file specified contains the 392 configuration details required by the server. The 393 information in this file includes server-specific 394 information such as what printcap file to use, as well 395 as descriptions of all the services that the server is 396 to provide. See &smb.conf; for more information. 397 The default configuration file name is determined at 398 compile time.</para></listitem> 399 </varlistentry> 400 401 &stdarg.version; 402 &popt.autohelp; 403 370 404 </variablelist> 371 405 </refsect1> -
vendor/current/docs-xml/manpages/pam_winbind.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">8</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 88 88 NAME may not contain any spaces. It is thus recommended to only use SIDs. You can verify the list of SIDs a 89 89 user is a member of with <command>wbinfo --user-sids=SID</command>. 90 </para></listitem> 90 </para> 91 92 <para> 93 This option must only be specified on a auth 94 module declaration, as it only operates in conjunction 95 with password authentication. 96 </para> 97 </listitem> 91 98 </varlistentry> 92 99 … … 154 161 <term>cached_login</term> 155 162 <listitem><para> 156 Winbind allows to logon using cached credentials when <parameter>winbind offline logon</parameter> is enabled. To use this feature from the PAM module this option must be set.163 Winbind allows one to logon using cached credentials when <parameter>winbind offline logon</parameter> is enabled. To use this feature from the PAM module this option must be set. 157 164 </para></listitem> 158 165 </varlistentry> -
vendor/current/docs-xml/manpages/pam_winbind.conf.5.xml
r414 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">5</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 73 73 NAME may not contain any spaces. It is thus recommended to only use SIDs. You can verify the list of SIDs a 74 74 user is a member of with <command>wbinfo --user-sids=SID</command>. This setting is empty by default. 75 </para></listitem> 75 </para> 76 <para>This option only operates during password authentication, and will not restrict access if a password is not required for any reason (such as SSH key-based login).</para> 77 </listitem> 76 78 </varlistentry> 77 79 … … 110 112 by enabling the <parameter>krb5_auth</parameter> option, it can 111 113 store the retrieved Ticket Granting Ticket (TGT) in a 112 credential cache. The type of credential cache can be set with 113 this option. Currently the only supported value is: 114 <parameter>FILE</parameter>. In that case a credential cache in 115 the form of /tmp/krb5cc_UID will be created, where UID is 116 replaced with the numeric user id. Leave empty to just do 117 kerberos authentication without having a ticket cache after the 118 logon has succeeded. This setting is empty by default. 114 credential cache. The type of credential cache can be 115 controlled with this option. The supported values are: 116 <parameter>KEYRING</parameter> (when supported by the system's 117 Kerberos library and Kernel), <parameter>FILE</parameter> and 118 <parameter>DIR</parameter> (when the DIR type is supported by 119 the system's Kerberos library). In case of FILE a credential 120 cache in the form of /tmp/krb5cc_UID will be created - in case 121 of DIR you NEED to specify a directory. UID is replaced with 122 the numeric user id.</para> 123 124 <para>When using the KEYRING type, the supported mechanism is 125 <quote>KEYRING:persistent:UID</quote>, which uses the Linux 126 kernel keyring to store credentials on a per-UID basis. This is 127 the recommended choice on latest Linux distributions, as it is 128 the most secure and predictable method.</para> 129 130 <para>It is also possible to define custom filepaths and use the "%u" 131 pattern in order to substitue the numeric user id. 132 Examples:</para> 133 134 <variablelist> 135 <varlistentry> 136 <term>krb5_ccache_type = DIR:/run/user/%u/krb5cc</term> 137 <listitem><para>This will create a credential cache file in the specified directory.</para></listitem> 138 </varlistentry> 139 <varlistentry> 140 <term>krb5_ccache_type = FILE:/tmp/krb5cc_%u</term> 141 <listitem><para>This will create a credential cache file.</para></listitem> 142 </varlistentry> 143 </variablelist> 144 145 <para> Leave empty to just do kerberos authentication without 146 having a ticket cache after the logon has succeeded. 147 This setting is empty by default. 119 148 120 149 </para></listitem> … … 124 153 <term>cached_login = yes|no</term> 125 154 <listitem><para> 126 Winbind allows to logon using cached credentials when <parameter>winbind offline logon</parameter> is enabled. To use this feature from the PAM module this option must be set. Defaults to "no".155 Winbind allows one to logon using cached credentials when <parameter>winbind offline logon</parameter> is enabled. To use this feature from the PAM module this option must be set. Defaults to "no". 127 156 </para></listitem> 128 157 </varlistentry> -
vendor/current/docs-xml/manpages/pdbedit.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 44 44 <arg choice="opt">-s configfile</arg> 45 45 <arg choice="opt">-S script</arg> 46 <arg choice="opt">--set-nt-hash</arg> 46 47 <arg choice="opt">-t</arg> 47 48 <arg choice="opt">--time-format</arg> … … 100 101 <listitem><para>This option enables the verbose listing format. 101 102 It causes pdbedit to list the users in the database, printing 102 out the account fields in a descriptive format.</para> 103 out the account fields in a descriptive format. Used together 104 with -w also shows passwords hashes.</para> 103 105 104 106 <para>Example: <command>pdbedit -L -v</command></para> … … 135 137 <filename>smbpasswd</filename> file format. (see the 136 138 <citerefentry><refentrytitle>smbpasswd</refentrytitle> 137 <manvolnum>5</manvolnum></citerefentry> for details)</para> 139 <manvolnum>5</manvolnum></citerefentry> for details). 140 Instead used together with (-v) displays the passwords 141 hashes in verbose output.</para> 138 142 139 143 <para>Example: <command>pdbedit -L -w</command></para> … … 205 209 206 210 211 <varlistentry> 212 <term>--set-nt-hash</term> 213 <listitem><para>This option can be used while modifying 214 a user account. It will set the user's password using 215 the nt-hash value given as hexadecimal string. 216 Useful to synchronize passwords.</para> 217 218 <para>Example: <command>--set-nt-hash 8846F7EAEE8FB117AD06BDD830B7586C</command> 219 </para> 220 </listitem> 221 </varlistentry> 222 207 223 <varlistentry> 208 224 <term>-p|--profile profile</term> … … 290 306 </para> 291 307 292 <note><para>pdbedit does not call the unix password sync ronisation308 <note><para>pdbedit does not call the unix password synchronization 293 309 script if <smbconfoption name="unix password sync"/> 294 310 has been set. It only updates the data in the Samba … … 429 445 applies to the account policies instead of the user database.</para> 430 446 431 <para>This option will allow to migrate account policies from their default447 <para>This option will allow one to migrate account policies from their default 432 448 tdb-store into a passdb backend, e.g. an LDAP directory server.</para> 433 449 … … 504 520 </varlistentry> 505 521 506 & stdarg.help;522 &popt.autohelp; 507 523 &stdarg.server.debug; 508 524 &popt.common.samba; -
vendor/current/docs-xml/manpages/profiles.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 22 22 <command>profiles</command> 23 23 <arg choice="opt">-v</arg> 24 <arg choice="opt">-c SID</arg>25 <arg choice="opt">-n SID</arg>24 <arg choice="opt">-c|--change-sid SID</arg> 25 <arg choice="opt">-n|--new-sid SID</arg> 26 26 <arg choice="req">file</arg> 27 27 </cmdsynopsis> … … 59 59 <varlistentry> 60 60 <term>-c SID1 -n SID2</term> 61 <term>--change-sid SID1 --new-sid SID2</term> 61 62 <listitem><para>Change all occurrences of SID1 in <filename>file</filename> by SID2. 62 63 </para></listitem> 63 64 </varlistentry> 64 65 65 &stdarg.help; 66 66 &popt.common.samba.client; 67 &popt.autohelp; 68 67 69 </variablelist> 68 70 </refsect1> -
vendor/current/docs-xml/manpages/rpcclient.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 24 24 <arg choice="opt">-c <command string></arg> 25 25 <arg choice="opt">-d debuglevel</arg> 26 <arg choice="opt">-h</arg>27 26 <arg choice="opt">-l logdir</arg> 28 27 <arg choice="opt">-N</arg> … … 99 98 &popt.common.credentials; 100 99 &popt.common.connection; 101 & stdarg.help;100 &popt.autohelp; 102 101 </variablelist> 103 102 </refsect1> … … 121 120 </para></listitem></varlistentry> 122 121 123 <varlistentry><term>enumtrust s</term><listitem><para>Enumerate trusted domains</para></listitem></varlistentry>122 <varlistentry><term>enumtrust</term><listitem><para>Enumerate trusted domains</para></listitem></varlistentry> 124 123 125 124 <varlistentry><term>enumprivs</term><listitem><para>Enumerate privileges</para></listitem></varlistentry> … … 180 179 <variablelist> 181 180 <varlistentry><term>srvinfo</term><listitem><para>Server query info</para></listitem></varlistentry> 182 183 181 <varlistentry><term>netshareenum</term><listitem><para>Enumerate shares</para></listitem></varlistentry> 184 182 <varlistentry><term>netshareenumall</term><listitem><para>Enumerate all shares</para></listitem></varlistentry> 183 <varlistentry><term>netsharegetinfo</term><listitem><para>Get Share Info</para></listitem></varlistentry> 184 <varlistentry><term>netsharesetinfo</term><listitem><para>Set Share Info</para></listitem></varlistentry> 185 <varlistentry><term>netsharesetdfsflags</term><listitem><para>Set DFS flags</para></listitem></varlistentry> 185 186 <varlistentry><term>netfileenum</term><listitem><para>Enumerate open files</para></listitem></varlistentry> 186 187 187 <varlistentry><term>netremotetod</term><listitem><para>Fetch remote time of day</para></listitem></varlistentry> 188 188 <varlistentry><term>netnamevalidate</term><listitem><para>Validate sharename</para></listitem></varlistentry> 189 <varlistentry><term>netfilegetsec</term><listitem><para>Get File security</para></listitem></varlistentry> 190 <varlistentry><term>netsessdel</term><listitem><para>Delete Session</para></listitem></varlistentry> 191 <varlistentry><term>netsessenum</term><listitem><para>Enumerate Sessions</para></listitem></varlistentry> 192 <varlistentry><term>netdiskenum</term><listitem><para>Enumerate Disks</para></listitem></varlistentry> 193 <varlistentry><term>netconnenum</term><listitem><para>Enumerate Connections</para></listitem></varlistentry> 194 <varlistentry><term>netshareadd</term><listitem><para>Add share</para></listitem></varlistentry> 195 <varlistentry><term>netsharedel</term><listitem><para>Delete share</para></listitem></varlistentry> 189 196 </variablelist> 190 197 … … 232 239 233 240 <para><programlisting> 234 Long Printer Name:\241 Long Driver Name:\ 235 242 Driver File Name:\ 236 243 Data File Name:\ … … 274 281 </para></listitem></varlistentry> 275 282 276 <varlistentry><term>deldriverex <driver> [architecture] [version] 277 </term><listitem><para>Delete the specified printer driver including driver files. 278 You can limit this action to a specific architecture and a specific version. 279 If no architecure is given, all driver files of that driver will be deleted. 283 <varlistentry><term>deldriverex <driver> [architecture] [version] [flags] 284 </term><listitem><para>Delete the specified printer driver and optionally files 285 associated with the driver. 286 You can limit this action to a specific architecture and a specific version. 287 If no architecture is given, all driver files of that driver will be deleted. 288 <parameter>flags</parameter> correspond to numeric DPD_* values, i.e. a value 289 of 3 requests (DPD_DELETE_UNUSED_FILES | DPD_DELETE_SPECIFIC_VERSION). 280 290 </para></listitem></varlistentry> 281 291 … … 419 429 <varlistentry><term>samlogon</term> 420 430 <listitem><para>Sam Logon</para></listitem> 431 </varlistentry> 432 433 </variablelist> 434 </refsect2> 435 436 <refsect2> 437 <title>FSRVP</title> 438 <variablelist> 439 440 <varlistentry><term>fss_is_path_sup <share></term> 441 <listitem> 442 <para>Check whether a share supports shadow-copy 443 requests</para> 444 </listitem> 445 </varlistentry> 446 <varlistentry><term>fss_get_sup_version</term> 447 <listitem> 448 <para>Get supported FSRVP version from server</para> 449 </listitem> 450 </varlistentry> 451 <varlistentry><term>fss_create_expose <context> <[ro|rw]> 452 <share1> 453 [share2] ... [shareN]</term> 454 <listitem> 455 <para>Request shadow-copy creation and exposure as a 456 new share</para> 457 </listitem> 458 </varlistentry> 459 <varlistentry><term>fss_delete <base_share> 460 <shadow_copy_set_id> 461 <shadow_copy_id></term> 462 <listitem> 463 <para>Request shadow-copy share deletion</para> 464 </listitem> 465 </varlistentry> 466 <varlistentry><term>fss_has_shadow_copy <base_share></term> 467 <listitem> 468 <para>Check for an associated share shadow-copy</para> 469 </listitem> 470 </varlistentry> 471 <varlistentry><term>fss_get_mapping <base_share> 472 <shadow_copy_set_id> 473 <shadow_copy_id></term> 474 <listitem> 475 <para>Get shadow-copy share mapping information</para> 476 </listitem> 477 </varlistentry> 478 <varlistentry><term>fss_recovery_complete <shadow_copy_set_id></term> 479 <listitem> 480 <para>Flag read-write shadow-copy as recovery complete, 481 allowing further shadow-copy requests</para> 482 </listitem> 421 483 </varlistentry> 422 484 -
vendor/current/docs-xml/manpages/samba.7.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">Miscellanea</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 14 14 <refnamediv> 15 15 <refname>samba</refname> 16 <refpurpose>A Windows SMB/CIFS fileserver for UNIX</refpurpose>16 <refpurpose>A Windows AD and SMB/CIFS fileserver for UNIX</refpurpose> 17 17 </refnamediv> 18 18 … … 23 23 <refsect1> 24 24 <title>DESCRIPTION</title> 25 26 <para>The Samba software suite is a collection of programs 27 that implements the Server Message Block (commonly abbreviated 28 as SMB) protocol for UNIX systems. This protocol is sometimes 29 also referred to as the Common Internet File System (CIFS). For a 30 more thorough description, see <ulink url="http://www.ubiqx.org/cifs/"> 25 26 <para>The Samba software suite is a collection of programs 27 that implements the Server Message Block (commonly abbreviated 28 as SMB) protocol for UNIX systems and provides Active Directory 29 services. This protocol is sometimes also referred to as the 30 Common Internet File System (CIFS). For a more thorough description, 31 see <ulink url="http://www.ubiqx.org/cifs/"> 31 32 http://www.ubiqx.org/cifs/</ulink>. Samba also implements the NetBIOS 32 33 protocol in nmbd.</para> 33 34 34 35 <variablelist> 35 36 <varlistentry> 37 <term><citerefentry><refentrytitle>samba</refentrytitle> 38 <manvolnum>8</manvolnum></citerefentry></term> 39 <listitem><para>The <command>samba</command> daemon provides the 40 Active Directory services and file and print services to 41 SMB clients. The configuration file 42 for this daemon is described in <citerefentry><refentrytitle>smb.conf</refentrytitle> 43 <manvolnum>5</manvolnum></citerefentry>. 44 </para></listitem> 45 </varlistentry> 46 47 <varlistentry> 36 48 <term><citerefentry><refentrytitle>smbd</refentrytitle> 37 49 <manvolnum>8</manvolnum></citerefentry></term> 38 <listitem><para>The <command>smbd</command> daemon provides the file and print services to 39 SMB clients, such as Windows 95/98, Windows NT, Windows 40 for Workgroups or LanManager. The configuration file 50 <listitem><para>The <command>smbd</command> daemon provides the file and print services to 51 SMB clients, such as Windows 95/98, Windows NT, Windows 52 for Workgroups or LanManager. The configuration file 41 53 for this daemon is described in <citerefentry><refentrytitle>smb.conf</refentrytitle> 42 <manvolnum>5</manvolnum></citerefentry> 43 </para></listitem> 44 </varlistentry> 45 54 <manvolnum>5</manvolnum></citerefentry>. 55 </para></listitem> 56 </varlistentry> 57 46 58 <varlistentry> 47 59 <term><citerefentry><refentrytitle>nmbd</refentrytitle> … … 49 61 <listitem><para>The <command>nmbd</command> 50 62 daemon provides NetBIOS nameservice and browsing 51 support. The configuration file for this daemon 63 support. The configuration file for this daemon 52 64 is described in <citerefentry><refentrytitle>smb.conf</refentrytitle> 53 <manvolnum>5</manvolnum></citerefentry></para> 54 </listitem> 65 <manvolnum>5</manvolnum></citerefentry>.</para> 66 </listitem> 67 </varlistentry> 68 69 <varlistentry> 70 <term><citerefentry><refentrytitle>winbindd</refentrytitle> 71 <manvolnum>8</manvolnum></citerefentry></term> 72 <listitem><para><command>winbindd</command> is a daemon 73 that is used for integrating authentication and 74 the user database into unix.</para></listitem> 55 75 </varlistentry> 56 76 … … 59 79 <manvolnum>1</manvolnum></citerefentry></term> 60 80 <listitem><para>The <command>smbclient</command> 61 program implements a simple ftp-like client. This 81 program implements a simple ftp-like client. This 62 82 is useful for accessing SMB shares on other compatible 63 servers (such as Windows NT), and can also be used 64 to allow a UNIX box to print to a printer attached to 83 servers (such as Windows NT), and can also be used 84 to allow a UNIX box to print to a printer attached to 65 85 any SMB server (such as a PC running Windows NT).</para> 86 </listitem> 87 </varlistentry> 88 89 <varlistentry> 90 <term><citerefentry><refentrytitle>samba-tool</refentrytitle> 91 <manvolnum>8</manvolnum></citerefentry></term> 92 <listitem><para>The <command>samba-tool</command> 93 is the main Samba Administration tool regarding 94 Active Directory services.</para> 66 95 </listitem> 67 96 </varlistentry> … … 77 106 78 107 <varlistentry> 79 <term><citerefentry><refentrytitle>testprns</refentrytitle>80 <manvolnum>1</manvolnum></citerefentry></term>81 <listitem><para>The <command>testprns</command>82 utility supports testing printer names defined83 in your <filename>printcap</filename> file used84 by Samba.</para>85 </listitem>86 </varlistentry>87 88 <varlistentry>89 108 <term><citerefentry><refentrytitle>smbstatus</refentrytitle> 90 109 <manvolnum>1</manvolnum></citerefentry></term> 91 110 <listitem><para>The <command>smbstatus</command> 92 tool provides access to information about the 111 tool provides access to information about the 93 112 current connections to <command>smbd</command>.</para> 94 113 </listitem> … … 99 118 <manvolnum>1</manvolnum></citerefentry></term> 100 119 <listitem><para>The <command>nmblookup</command> 101 tools allows NetBIOS name queries to be made 120 tools allows NetBIOS name queries to be made 102 121 from a UNIX host.</para> 103 122 </listitem> … … 108 127 <manvolnum>8</manvolnum></citerefentry></term> 109 128 <listitem><para>The <command>smbpasswd</command> 110 command is a tool for changing LanMan and Windows NT 129 command is a tool for changing LanMan and Windows NT 111 130 password hashes on Samba and Windows NT servers.</para> 112 131 </listitem> … … 116 135 <term><citerefentry><refentrytitle>smbcacls</refentrytitle> 117 136 <manvolnum>1</manvolnum></citerefentry></term> 118 <listitem><para>The <command>smbcacls</command> command is 137 <listitem><para>The <command>smbcacls</command> command is 119 138 a tool to set ACL's on remote CIFS servers. </para> 120 139 </listitem> … … 122 141 123 142 <varlistentry> 124 <term><citerefentry><refentrytitle>smbsh</refentrytitle>125 <manvolnum>1</manvolnum></citerefentry></term>126 <listitem><para>The <command>smbsh</command> command is127 a program that allows you to run a unix shell with128 with an overloaded VFS.</para></listitem>129 </varlistentry>130 131 <varlistentry>132 143 <term><citerefentry><refentrytitle>smbtree</refentrytitle> 133 144 <manvolnum>1</manvolnum></citerefentry></term> 134 <listitem><para>The <command>smbtree</command> command 145 <listitem><para>The <command>smbtree</command> command 135 146 is a text-based network neighborhood tool.</para></listitem> 136 147 </varlistentry> … … 139 150 <term><citerefentry><refentrytitle>smbtar</refentrytitle> 140 151 <manvolnum>1</manvolnum></citerefentry></term> 141 <listitem><para>The <command>smbtar</command> can make 152 <listitem><para>The <command>smbtar</command> can make 142 153 backups of data on CIFS/SMB servers.</para></listitem> 143 154 </varlistentry> … … 146 157 <term><citerefentry><refentrytitle>smbspool</refentrytitle> 147 158 <manvolnum>8</manvolnum></citerefentry></term> 148 <listitem><para><command>smbspool</command> is a 149 helper utility for printing on printers connected 159 <listitem><para><command>smbspool</command> is a 160 helper utility for printing on printers connected 150 161 to CIFS servers. </para></listitem> 151 162 </varlistentry> … … 155 166 <manvolnum>1</manvolnum></citerefentry></term> 156 167 <listitem><para><command>smbcontrol</command> is a utility 157 that can change the behaviour of running samba daemons. 168 that can change the behaviour of running 169 <command>smbd</command>, <command>nmbd</command> and 170 <command>winbindd</command> daemons. 158 171 </para></listitem> 159 172 </varlistentry> … … 163 176 <manvolnum>1</manvolnum></citerefentry></term> 164 177 <listitem><para><command>rpcclient</command> is a utility 165 that can be used to execute RPC commands on remote 178 that can be used to execute RPC commands on remote 166 179 CIFS servers.</para></listitem> 167 180 </varlistentry> … … 170 183 <term><citerefentry><refentrytitle>pdbedit</refentrytitle> 171 184 <manvolnum>8</manvolnum></citerefentry></term> 172 <listitem><para>The <command>pdbedit</command> command 173 can be used to maintain the local user database on 185 <listitem><para>The <command>pdbedit</command> command 186 can be used to maintain the local user database on 174 187 a samba server.</para></listitem></varlistentry> 175 188 … … 177 190 <term><citerefentry><refentrytitle>findsmb</refentrytitle> 178 191 <manvolnum>1</manvolnum></citerefentry></term> 179 <listitem><para>The <command>findsmb</command> command 192 <listitem><para>The <command>findsmb</command> command 180 193 can be used to find SMB servers on the local network. 181 194 </para></listitem></varlistentry> … … 184 197 <term><citerefentry><refentrytitle>net</refentrytitle> 185 198 <manvolnum>8</manvolnum></citerefentry></term> 186 <listitem><para>The <command>net</command> command 199 <listitem><para>The <command>net</command> command 187 200 is supposed to work similar to the DOS/Windows 188 201 NET.EXE command.</para></listitem> … … 190 203 191 204 <varlistentry> 192 <term><citerefentry><refentrytitle>swat</refentrytitle>193 <manvolnum>8</manvolnum></citerefentry></term>194 <listitem><para><command>swat</command> is a web-based195 interface to configuring <filename>smb.conf</filename>.196 </para></listitem>197 </varlistentry>198 199 <varlistentry>200 <term><citerefentry><refentrytitle>winbindd</refentrytitle>201 <manvolnum>8</manvolnum></citerefentry></term>202 <listitem><para><command>winbindd</command> is a daemon203 that is used for integrating authentication and204 the user database into unix.</para></listitem>205 </varlistentry>206 207 <varlistentry>208 205 <term><citerefentry><refentrytitle>wbinfo</refentrytitle> 209 206 <manvolnum>1</manvolnum></citerefentry></term> 210 <listitem><para><command>wbinfo</command> is a utility 207 <listitem><para><command>wbinfo</command> is a utility 211 208 that retrieves and stores information related to winbind. 212 209 </para></listitem> … … 225 222 <term><citerefentry><refentrytitle>log2pcap</refentrytitle> 226 223 <manvolnum>1</manvolnum></citerefentry></term> 227 <listitem><para><command>log2pcap</command> is a utility 228 for generating pcap trace files from Samba log 224 <listitem><para><command>log2pcap</command> is a utility 225 for generating pcap trace files from Samba log 229 226 files.</para></listitem> 230 227 </varlistentry> … … 245 242 246 243 <varlistentry> 247 <term>248 <citerefentry><refentrytitle>smbmount</refentrytitle><manvolnum>8</manvolnum></citerefentry>,249 <citerefentry><refentrytitle>smbumount</refentrytitle><manvolnum>8</manvolnum></citerefentry>,250 <citerefentry><refentrytitle>smbmnt</refentrytitle><manvolnum>8</manvolnum></citerefentry></term>251 <listitem><para><command>smbmount</command>,<command>smbumount</command> and <command>smbmnt</command> are commands that can be used to252 mount CIFS/SMB shares on Linux.253 </para></listitem>254 </varlistentry>255 256 <varlistentry>257 244 <term><citerefentry><refentrytitle>smbcquotas</refentrytitle> 258 245 <manvolnum>1</manvolnum></citerefentry></term> 259 <listitem><para><command>smbcquotas</command> is a tool that 246 <listitem><para><command>smbcquotas</command> is a tool that 260 247 can set remote QUOTA's on server with NTFS 5. </para> 261 248 </listitem> … … 266 253 <refsect1> 267 254 <title>COMPONENTS</title> 268 269 <para>The Samba suite is made up of several components. Each 270 component is described in a separate manual page. It is strongly 271 recommended that you read the documentation that comes with Samba 272 and the manual pages of those components that you use. If the 255 256 <para>The Samba suite is made up of several components. Each 257 component is described in a separate manual page. It is strongly 258 recommended that you read the documentation that comes with Samba 259 and the manual pages of those components that you use. If the 273 260 manual pages and documents aren't clear enough then please visit 274 261 <ulink url="http://devel.samba.org/">http://devel.samba.org</ulink> … … 283 270 <refsect1> 284 271 <title>AVAILABILITY</title> 285 286 <para>The Samba software suite is licensed under the 287 GNU Public License(GPL). A copy of that license should 288 have come with the package in the file COPYING. You are 289 encouraged to distribute copies of the Samba suite, but 272 273 <para>The Samba software suite is licensed under the 274 GNU Public License(GPL). A copy of that license should 275 have come with the package in the file COPYING. You are 276 encouraged to distribute copies of the Samba suite, but 290 277 please obey the terms of this license.</para> 291 278 292 <para>The latest version of the Samba suite can be 279 <para>The latest version of the Samba suite can be 293 280 obtained via anonymous ftp from samba.org in the 294 directory pub/samba/. It is also available on several 281 directory pub/samba/. It is also available on several 295 282 mirror sites worldwide.</para> 296 297 <para>You may also find useful information about Samba 283 284 <para>You may also find useful information about Samba 298 285 on the newsgroup <ulink url="news:comp.protocols.smb"> 299 comp.protocol.smb</ulink> and the Samba mailing 300 list. Details on how to join the mailing list are given in 286 comp.protocol.smb</ulink> and the Samba mailing 287 list. Details on how to join the mailing list are given in 301 288 the README file that comes with Samba.</para> 302 289 303 290 <para>If you have access to a WWW viewer (such as Mozilla 304 or Konqueror) then you will also find lots of useful information, 291 or Konqueror) then you will also find lots of useful information, 305 292 including back issues of the Samba mailing list, at 306 293 <ulink url="http://lists.samba.org/">http://lists.samba.org</ulink>.</para> … … 309 296 <refsect1> 310 297 <title>VERSION</title> 311 312 <para>This man page is correct for version 3 of the298 299 <para>This man page is correct for version 4 of the 313 300 Samba suite. </para> 314 301 </refsect1> … … 316 303 <refsect1> 317 304 <title>CONTRIBUTIONS</title> 318 319 <para>If you wish to contribute to the Samba project, 320 then I suggest you join the Samba mailing list at 305 306 <para>If you wish to contribute to the Samba project, 307 then I suggest you join the Samba mailing list at 321 308 <ulink url="http://lists.samba.org/">http://lists.samba.org</ulink>. 322 309 </para> … … 324 311 <para>If you have patches to submit, visit 325 312 <ulink url="http://devel.samba.org/">http://devel.samba.org/</ulink> 326 for information on how to do it properly. We prefer patches 327 in <command> diff -u</command> format.</para>313 for information on how to do it properly. We prefer patches 314 in <command>git format-patch</command> format.</para> 328 315 </refsect1> 329 316 330 317 <refsect1> 331 318 <title>CONTRIBUTORS</title> 332 333 <para>Contributors to the project are now too numerous 334 to mention here but all deserve the thanks of all Samba 319 320 <para>Contributors to the project are now too numerous 321 to mention here but all deserve the thanks of all Samba 335 322 users. To see a full list, look at the 336 <filename>change-log</filename> in the source package 337 for the pre-CVS changes and at <ulink 338 url="http:// cvs.samba.org/">339 http:// cvs.samba.org/</ulink>340 for the contributors to Samba post- CVS. CVS is the Open Source341 source code control system used by the Samba Team to develop 323 <filename>change-log</filename> in the source package 324 for the pre-CVS changes and at <ulink 325 url="http://git.samba.org/"> 326 http://git.samba.org/</ulink> 327 for the contributors to Samba post-GIT. GIT is the Open Source 328 source code control system used by the Samba Team to develop 342 329 Samba. The project would have been unmanageable without it.</para> 343 330 </refsect1> … … 345 332 <refsect1> 346 333 <title>AUTHOR</title> 347 348 <para>The original Samba software and related utilities 334 335 <para>The original Samba software and related utilities 349 336 were created by Andrew Tridgell. Samba is now developed 350 by the Samba Team as an Open Source project similar 337 by the Samba Team as an Open Source project similar 351 338 to the way the Linux kernel is developed.</para> 352 353 <para>The original Samba man pages were written by Karl Auer. 354 The man page sources were converted to YODL format (another 339 340 <para>The original Samba man pages were written by Karl Auer. 341 The man page sources were converted to YODL format (another 355 342 excellent piece of Open Source software, available at <ulink url="ftp://ftp.icce.rug.nl/pub/unix/"> 356 ftp://ftp.icce.rug.nl/pub/unix/</ulink>) and updated for the Samba 2.0 357 release by Jeremy Allison. The conversion to DocBook for 343 ftp://ftp.icce.rug.nl/pub/unix/</ulink>) and updated for the Samba 2.0 344 release by Jeremy Allison. The conversion to DocBook for 358 345 Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 359 346 4.2 for Samba 3.0 was done by Alexander Bokovoy.</para> -
vendor/current/docs-xml/manpages/sharesec.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 27 27 <arg choice="opt">-D, --delete</arg> 28 28 <arg choice="opt">-v, --view</arg> 29 <arg choice="opt">--view-all</arg> 29 30 <arg choice="opt">-M, --machine-sid</arg> 30 31 <arg choice="opt">-F, --force</arg> … … 32 33 <arg choice="opt">-s, --configfile=CONFIGFILE</arg> 33 34 <arg choice="opt">-l, --log-basename=LOGFILEBASE</arg> 34 <arg choice="opt">- V, --version</arg>35 <arg choice="opt">--version</arg> 35 36 <arg choice="opt">-?, --help</arg> 36 37 <arg choice="opt">--usage</arg> 38 <arg choice="opt">-S, --setsddl=STRING</arg> 39 <arg choice="opt">-V, --viewsddl</arg> 37 40 </cmdsynopsis> 38 41 </refsynopsisdiv> … … 96 99 <listitem><para> 97 100 Overwrite an existing share permission ACL. 101 </para></listitem> 102 </varlistentry> 103 104 <varlistentry> 105 <term>-v|--view</term> 106 <listitem><para> 107 List a share acl 108 </para></listitem> 109 </varlistentry> 110 111 <varlistentry> 112 <term>--view-all</term> 113 <listitem><para> 114 List all share acls 115 </para></listitem> 116 </varlistentry> 117 118 <varlistentry> 119 <term>-S|--setsddl=STRING</term> 120 <listitem><para> 121 Set security descriptor by providing ACL in SDDL format. 122 </para></listitem> 123 </varlistentry> 124 125 <varlistentry> 126 <term>-V|--viewsddl</term> 127 <listitem><para> 128 List a share acl in SDDL format. 98 129 </para></listitem> 99 130 </varlistentry> … … 124 155 cause strange behaviour.</para> 125 156 126 <para>The owner and group specify the owner and group SIDs for the 127 object. If a SID in the format S-1-x-y-z is specified this is used, 128 otherwise the name specified is resolved using the server on which 129 the file or directory resides.</para> 157 <para>The owner and group specify the owner and group SIDs for 158 the object. Share ACLs do not specify an owner or a group, so 159 these fields are empty.</para> 130 160 131 161 <para>ACLs specify permissions granted to the SID. This SID … … 197 227 host:~ # sharesec share -v 198 228 REVISION:1 199 OWNER:(NULL SID) 200 GROUP:(NULL SID) 201 ACL:S-1-1-0:ALLOWED/0/0x101f01ff 202 ACL:S-1-5-21-1866488690-1365729215-3963860297-17724:ALLOWED/0/FULL 229 CONTROL:SR|DP 230 OWNER: 231 GROUP: 232 ACL:S-1-1-0:ALLOWED/0x0/FULL 233 ACL:S-1-5-21-1866488690-1365729215-3963860297-17724:ALLOWED/0x0/FULL 203 234 </programlisting> 204 235 </refsect1> -
vendor/current/docs-xml/manpages/smb.conf.5.xml
r860 r988 7 7 <refmiscinfo class="source">Samba</refmiscinfo> 8 8 <refmiscinfo class="manual">File Formats and Conventions</refmiscinfo> 9 <refmiscinfo class="version"> 3.6</refmiscinfo>9 <refmiscinfo class="version">4.4</refmiscinfo> 10 10 </refmeta> 11 11 … … 22 22 The <filename moreinfo="none">smb.conf</filename> file is a configuration file for the Samba suite. <filename 23 23 moreinfo="none">smb.conf</filename> contains runtime configuration information for the Samba programs. The 24 <filename moreinfo="none">smb.conf</filename> file is designed to be configured and administered by the25 <citerefentry><refentrytitle>swat</refentrytitle> <manvolnum>8</manvolnum></citerefentry> program. The26 24 complete description of the file format and possible parameters held within are here for reference purposes. 27 </para> 25 </para> 28 26 </refsect1> 29 27 … … 473 471 <varlistentry> 474 472 <term>%R</term> 475 <listitem><para>the selected protocol level after protocol negotiation. It can be one of CORE, COREPLUS, 476 LANMAN1, LANMAN2 or NT1.</para></listitem> 473 <listitem><para>the selected protocol level after protocol negotiation. It can be one of 474 CORE, COREPLUS, LANMAN1, LANMAN2, NT1, 475 SMB2_02, SMB2_10, SMB2_22, SMB2_24, 476 SMB3_00, SMB3_02, SMB3_10, SMB3_11 477 or SMB2_FF.</para></listitem> 477 478 </varlistentry> 478 479 … … 504 505 <term>%I</term> 505 506 <listitem><para>the IP address of the client machine.</para> 506 <para>Before 3.6.0 it could contain IPv4 mapped IPv6 addresses,507 <para>Before 4.0.0 it could contain IPv4 mapped IPv6 addresses, 507 508 now it only contains IPv4 or IPv6 addresses.</para> 508 509 </listitem> … … 512 513 <term>%i</term> 513 514 <listitem><para>the local IP address to which a client connected.</para> 514 <para>Before 3.6.0 it could contain IPv4 mapped IPv6 addresses,515 <para>Before 4.0.0 it could contain IPv4 mapped IPv6 addresses, 515 516 now it only contains IPv4 or IPv6 addresses.</para> 516 517 </listitem> … … 671 672 </refsect1> 672 673 673 <refsect1 id="VALIDATIONSECT">674 <title>NOTE ABOUT USERNAME/PASSWORD VALIDATION</title>675 676 <para>677 There are a number of ways in which a user can connect to a service. The server uses the following steps678 in determining if it will allow a connection to a specified service. If all the steps fail, the connection679 request is rejected. However, if one of the steps succeeds, the following steps are not checked.680 </para>681 682 <para>683 If the service is marked <quote>guest only = yes</quote> and the server is running with share-level684 security (<quote>security = share</quote>, steps 1 to 5 are skipped.685 </para>686 687 688 <orderedlist continuation="restarts" inheritnum="ignore" numeration="arabic">689 <listitem><para>690 If the client has passed a username/password pair and that username/password pair is validated by the UNIX691 system's password programs, the connection is made as that username. This includes the692 <literal>\\server\service</literal>%<replaceable>username</replaceable> method of passing a username.693 </para></listitem>694 695 <listitem><para>696 If the client has previously registered a username with the system and now supplies a correct password for that697 username, the connection is allowed.698 </para></listitem>699 700 <listitem><para>701 The client's NetBIOS name and any previously used usernames are checked against the supplied password. If702 they match, the connection is allowed as the corresponding user.703 </para></listitem>704 705 <listitem><para>706 If the client has previously validated a username/password pair with the server and the client has passed707 the validation token, that username is used.708 </para></listitem>709 710 <listitem><para>711 If a <literal>user = </literal> field is given in the <filename moreinfo="none">smb.conf</filename> file for the712 service and the client has supplied a password, and that password matches (according to the UNIX system's713 password checking) with one of the usernames from the <literal>user =</literal> field, the connection is made as714 the username in the <literal>user =</literal> line. If one of the usernames in the <literal>user =</literal> list715 begins with a <literal>@</literal>, that name expands to a list of names in the group of the same name.716 </para></listitem>717 718 <listitem><para>719 If the service is a guest service, a connection is made as the username given in the <literal>guest account720 =</literal> for the service, irrespective of the supplied password.721 </para></listitem>722 </orderedlist>723 724 </refsect1>725 726 674 <refsect1> 727 675 <title>REGISTRY-BASED CONFIGURATION</title> … … 811 759 812 760 <samba:parameterlist> 813 <xi:include href="../smbdotconf/parameters.all.xml" parse="xml"/> 761 <!-- The URI below is resolved to local generated version of parameters.all.xml //--> 762 <!-- WAF build places it in bin/default/docs-xml/smbdotconf/parameters.all.xml //--> 763 <!-- and we redirect there via use of XML_CATALOG_FILES, see docs-xml/build/catalog.xml.in //--> 764 <xi:include href="http://www.samba.org/samba/smbdotconf/parameters.all.xml" parse="xml"/> 814 765 </samba:parameterlist> 815 766 … … 843 794 <title>VERSION</title> 844 795 845 <para>This man page is correct for version 3of the Samba suite.</para>796 <para>This man page is correct for version 4 of the Samba suite.</para> 846 797 </refsect1> 847 798 … … 851 802 <citerefentry><refentrytitle>samba</refentrytitle> 852 803 <manvolnum>7</manvolnum></citerefentry>, <citerefentry><refentrytitle>smbpasswd</refentrytitle> 853 <manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>swat</refentrytitle>854 804 <manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>smbd</refentrytitle> 855 805 <manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>nmbd</refentrytitle> 806 <manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>winbindd</refentrytitle> 807 <manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>samba</refentrytitle> 808 <manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>samba-tool</refentrytitle> 856 809 <manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>smbclient</refentrytitle> 857 810 <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>nmblookup</refentrytitle> 858 811 <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>testparm</refentrytitle> 859 <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>testprns</refentrytitle>860 812 <manvolnum>1</manvolnum></citerefentry>.</para> 861 813 </refsect1> -
vendor/current/docs-xml/manpages/smbcacls.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 22 22 <arg choice="req">//server/share</arg> 23 23 <arg choice="req">/filename</arg> 24 <arg choice="opt">-D|--delete acl s</arg>25 <arg choice="opt">-M|--modify acl s</arg>26 <arg choice="opt">-a|--add acl s</arg>27 <arg choice="opt">-S|--set acl s</arg>24 <arg choice="opt">-D|--delete acl</arg> 25 <arg choice="opt">-M|--modify acl</arg> 26 <arg choice="opt">-a|--add acl</arg> 27 <arg choice="opt">-S|--set acl</arg> 28 28 <arg choice="opt">-C|--chown name</arg> 29 29 <arg choice="opt">-G|--chgrp name</arg> 30 <arg choice="opt">-I allow|r omove|copy</arg>30 <arg choice="opt">-I allow|remove|copy</arg> 31 31 <arg choice="opt">--numeric</arg> 32 32 <arg choice="opt">-t</arg> 33 33 <arg choice="opt">-U username</arg> 34 <arg choice="opt">-h</arg>35 34 <arg choice="opt">-d</arg> 35 <arg choice="opt">-e</arg> 36 <arg choice="opt">-m|--max-protocol LEVEL</arg> 37 <arg choice="opt">--query-security-info FLAGS</arg> 38 <arg choice="opt">--set-security-info FLAGS</arg> 39 <arg choice="opt">--sddl</arg> 40 <arg choice="opt">--domain-sid SID</arg> 36 41 </cmdsynopsis> 37 42 </refsynopsisdiv> … … 44 49 45 50 <para>The <command>smbcacls</command> program manipulates NT Access Control 46 Lists (ACLs) on SMB file shares. </para> 51 Lists (ACLs) on SMB file shares. An ACL is comprised zero or more Access 52 Control Entries (ACEs), which define access restrictions for a specific 53 user or group.</para> 47 54 </refsect1> 48 55 … … 57 64 <variablelist> 58 65 <varlistentry> 59 <term>-a|--add acl s</term>60 <listitem><para>Add the ACLs specified to the ACL list. Existing61 access control entries are unchanged. 62 </varlistentry> 63 64 65 66 <varlistentry> 67 <term>-M|--modify acl s</term>68 <listitem><para>Modify the mask value (permissions) for the AC Ls66 <term>-a|--add acl</term> 67 <listitem><para>Add the entries specified to the ACL. Existing 68 access control entries are unchanged.</para></listitem> 69 </varlistentry> 70 71 72 73 <varlistentry> 74 <term>-M|--modify acl</term> 75 <listitem><para>Modify the mask value (permissions) for the ACEs 69 76 specified on the command line. An error will be printed for each 70 AC L specified that was not already present in the ACL list71 </para></listitem> 72 </varlistentry> 73 74 75 76 <varlistentry> 77 <term>-D|--delete acl s</term>78 <listitem><para>Delete any AC Ls specified on the command line.79 An error will be printed for each AC L specified that was not80 already present in the ACL list. </para></listitem>81 </varlistentry> 82 83 84 85 <varlistentry> 86 <term>-S|--set acl s</term>87 <listitem><para>This command sets the ACL s on the file with88 only the ones specified on the command line. All other ACLs are89 erased. Note that the ACL specified must contain at least a revision,77 ACE specified that was not already present in the object's ACL. 78 </para></listitem> 79 </varlistentry> 80 81 82 83 <varlistentry> 84 <term>-D|--delete acl</term> 85 <listitem><para>Delete any ACEs specified on the command line. 86 An error will be printed for each ACE specified that was not 87 already present in the object's ACL. </para></listitem> 88 </varlistentry> 89 90 91 92 <varlistentry> 93 <term>-S|--set acl</term> 94 <listitem><para>This command sets the ACL on the object with 95 only what is specified on the command line. Any existing ACL 96 is erased. Note that the ACL specified must contain at least a revision, 90 97 type, owner and group for the call to succeed. </para></listitem> 91 98 </varlistentry> … … 131 138 132 139 133 134 140 <varlistentry> 135 141 <term>--numeric</term> … … 140 146 141 147 <varlistentry> 148 <term>-m|--max-protocol PROTOCOL_NAME</term> 149 <listitem><para>This allows the user to select the 150 highest SMB protocol level that smbcacls will use to 151 connect to the server. By default this is set to 152 NT1, which is the highest available SMB1 protocol. 153 To connect using SMB2 or SMB3 protocol, use the 154 strings SMB2 or SMB3 respectively. Note that to connect 155 to a Windows 2012 server with encrypted transport selecting 156 a max-protocol of SMB3 is required. 157 </para></listitem> 158 </varlistentry> 159 160 <varlistentry> 142 161 <term>-t|--test-args</term> 143 162 <listitem><para> … … 146 165 </para></listitem> 147 166 </varlistentry> 148 149 &stdarg.help; 167 168 <varlistentry> 169 <term>--query-security-info FLAGS</term> 170 <listitem><para>The security-info flags for queries. 171 </para></listitem> 172 </varlistentry> 173 174 <varlistentry> 175 <term>--set-security-info FLAGS</term> 176 <listitem><para>The security-info flags for queries. 177 </para></listitem> 178 </varlistentry> 179 180 <varlistentry> 181 <term>--sddl</term> 182 <listitem><para>Output and input acls in sddl format. 183 </para></listitem> 184 </varlistentry> 185 186 <varlistentry> 187 <term>--domain-sid SID</term> 188 <listitem><para>SID used for sddl processing. 189 </para></listitem> 190 </varlistentry> 191 150 192 &stdarg.server.debug; 151 193 &popt.common.samba; 152 194 &popt.common.credentials; 195 &popt.common.connection; 196 &popt.autohelp; 153 197 </variablelist> 154 198 </refsect1> … … 158 202 <title>ACL FORMAT</title> 159 203 160 <para>The format of an ACL is one or more ACL entries separated by204 <para>The format of an ACL is one or more entries separated by 161 205 either commas or newlines. An ACL entry is one of the following: </para> 162 206 … … 179 223 the file or directory resides. </para> 180 224 181 <para>AC Ls specify permissions granted to the SID. This SID again182 can be specified in S-1-x-y-z format or as a name in which case183 it is resolved against the server on which the file or directory184 resides. The type, flags and mask values determine the type of185 access granted to the SID. </para>225 <para>ACEs are specified with an "ACL:" prefix, and define permissions 226 granted to an SID. The SID again can be specified in S-1-x-y-z format 227 or as a name in which case it is resolved against the server on which 228 the file or directory resides. The type, flags and mask values 229 determine the type of access granted to the SID. </para> 186 230 187 231 <para>The type can be either ALLOWED or DENIED to allow/deny access 188 to the SID. The flags values are generally zero for file AC Ls and189 either 9 or 2 for directory AC Ls. Some common flags are: </para>232 to the SID. The flags values are generally zero for file ACEs and 233 either 9 or 2 for directory ACEs. Some common flags are: </para> 190 234 191 235 <itemizedlist> … … 196 240 </itemizedlist> 197 241 198 <para>At present flags can only be specified as decimal or242 <para>At present, flags can only be specified as decimal or 199 243 hexadecimal values.</para> 200 244 … … 244 288 <title>VERSION</title> 245 289 246 <para>This man page is correct for version 3of the Samba suite.</para>290 <para>This man page is correct for version 4 of the Samba suite.</para> 247 291 </refsect1> 248 292 -
vendor/current/docs-xml/manpages/smbclient.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 38 38 <arg choice="opt">-R <name resolve order></arg> 39 39 <arg choice="opt">-s <smb config file></arg> 40 <arg choice="opt">-t <per-operation timeout in seconds></arg> 40 41 <arg choice="opt">-k</arg> 41 42 <arg choice="opt">-P</arg> … … 68 69 <arg choice="opt">-R <name resolve order></arg> 69 70 <arg choice="opt">-s <smb config file></arg> 71 <arg choice="opt">-t <per-operation timeout in seconds></arg> 70 72 <arg choice="opt">-T<c|x>IXFqgbNan</arg> 71 73 <arg choice="opt">-k</arg> … … 79 81 <manvolnum>7</manvolnum></citerefentry> suite.</para> 80 82 81 <para><command>smbclient</command> is a client that can 83 <para><command>smbclient</command> is a client that can 82 84 'talk' to an SMB/CIFS server. It offers an interface 83 85 similar to that of the ftp program (see <citerefentry><refentrytitle>ftp</refentrytitle> 84 <manvolnum>1</manvolnum></citerefentry>). 85 Operations include things like getting files from the server 86 to the local machine, putting files from the local machine to 87 the server, retrieving directory information from the server 86 <manvolnum>1</manvolnum></citerefentry>). 87 Operations include things like getting files from the server 88 to the local machine, putting files from the local machine to 89 the server, retrieving directory information from the server 88 90 and so on. </para> 89 91 </refsect1> … … 92 94 <refsect1> 93 95 <title>OPTIONS</title> 94 96 95 97 <variablelist> 96 98 <varlistentry> 97 99 <term>servicename</term> 98 <listitem><para>servicename is the name of the service 100 <listitem><para>servicename is the name of the service 99 101 you want to use on the server. A service name takes the form 100 102 <filename>//server/service</filename> where <parameter>server 101 </parameter> is the NetBIOS name of the SMB/CIFS server 102 offering the desired service and <parameter>service</parameter> 103 is the name of the service offered. Thus to connect to103 </parameter> is the NetBIOS name of the SMB/CIFS server 104 offering the desired service and <parameter>service</parameter> 105 is the name of the service offered. Thus to connect to 104 106 the service "printer" on the SMB/CIFS server "smbserver", 105 107 you would use the servicename <filename>//smbserver/printer 106 108 </filename></para> 107 109 108 <para>Note that the server name required is NOT necessarily 109 the IP (DNS) host name of the server ! The name required is110 <para>Note that the server name required is NOT necessarily 111 the IP (DNS) host name of the server ! The name required is 110 112 a NetBIOS server name, which may or may not be the 111 113 same as the IP hostname of the machine running the server. 112 114 </para> 113 115 114 <para>The server name is looked up according to either 115 the <parameter>-R</parameter> parameter to <command>smbclient</command> or 116 using the name resolve order parameter in 116 <para>The server name is looked up according to either 117 the <parameter>-R</parameter> parameter to <command>smbclient</command> or 118 using the name resolve order parameter in 117 119 the <citerefentry><refentrytitle>smb.conf</refentrytitle> 118 <manvolnum>5</manvolnum></citerefentry> file, 119 allowing an administrator to change the order and methods 120 <manvolnum>5</manvolnum></citerefentry> file, 121 allowing an administrator to change the order and methods 120 122 by which server names are looked up. </para></listitem> 121 123 </varlistentry> … … 123 125 <varlistentry> 124 126 <term>password</term> 125 <listitem><para>The password required to access the specified 126 service on the specified server. If this parameter is 127 supplied, the <parameter>-N</parameter> option (suppress 127 <listitem><para>The password required to access the specified 128 service on the specified server. If this parameter is 129 supplied, the <parameter>-N</parameter> option (suppress 128 130 password prompt) is assumed. </para> 129 131 130 <para>There is no default password. If no password is supplied 131 on the command line (either by using this parameter or adding 132 a password to the <parameter>-U</parameter> option (see 133 below)) and the <parameter>-N</parameter> option is not 134 specified, the client will prompt for a password, even if 135 the desired service does not require one. (If no password is 132 <para>There is no default password. If no password is supplied 133 on the command line (either by using this parameter or adding 134 a password to the <parameter>-U</parameter> option (see 135 below)) and the <parameter>-N</parameter> option is not 136 specified, the client will prompt for a password, even if 137 the desired service does not require one. (If no password is 136 138 required, simply press ENTER to provide a null password.) 137 139 </para> 138 140 139 <para>Note: Some servers (including OS/2 and Windows for 140 Workgroups) insist on an uppercase password. Lowercase 141 or mixed case passwords may be rejected by these servers. 141 <para>Note: Some servers (including OS/2 and Windows for 142 Workgroups) insist on an uppercase password. Lowercase 143 or mixed case passwords may be rejected by these servers. 142 144 </para> 143 145 … … 145 147 </para></listitem> 146 148 </varlistentry> 147 149 148 150 <varlistentry> 149 151 <term>-R|--name-resolve <name resolve order></term> 150 <listitem><para>This option is used by the programs in the Samba 151 suite to determine what naming services and in what order to resolve 152 host names to IP addresses. The option takes a space-separated 152 <listitem><para>This option is used by the programs in the Samba 153 suite to determine what naming services and in what order to resolve 154 host names to IP addresses. The option takes a space-separated 153 155 string of different name resolution options.</para> 154 156 155 <para>The options are :"lmhosts", "host", "wins" and "bcast". They 157 <para>The options are :"lmhosts", "host", "wins" and "bcast". They 156 158 cause names to be resolved as follows:</para> 157 159 158 160 <itemizedlist> 159 <listitem><para><constant>lmhosts</constant>: Lookup an IP 160 address in the Samba lmhosts file. If the line in lmhosts has 161 no name type attached to the NetBIOS name (see 161 <listitem><para><constant>lmhosts</constant>: Lookup an IP 162 address in the Samba lmhosts file. If the line in lmhosts has 163 no name type attached to the NetBIOS name (see 162 164 the <citerefentry><refentrytitle>lmhosts</refentrytitle> 163 165 <manvolnum>5</manvolnum></citerefentry> for details) then 164 166 any name type matches for lookup.</para> 165 167 </listitem> 166 167 <listitem><para><constant>host</constant>: Do a standard host 168 169 <listitem><para><constant>host</constant>: Do a standard host 168 170 name to IP address resolution, using the system <filename>/etc/hosts 169 </filename>, NIS, or DNS lookups. This method of name resolution 170 is operating system dependent, for instance on IRIX or Solaris this 171 may be controlled by the <filename>/etc/nsswitch.conf</filename> 172 file). Note that this method is only used if the NetBIOS name173 type being queried is the 0x20 (server) name type, otherwise 171 </filename>, NIS, or DNS lookups. This method of name resolution 172 is operating system dependent, for instance on IRIX or Solaris this 173 may be controlled by the <filename>/etc/nsswitch.conf</filename> 174 file). Note that this method is only used if the NetBIOS name 175 type being queried is the 0x20 (server) name type, otherwise 174 176 it is ignored.</para> 175 177 </listitem> 176 177 <listitem><para><constant>wins</constant>: Query a name with 178 179 <listitem><para><constant>wins</constant>: Query a name with 178 180 the IP address listed in the <parameter>wins server</parameter> 179 parameter. 181 parameter. If no WINS server has 180 182 been specified this method will be ignored.</para> 181 183 </listitem> 182 183 <listitem><para><constant>bcast</constant>: Do a broadcast on 184 each of the known local interfaces listed in the 184 185 <listitem><para><constant>bcast</constant>: Do a broadcast on 186 each of the known local interfaces listed in the 185 187 <parameter>interfaces</parameter> 186 parameter. This is the least reliable of the name resolution 187 methods as it depends on the target host being on a locally 188 parameter. This is the least reliable of the name resolution 189 methods as it depends on the target host being on a locally 188 190 connected subnet.</para> 189 191 </listitem> 190 192 </itemizedlist> 191 193 192 <para>If this parameter is not set then the name resolve order 194 <para>If this parameter is not set then the name resolve order 193 195 defined in the <citerefentry><refentrytitle>smb.conf</refentrytitle> 194 <manvolnum>5</manvolnum></citerefentry> file parameter 196 <manvolnum>5</manvolnum></citerefentry> file parameter 195 197 (name resolve order) will be used. </para> 196 198 197 <para>The default order is lmhosts, host, wins, bcast and without 199 <para>The default order is lmhosts, host, wins, bcast and without 198 200 this parameter or any entry in the <parameter>name resolve order 199 201 </parameter> parameter of the <citerefentry><refentrytitle>smb.conf</refentrytitle> … … 201 203 methods will be attempted in this order. </para></listitem> 202 204 </varlistentry> 203 204 205 206 205 207 <varlistentry> 206 208 <term>-M|--message NetBIOS name</term> 207 <listitem><para>This options allows you to send messages, using 208 the "WinPopup" protocol, to another computer. Once a connection is 209 established you then type your message, pressing ^D (control-D) to 209 <listitem><para>This options allows you to send messages, using 210 the "WinPopup" protocol, to another computer. Once a connection is 211 established you then type your message, pressing ^D (control-D) to 210 212 end. </para> 211 213 212 <para>If the receiving computer is running WinPopup the user will 213 receive the message and probably a beep. If they are not running 214 WinPopup the message will be lost, and no error message will 214 <para>If the receiving computer is running WinPopup the user will 215 receive the message and probably a beep. If they are not running 216 WinPopup the message will be lost, and no error message will 215 217 occur. </para> 216 218 217 <para>The message is also automatically truncated if the message 218 is over 1600 bytes, as this is the limit of the protocol. 219 <para>The message is also automatically truncated if the message 220 is over 1600 bytes, as this is the limit of the protocol. 219 221 </para> 220 222 221 223 <para> 222 One useful trick is to pipe the message through <command>smbclient</command>. 223 For example: smbclient -M FRED < mymessage.txt will send the 224 message in the file <filename>mymessage.txt</filename> to the 224 One useful trick is to pipe the message through <command>smbclient</command>. 225 For example: smbclient -M FRED < mymessage.txt will send the 226 message in the file <filename>mymessage.txt</filename> to the 225 227 machine FRED. 226 228 </para> 227 229 228 <para>You may also find the <parameter>-U</parameter> and 229 <parameter>-I</parameter> options useful, as they allow you to 230 <para>You may also find the <parameter>-U</parameter> and 231 <parameter>-I</parameter> options useful, as they allow you to 230 232 control the FROM and TO parts of the message. </para> 231 233 232 234 <para>See the <parameter>message command</parameter> parameter in the <citerefentry><refentrytitle>smb.conf</refentrytitle> 233 <manvolnum>5</manvolnum></citerefentry> for a description of how to handle incoming 235 <manvolnum>5</manvolnum></citerefentry> for a description of how to handle incoming 234 236 WinPopup messages in Samba. </para> 235 237 236 <para><emphasis>Note</emphasis>: Copy WinPopup into the startup group 237 on your WfWg PCs if you want them to always be able to receive 238 <para><emphasis>Note</emphasis>: Copy WinPopup into the startup group 239 on your WfWg PCs if you want them to always be able to receive 238 240 messages. </para></listitem> 239 241 </varlistentry> … … 241 243 <varlistentry> 242 244 <term>-p|--port port</term> 243 <listitem><para>This number is the TCP port number that will be used 245 <listitem><para>This number is the TCP port number that will be used 244 246 when making connections to the server. The standard (well-known) 245 TCP port number for an SMB/CIFS server is 139, which is the 247 TCP port number for an SMB/CIFS server is 139, which is the 246 248 default. </para></listitem> 247 249 </varlistentry> … … 257 259 <varlistentry> 258 260 <term>-m|--max-protocol protocol</term> 259 <listitem><para>This parameter sets the maximum protocol version announced by the client. 261 <listitem><para>This allows the user to select the 262 highest SMB protocol level that smbclient will use to 263 connect to the server. By default this is set to 264 NT1, which is the highest available SMB1 protocol. 265 To connect using SMB2 or SMB3 protocol, use the 266 strings SMB2 or SMB3 respectively. Note that to connect 267 to a Windows 2012 server with encrypted transport selecting 268 a max-protocol of SMB3 is required. 260 269 </para></listitem> 261 270 </varlistentry> … … 268 277 </varlistentry> 269 278 270 &stdarg.help;271 272 279 <varlistentry> 273 280 <term>-I|--ip-address IP-address</term> … … 275 282 It should be specified in standard "a.b.c.d" notation. </para> 276 283 277 <para>Normally the client would attempt to locate a named 278 SMB/CIFS server by looking it up via the NetBIOS name resolution 279 mechanism described above in the <parameter>name resolve order</parameter> 284 <para>Normally the client would attempt to locate a named 285 SMB/CIFS server by looking it up via the NetBIOS name resolution 286 mechanism described above in the <parameter>name resolve order</parameter> 280 287 parameter above. Using this parameter will force the client 281 to assume that the server is on the machine with the specified IP 282 address and the NetBIOS name component of the resource being 288 to assume that the server is on the machine with the specified IP 289 address and the NetBIOS name component of the resource being 283 290 connected to will be ignored. </para> 284 291 285 <para>There is no default for this parameter. If not supplied, 286 it will be determined automatically by the client as described 292 <para>There is no default for this parameter. If not supplied, 293 it will be determined automatically by the client as described 287 294 above. </para></listitem> 288 295 </varlistentry> 289 296 290 297 <varlistentry> 291 298 <term>-E|--stderr</term> 292 <listitem><para>This parameter causes the client to write messages 293 to the standard error stream (stderr) rather than to the standard 299 <listitem><para>This parameter causes the client to write messages 300 to the standard error stream (stderr) rather than to the standard 294 301 output stream. </para> 295 296 <para>By default, the client writes messages to standard output 302 303 <para>By default, the client writes messages to standard output 297 304 - typically the user's tty. </para></listitem> 298 305 </varlistentry> 299 306 300 307 <varlistentry> 301 308 <term>-L|--list</term> 302 <listitem><para>This option allows you to look at what services 303 are available on a server. You use it as <command>smbclient -L 309 <listitem><para>This option allows you to look at what services 310 are available on a server. You use it as <command>smbclient -L 304 311 host</command> and a list should appear. The <parameter>-I 305 </parameter> option may be useful if your NetBIOS names don't 306 match your TCP/IP DNS host names or if you are trying to reach a 312 </parameter> option may be useful if your NetBIOS names don't 313 match your TCP/IP DNS host names or if you are trying to reach a 307 314 host on another network. </para></listitem> 308 315 </varlistentry> 309 310 <varlistentry> 316 317 <varlistentry> 311 318 <term>-b|--send-buffer buffersize</term> 312 <listitem><para> This option changes the transmit/send buffer313 size when getting or putting a file from/to the server. The default314 i s 65520 bytes. Setting this value smaller (to 1200 bytes) has been315 observed to speed up file transfers to and from a Win9x server.316 </para></listitem>317 </varlistentry>318 319 <varlistentry>320 <term>-e|--encrypt</term>321 <listitem><para>This command line parameter requires the remote322 server support the UNIX extensions. Request that the connection be323 encrypted. This is new for Samba 3.2 and will only work with Samba324 3.2 or above servers. Negotiates SMB encryption using GSSAPI. Uses 325 the given credentials for the encryption negotiation (either kerberos326 or NTLMv1/v2 if given domain/username/password triple. Fails the327 connection if encryption cannot be negotiated.328 </ para></listitem>329 </varlistentry> 330 319 <listitem><para> 320 When sending or receiving files, smbclient uses an 321 internal buffer sized by the maximum number of allowed requests 322 to the connected server. This command allows this size to be set to any 323 range between 0 (which means use the default server controlled size) bytes 324 and 16776960 (0xFFFF00) bytes. Using the server controlled size is the 325 most efficient as smbclient will pipeline as many simultaneous reads or 326 writes needed to keep the server as busy as possible. Setting this to 327 any other size will slow down the transfer. This can also be set 328 using the <command>iosize</command> command inside smbclient. 329 </para></listitem> 330 </varlistentry> 331 332 <varlistentry> 333 <term>-B|--browse</term> 334 <listitem><para>Browse SMB servers using DNS.</para> 335 </listitem> 336 </varlistentry> 337 331 338 &stdarg.client.debug; 332 339 &popt.common.samba; 333 340 &popt.common.credentials; 334 341 &popt.common.connection; 335 342 &popt.autohelp; 343 344 <varlistentry> 345 <term>-t|--timeout <timeout-seconds></term> 346 <listitem><para>This allows the user to tune the default 347 timeout used for each SMB request. The default setting is 348 20 seconds. Increase it if requests to the server sometimes 349 time out. This can happen when SMB3 encryption is selected 350 and smbclient is overwhelming the server with requests. 351 This can also be set using the <command>timeout</command> 352 command inside smbclient. 353 </para></listitem> 354 </varlistentry> 355 336 356 <varlistentry> 337 357 <term>-T|--tar tar options</term> 338 358 <listitem><para>smbclient may be used to create <command>tar(1) 339 359 </command> compatible backups of all the files on an SMB/CIFS 340 share. The secondary tar flags that can be given to this option 341 are :</para>342 360 share. The secondary tar flags that can be given to this option 361 are:</para> 362 343 363 <itemizedlist> 344 <listitem><para><parameter>c</parameter> - Create a tar file on UNIX. 345 Must be followed by the name of a tar file, tape device 346 or "-" for standard output. If using standard output you must 347 turn the log level to its lowest value -d0 to avoid corrupting 348 your tar file. This flag is mutually exclusive with the 364 <listitem><para><parameter>c</parameter> - Create a tar 365 backup archive on the local system. Must be followed by 366 the name of a tar file, tape device or "-" for standard 367 output. If using standard output you must turn the log 368 level to its lowest value -d0 to avoid corrupting your tar 369 file. This flag is mutually exclusive with the 349 370 <parameter>x</parameter> flag. </para></listitem> 350 351 <listitem><para><parameter>x</parameter> - Extract (restore) a local 352 tar file back to a share. Unless the -D option is given, the tar 353 files will be restored from the top level of the share. Must be 354 followed by the name of the tar file, device or "-" for standard 355 input. Mutually exclusive with the <parameter>c</parameter> flag. 371 372 <listitem><para><parameter>x</parameter> - Extract (restore) a local 373 tar file back to a share. Unless the -D option is given, the tar 374 files will be restored from the top level of the share. Must be 375 followed by the name of the tar file, device or "-" for standard 376 input. Mutually exclusive with the <parameter>c</parameter> flag. 356 377 Restored files have their creation times (mtime) set to the 357 date saved in the tar file. Directories currently do not get 378 date saved in the tar file. Directories currently do not get 358 379 their creation dates restored properly. </para></listitem> 359 360 <listitem><para><parameter>I</parameter> - Include files and directories. 361 Is the default behavior when filenames are specified above. Causes 362 files to be included in an extract or create (and therefore 363 everything else to be excluded). See example below. Filename globbing364 works in one of two ways. 365 366 <listitem><para><parameter>X</parameter> - Exclude files and directories. 367 Causes files to be excluded from an extract or create. See 368 example below. Filename globbing works in one of two ways now.380 381 <listitem><para><parameter>I</parameter> - Include files and directories. 382 Is the default behavior when filenames are specified above. Causes 383 files to be included in an extract or create (and therefore 384 everything else to be excluded). See example below. Filename globbing 385 works in one of two ways. See <parameter>r</parameter> below. </para></listitem> 386 387 <listitem><para><parameter>X</parameter> - Exclude files and directories. 388 Causes files to be excluded from an extract or create. See 389 example below. Filename globbing works in one of two ways. 369 390 See <parameter>r</parameter> below. </para></listitem> 370 391 371 392 <listitem><para><parameter>F</parameter> - File containing a list of files and directories. 372 393 The <parameter>F</parameter> causes the name following the tarfile to 373 create to be read as a filename that contains a list of files and directories to 394 create to be read as a filename that contains a list of files and directories to 374 395 be included in an extract or create (and therefore everything else to be excluded). 375 396 See example below. Filename globbing works in one of two ways. 376 397 See <parameter>r</parameter> below. 377 398 </para></listitem> 378 379 <listitem><para><parameter>b</parameter> - Blocksize. Must be followed 380 by a valid (greater than zero) blocksize. Causes tar file to be 381 written out in blocksize*TBLOCK ( usually 512 byte) blocks.399 400 <listitem><para><parameter>b</parameter> - Blocksize. Must be followed 401 by a valid (greater than zero) blocksize. Causes tar file to be 402 written out in blocksize*TBLOCK (512 byte) blocks. 382 403 </para></listitem> 383 384 <listitem><para><parameter>g</parameter> - Incremental. Only back up 385 files that have the archive bit set. Useful only with the 404 405 <listitem><para><parameter>g</parameter> - Incremental. Only back up 406 files that have the archive bit set. Useful only with the 386 407 <parameter>c</parameter> flag. </para></listitem> 387 408 388 <listitem><para><parameter>q</parameter> - Quiet. Keeps tar from printing 389 diagnostics as it works. This is the same as tarmode quiet. 409 <listitem><para><parameter>q</parameter> - Quiet. Keeps tar from printing 410 diagnostics as it works. This is the same as tarmode quiet. 390 411 </para></listitem> 391 392 <listitem><para><parameter>r</parameter> - Regular expression include 393 or exclude. Uses regular expression matching for 394 excluding or excluding files if compiled with HAVE_REGEX_H. 395 However this mode can be very slow. If not compiled with 396 HAVE_REGEX_H, does a limited wildcard match on '*' and '?'. 412 413 <listitem><para><parameter>r</parameter> - Use wildcard 414 matching to include or exclude. Deprecated. 397 415 </para></listitem> 398 399 <listitem><para><parameter>N</parameter> - Newer than. Must be followed 400 by the name of a file whose date is compared against files found 401 on the share during a create. Only files newer than the file 402 specified are backed up to the tar file. Useful only with the 416 417 <listitem><para><parameter>N</parameter> - Newer than. Must be followed 418 by the name of a file whose date is compared against files found 419 on the share during a create. Only files newer than the file 420 specified are backed up to the tar file. Useful only with the 403 421 <parameter>c</parameter> flag. </para></listitem> 404 405 <listitem><para><parameter>a</parameter> - Set archive bit. Causes the 406 archive bit to be reset when a file is backed up. Useful with the 407 <parameter>g</parameter> and <parameter>c</parameter> flags. 422 423 <listitem><para><parameter>a</parameter> - Set archive bit. Causes the 424 archive bit to be reset when a file is backed up. Useful with the 425 <parameter>g</parameter> and <parameter>c</parameter> flags. 408 426 </para></listitem> 409 427 </itemizedlist> 410 428 411 429 <para><emphasis>Tar Long File Names</emphasis></para> 412 413 <para><command>smbclient</command>'s tar option now supports long 414 file names both on backup and restore. However, the full path 415 name of the file must be less than 1024 bytes. 416 a tar archive is created, <command>smbclient</command>'s tar option places all 417 files in the archive with relative names, not absolute names. 430 431 <para><command>smbclient</command>'s tar option now supports long 432 file names both on backup and restore. However, the full path 433 name of the file must be less than 1024 bytes. Also, when 434 a tar archive is created, <command>smbclient</command>'s tar option places all 435 files in the archive with relative names, not absolute names. 418 436 </para> 419 437 420 438 <para><emphasis>Tar Filenames</emphasis></para> 421 422 <para>All file names can be given as DOS path names (with '\\' 423 as the component separator) or as UNIX path names (with '/' as 439 440 <para>All file names can be given as DOS path names (with '\\' 441 as the component separator) or as UNIX path names (with '/' as 424 442 the component separator). </para> 425 443 426 444 <para><emphasis>Examples</emphasis></para> 427 428 <para>Restore from tar file <filename>backup.tar</filename> into myshare on mypc 445 446 <para>Restore from tar file <filename>backup.tar</filename> into myshare on mypc 429 447 (no password on share). </para> 430 448 431 449 <para><command>smbclient //mypc/myshare "" -N -Tx backup.tar 432 450 </command></para> 433 451 434 452 <para>Restore everything except <filename>users/docs</filename> 435 453 </para> 436 437 <para><command>smbclient //mypc/myshare "" -N -TXx backup.tar 454 455 <para><command>smbclient //mypc/myshare "" -N -TXx backup.tar 438 456 users/docs</command></para> 439 457 440 458 <para>Create a tar file of the files beneath <filename> 441 459 users/docs</filename>. </para> 442 460 443 461 <para><command>smbclient //mypc/myshare "" -N -Tc 444 462 backup.tar users/docs </command></para> 445 446 <para>Create the same tar file as above, but now use 463 464 <para>Create the same tar file as above, but now use 447 465 a DOS path name. </para> 448 449 <para><command>smbclient //mypc/myshare "" -N - tc backup.tar466 467 <para><command>smbclient //mypc/myshare "" -N -Tc backup.tar 450 468 users\edocs </command></para> 451 469 452 470 <para>Create a tar file of the files listed in the file <filename>tarlist</filename>.</para> 453 471 454 472 <para><command>smbclient //mypc/myshare "" -N -TcF 455 473 backup.tar tarlist</command></para> 456 457 <para>Create a tar file of all the files and directories in 474 475 <para>Create a tar file of all the files and directories in 458 476 the share. </para> 459 477 460 478 <para><command>smbclient //mypc/myshare "" -N -Tc backup.tar * 461 479 </command></para> 462 480 </listitem> 463 481 </varlistentry> 464 482 465 483 <varlistentry> 466 484 <term>-D|--directory initial directory</term> 467 <listitem><para>Change to initial directory before starting. Probably 485 <listitem><para>Change to initial directory before starting. Probably 468 486 only of any use with the tar -T option. </para></listitem> 469 487 </varlistentry> 470 488 471 489 <varlistentry> 472 490 <term>-c|--command command string</term> 473 <listitem><para>command string is a semicolon-separated list of 491 <listitem><para>command string is a semicolon-separated list of 474 492 commands to be executed instead of prompting from stdin. <parameter> 475 493 -N</parameter> is implied by <parameter>-c</parameter>.</para> 476 494 477 <para>This is particularly useful in scripts and for printing stdin 495 <para>This is particularly useful in scripts and for printing stdin 478 496 to the server, e.g. <command>-c 'print -'</command>. </para></listitem> 479 497 </varlistentry> … … 486 504 <title>OPERATIONS</title> 487 505 488 <para>Once the client is running, the user is presented with 506 <para>Once the client is running, the user is presented with 489 507 a prompt : </para> 490 508 491 509 <para><prompt>smb:\> </prompt></para> 492 510 493 <para>The backslash ("\\") indicates the current working directory 494 on the server, and will change if the current working directory 511 <para>The backslash ("\\") indicates the current working directory 512 on the server, and will change if the current working directory 495 513 is changed. </para> 496 514 497 <para>The prompt indicates that the client is ready and waiting to 498 carry out a user command. Each command is a single word, optionally 499 followed by parameters specific to that command. Command and parameters 515 <para>The prompt indicates that the client is ready and waiting to 516 carry out a user command. Each command is a single word, optionally 517 followed by parameters specific to that command. Command and parameters 500 518 are space-delimited unless these notes specifically 501 state otherwise. All commands are case-insensitive. Parameters to502 commands may or may not be case sensitive, depending on the command. 519 state otherwise. All commands are case-insensitive. Parameters to 520 commands may or may not be case sensitive, depending on the command. 503 521 </para> 504 522 505 <para>You can specify file names which have spaces in them by quoting 523 <para>You can specify file names which have spaces in them by quoting 506 524 the name with double quotes, for example "a long file name". </para> 507 525 508 <para>Parameters shown in square brackets (e.g., "[parameter]") are 509 optional. If not given, the command will use suitable defaults. Parameters 526 <para>Parameters shown in square brackets (e.g., "[parameter]") are 527 optional. If not given, the command will use suitable defaults. Parameters 510 528 shown in angle brackets (e.g., "<parameter>") are required. 511 529 </para> 512 530 513 531 514 <para>Note that all commands operating on the server are actually 515 performed by issuing a request to the server. Thus the behavior may 516 vary from server to server, depending on how the server was implemented. 532 <para>Note that all commands operating on the server are actually 533 performed by issuing a request to the server. Thus the behavior may 534 vary from server to server, depending on how the server was implemented. 517 535 </para> 518 536 … … 556 574 2 means only operate on files with this bit set and reset it after operation, 557 575 3 means operate on all files and reset it after operation. The default is 0. 576 </para></listitem> 577 </varlistentry> 578 579 <varlistentry> 580 <term>backup</term> 581 <listitem><para>Toggle the state of the "backup intent" flag 582 sent to the server on directory listings and file opens. If 583 the "backup intent" flag is true, the server will try and 584 bypass some file system checks if the user has been granted 585 SE_BACKUP or SE_RESTORE privileges. This state is useful when 586 performing a backup or restore operation. 558 587 </para></listitem> 559 588 </varlistentry> … … 684 713 <varlistentry> 685 714 <term>iosize <bytes></term> 686 <listitem><para>When sending or receiving files, smbclient uses an 687 internal memory buffer by default of size 64512 bytes. This command 688 allows this size to be set to any range between 16384 (0x4000) bytes 689 and 16776960 (0xFFFF00) bytes. Larger sizes may mean more efficient 690 data transfer as smbclient will try and use the most efficient 691 read and write calls for the connected server. 715 <listitem><para> 716 When sending or receiving files, smbclient uses an 717 internal buffer sized by the maximum number of allowed requests 718 to the connected server. This command allows this size to be set to any 719 range between 0 (which means use the default server controlled size) bytes 720 and 16776960 (0xFFFF00) bytes. Using the server controlled size is the 721 most efficient as smbclient will pipeline as many simultaneous reads or 722 writes needed to keep the server as busy as possible. Setting this to 723 any other size will slow down the transfer. 692 724 </para></listitem> 693 725 </varlistentry> … … 736 768 737 769 <varlistentry> 770 <term>logoff</term> 771 <listitem><para>Logs the user off the server, closing the session. 772 Used for internal Samba testing purposes. 773 </para></listitem> 774 </varlistentry> 775 776 <varlistentry> 738 777 <term>lowercase</term> 739 778 <listitem><para>Toggle lowercasing of filenames for the get and 740 mget commands. 741 </para> 779 mget commands. 780 </para> 742 781 743 782 <para>When lowercasing is toggled ON, local filenames are converted … … 816 855 commands for more information. Note that all transfers in <command>smbclient</command> 817 856 are binary. </para></listitem> 857 </varlistentry> 858 859 <varlistentry> 860 <term>notify <dir name></term> 861 <listitem><para>Query a directory for change 862 notifications. This command issues a recursive 863 filechangenotify call for all possible changes. As 864 changes come in will print one line per change. See 865 <ulink url="https://msdn.microsoft.com/en-us/library/dn392331.aspx">https://msdn.microsoft.com/en-us/library/dn392331.aspx</ulink> 866 for a description of the action numbers that this 867 command prints.</para> 868 <para>This command never ends, it waits for event 869 indefinitely. 870 </para></listitem> 818 871 </varlistentry> 819 872 … … 954 1007 <varlistentry> 955 1008 <term>rmdir <directory name></term> 956 1009 <listitem><para>Remove the specified directory (user access 957 1010 privileges permitting) from the server. </para></listitem> 1011 </varlistentry> 1012 1013 <varlistentry> 1014 <term>scopy <source filename> <destination filename></term> 1015 <listitem><para>Attempt to copy a file on the server using the 1016 most efficient server-side copy calls. Falls back to using 1017 read then write if server doesn't support server-side copy. 1018 </para></listitem> 958 1019 </varlistentry> 959 1020 … … 998 1059 <varlistentry> 999 1060 <term>tar <c|x>[IXbgNa]</term> 1000 <listitem><para>Performs a tar operation - see the <parameter>-T1001 < /parameter> command line option above. Behavior may be affected1002 by the tarmode command (see below). Using g (incremental) and N1003 ( newer) will affect tarmode settings. Note that using the "-" option1004 with tar x may not work - use the command line option instead.1005 </para></listitem>1061 <listitem><para>Performs a tar operation - see the 1062 <parameter>-T</parameter> command line option above. Behavior 1063 may be affected by the tarmode command (see below). Using g 1064 (incremental) and N (newer) will affect tarmode settings. Note 1065 that using the "-" option with tar x may not work - use the 1066 command line option instead.</para></listitem> 1006 1067 </varlistentry> 1007 1068 … … 1010 1071 <listitem><para>Blocksize. Must be followed by a valid (greater 1011 1072 than zero) blocksize. Causes tar file to be written out in 1012 <replaceable>blocksize</replaceable>*TBLOCK (usually 512 byte) blocks. </para></listitem> 1013 </varlistentry> 1014 1015 <varlistentry> 1016 <term>tarmode <full|inc|reset|noreset></term> 1017 <listitem><para>Changes tar's behavior with regard to archive 1018 bits. In full mode, tar will back up everything regardless of the 1019 archive bit setting (this is the default mode). In incremental mode, 1020 tar will only back up files with the archive bit set. In reset mode, 1021 tar will reset the archive bit on all files it backs up (implies 1022 read/write share). </para></listitem> 1073 <replaceable>blocksize</replaceable>*TBLOCK (512 byte) blocks. </para></listitem> 1074 </varlistentry> 1075 1076 <varlistentry> 1077 <term>tarmode <full|inc|reset|noreset|system|nosystem|hidden|nohidden></term> 1078 <listitem><para>Changes tar's behavior with regard to DOS 1079 attributes. There are 4 modes which can be turned on or 1080 off.</para> 1081 1082 <para>Incremental mode (default off). When off (using 1083 <command>full</command>) tar will back up everything 1084 regardless of the <emphasis>archive</emphasis> bit 1085 setting. When on (using <command>inc</command>), tar will only 1086 back up files with the archive bit set.</para> 1087 1088 <para>Reset mode (default off). When on (using 1089 <command>reset</command>), tar will remove the archive bit on 1090 all files it backs up (implies read/write share). Use 1091 <command>noreset</command> to turn off.</para> 1092 1093 <para>System mode (default on). When off, tar will not backup 1094 system files. Use <command>nosystem</command> to turn off.</para> 1095 1096 <para>Hidden mode (default on). When off, tar will not backup 1097 hidden files. Use <command>nohidden</command> to turn off.</para> 1098 </listitem> 1099 </varlistentry> 1100 1101 <varlistentry> 1102 <term>timeout <per-operation timeout in seconds></term> 1103 <listitem><para>This allows the user to tune the default 1104 timeout used for each SMB request. The default setting is 1105 20 seconds. Increase it if requests to the server sometimes 1106 time out. This can happen when SMB3 encryption is selected 1107 and smbclient is overwhelming the server with requests. 1108 </para></listitem> 1023 1109 </varlistentry> 1024 1110 … … 1045 1131 </varlistentry> 1046 1132 1133 <varlistentry> 1134 <term>tcon <sharename></term> 1135 <listitem><para>Establishes a new tree connect (connection to a share). 1136 Replaces the current tree connect. Prints the new tid (tree id). 1137 Used for internal Samba testing purposes. 1138 </para></listitem> 1139 </varlistentry> 1140 1141 <varlistentry> 1142 <term>tdis</term> 1143 <listitem><para>Close the current share connection (tree disconnect). 1144 Used for internal Samba testing purposes. 1145 </para></listitem> 1146 </varlistentry> 1147 1148 <varlistentry> 1149 <term>tid <number></term> 1150 <listitem><para>Changes the current tree id (tid) in the 1151 protocol to a new arbitrary number. Without an argument, it 1152 prints out the tid currently used. 1153 Used for internal Samba testing purposes. 1154 </para></listitem> 1155 </varlistentry> 1156 1047 1157 </variablelist> 1048 1158 </refsect1> … … 1061 1171 name that would be known to the server.</para> 1062 1172 1063 <para>smbclient supports long file names where the server 1173 <para>smbclient supports long file names where the server 1064 1174 supports the LANMAN2 protocol or above. </para> 1065 1175 </refsect1> … … 1068 1178 <title>ENVIRONMENT VARIABLES</title> 1069 1179 1070 <para>The variable <envar>USER</envar> may contain the 1071 username of the person using the client. This information is1072 used only if the protocol level is high enough to support 1180 <para>The variable <envar>USER</envar> may contain the 1181 username of the person using the client. This information is 1182 used only if the protocol level is high enough to support 1073 1183 session-level passwords.</para> 1074 1184 1075 1185 1076 <para>The variable <envar>PASSWD</envar> may contain 1077 the password of the person using the client. This information is 1078 used only if the protocol level is high enough to support 1186 <para>The variable <envar>PASSWD</envar> may contain 1187 the password of the person using the client. This information is 1188 used only if the protocol level is high enough to support 1079 1189 session-level passwords. </para> 1080 1190 1081 <para>The variable <envar>LIBSMB_PROG</envar> may contain 1082 the path, executed with system(), which the client should connect 1083 1084 intended as a development aid, and works best when using a LMHOSTS 1085 1191 <para>The variable <envar>LIBSMB_PROG</envar> may contain 1192 the path, executed with system(), which the client should connect 1193 to instead of connecting to a server. This functionality is primarily 1194 intended as a development aid, and works best when using a LMHOSTS 1195 file</para> 1086 1196 </refsect1> 1087 1197 … … 1090 1200 <title>INSTALLATION</title> 1091 1201 1092 <para>The location of the client program is a matter for 1202 <para>The location of the client program is a matter for 1093 1203 individual system administrators. The following are thus 1094 1204 suggestions only. </para> … … 1096 1206 <para>It is recommended that the smbclient software be installed 1097 1207 in the <filename>/usr/local/samba/bin/</filename> or <filename> 1098 /usr/samba/bin/</filename> directory, this directory readable 1099 by all, writeable only by root. The client program itself should 1100 be executable by all. The client should <emphasis>NOT</emphasis> be 1208 /usr/samba/bin/</filename> directory, this directory readable 1209 by all, writeable only by root. The client program itself should 1210 be executable by all. The client should <emphasis>NOT</emphasis> be 1101 1211 setuid or setgid! </para> 1102 1212 1103 <para>The client log files should be put in a directory readable 1213 <para>The client log files should be put in a directory readable 1104 1214 and writeable only by the user. </para> 1105 1215 1106 <para>To test the client, you will need to know the name of a 1216 <para>To test the client, you will need to know the name of a 1107 1217 running SMB/CIFS server. It is possible to run <citerefentry><refentrytitle>smbd</refentrytitle> 1108 <manvolnum>8</manvolnum></citerefentry> as an ordinary user - running that server as a daemon 1218 <manvolnum>8</manvolnum></citerefentry> as an ordinary user - running that server as a daemon 1109 1219 on a user-accessible port (typically any port number over 1024) 1110 1220 would provide a suitable test server. </para> … … 1115 1225 <title>DIAGNOSTICS</title> 1116 1226 1117 <para>Most diagnostics issued by the client are logged in a 1118 specified log file. The log file name is specified at compile time, 1227 <para>Most diagnostics issued by the client are logged in a 1228 specified log file. The log file name is specified at compile time, 1119 1229 but may be overridden on the command line. </para> 1120 1230 1121 <para>The number and nature of diagnostics available depends 1122 on the debug level used by the client. If you have problems, 1231 <para>The number and nature of diagnostics available depends 1232 on the debug level used by the client. If you have problems, 1123 1233 set the debug level to 3 and peruse the log files. </para> 1124 1234 </refsect1> … … 1134 1244 <refsect1> 1135 1245 <title>AUTHOR</title> 1136 1137 <para>The original Samba software and related utilities 1246 1247 <para>The original Samba software and related utilities 1138 1248 were created by Andrew Tridgell. Samba is now developed 1139 by the Samba Team as an Open Source project similar 1249 by the Samba Team as an Open Source project similar 1140 1250 to the way the Linux kernel is developed.</para> 1141 1142 <para>The original Samba man pages were written by Karl Auer. 1143 The man page sources were converted to YODL format (another 1251 1252 <para>The original Samba man pages were written by Karl Auer. 1253 The man page sources were converted to YODL format (another 1144 1254 excellent piece of Open Source software, available at <ulink url="ftp://ftp.icce.rug.nl/pub/unix/"> 1145 ftp://ftp.icce.rug.nl/pub/unix/</ulink>) and updated for the Samba 2.0 1146 release by Jeremy Allison. The conversion to DocBook for1255 ftp://ftp.icce.rug.nl/pub/unix/</ulink>) and updated for the Samba 2.0 1256 release by Jeremy Allison. The conversion to DocBook for 1147 1257 Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2 for Samba 3.0 1148 1258 was done by Alexander Bokovoy.</para> -
vendor/current/docs-xml/manpages/smbcontrol.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 20 20 <cmdsynopsis> 21 21 <command>smbcontrol</command> 22 <arg>-i</arg>23 22 <arg>-s</arg> 23 <arg>-t|--timeout</arg> 24 24 </cmdsynopsis> 25 25 … … 50 50 51 51 <variablelist> 52 & stdarg.help;52 &popt.autohelp; 53 53 &stdarg.configfile; 54 <varlistentry>55 < term>-i</term>56 < listitem><para>Run interactively. Individual commands57 of the form destination message-type parameters can be entered58 on STDIN. An empty command line or a "q" will quit the59 program.</para></listitem>54 &popt.common.samba.client; 55 <varlistentry> 56 <term>-t|--timeout</term> 57 <listitem><para> 58 Set timeout to seconds. 59 </para></listitem> 60 60 </varlistentry> 61 61 62 62 <varlistentry> 63 63 <term>destination</term> 64 <listitem><para>One of <parameter>nmbd</parameter>, <parameter>smbd</parameter> or a process ID.</para> 64 <listitem><para>One of <parameter>nmbd</parameter>, 65 <parameter>smbd</parameter>, <parameter>winbindd</parameter> 66 or a process ID.</para> 65 67 66 68 <para>The <parameter>all</parameter> destination causes the … … 130 132 131 133 <varlistentry> 134 <term>kill-client-ip</term> 135 <listitem><para>Order smbd to close the client connections from a 136 given IP address. This message-type takes an argument of the IP 137 address from which client connections will be closed. This message 138 can only be sent to <constant>smbd</constant>.</para> 139 </listitem> 140 </varlistentry> 141 142 <varlistentry> 132 143 <term>force-election</term> 133 144 <listitem><para>This message causes the <command>nmbd</command> daemon to … … 224 235 225 236 <varlistentry> 226 <term>samsync</term>227 <listitem><para>Order smbd to synchronise sam database from PDC (being BDC). Can only be sent to <constant>smbd</constant>. </para>228 <note><para>Not working at the moment</para></note>229 </listitem>230 </varlistentry>231 232 <varlistentry>233 <term>samrepl</term>234 <listitem><para>Send sam replication message, with specified serial. Can only be sent to <constant>smbd</constant>. Should not be used manually.</para></listitem>235 </varlistentry>236 237 <varlistentry>238 237 <term>dmalloc-mark</term> 239 238 <listitem><para>Set a mark for dmalloc. Can be sent to both smbd and nmbd. Only available if samba is built with dmalloc support. </para></listitem> … … 270 269 <listitem><para>Force daemon to reload smb.conf configuration file. Can be sent 271 270 to <constant>smbd</constant>, <constant>nmbd</constant>, or <constant>winbindd</constant>. 271 </para></listitem> 272 </varlistentry> 273 274 <varlistentry> 275 <term>reload-printers</term> 276 <listitem><para>Force smbd to reload printers. Can only be sent to 277 <constant>smbd</constant>. 272 278 </para></listitem> 273 279 </varlistentry> … … 299 305 </varlistentry> 300 306 307 <varlistentry> 308 <term>num-children</term> 309 <listitem><para>Query the number of smbd child processes. This 310 message can only be sent 311 to <constant>smbd</constant>.</para></listitem> 312 </varlistentry> 313 301 314 </variablelist> 302 315 </refsect1> -
vendor/current/docs-xml/manpages/smbcquotas.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 21 21 <command>smbcquotas</command> 22 22 <arg choice="req">//server/share</arg> 23 <arg choice="opt">-u user</arg>24 <arg choice="opt">-L </arg>25 <arg choice="opt">-F </arg>26 <arg choice="opt">-S QUOTA_SET_COMMAND</arg>27 <arg choice="opt">-n </arg>28 <arg choice="opt">-t </arg>29 <arg choice="opt">-v </arg>23 <arg choice="opt">-u|--user user</arg> 24 <arg choice="opt">-L|--list</arg> 25 <arg choice="opt">-F|--fs</arg> 26 <arg choice="opt">-S|--set QUOTA_SET_COMMAND</arg> 27 <arg choice="opt">-n|--numeric</arg> 28 <arg choice="opt">-t|--test-args</arg> 29 <arg choice="opt">-v|--verbose</arg> 30 30 31 31 <arg choice="opt">-d debuglevel</arg> … … 61 61 <variablelist> 62 62 <varlistentry> 63 <term>-u user</term>63 <term>-u|--user user</term> 64 64 <listitem><para> Specifies the user of whom the quotas are get or set. 65 65 By default the current user's username will be used.</para></listitem> … … 69 69 70 70 <varlistentry> 71 <term>-L </term>71 <term>-L|--list</term> 72 72 <listitem><para>Lists all quota records of the share.</para></listitem> 73 73 </varlistentry> … … 76 76 77 77 <varlistentry> 78 <term>-F </term>78 <term>-F|--fs</term> 79 79 <listitem><para>Show the share quota status and default limits.</para></listitem> 80 80 </varlistentry> … … 83 83 84 84 <varlistentry> 85 <term>-S QUOTA_SET_COMMAND</term>85 <term>-S|--set QUOTA_SET_COMMAND</term> 86 86 <listitem><para>This command sets/modifies quotas for a user or on the share, 87 87 depending on the QUOTA_SET_COMMAND parameter which is described later.</para></listitem> … … 90 90 91 91 <varlistentry> 92 <term>-n </term>92 <term>-n|--numeric</term> 93 93 <listitem><para>This option displays all QUOTA information in numeric 94 94 format. The default is to convert SIDs to names and QUOTA limits … … 97 97 98 98 <varlistentry> 99 <term>-t </term>99 <term>-t|--test-args</term> 100 100 <listitem><para> 101 101 Don't actually do anything, only validate the correctness of the arguments. … … 104 104 105 105 <varlistentry> 106 <term>-v </term>106 <term>-v|--verbose</term> 107 107 <listitem><para> 108 108 Be verbose. … … 110 110 </varlistentry> 111 111 112 &stdarg.help; 112 113 113 &stdarg.server.debug; 114 114 &popt.common.samba; 115 115 &popt.common.credentials; 116 &popt.autohelp; 117 116 118 </variablelist> 117 119 </refsect1> -
vendor/current/docs-xml/manpages/smbd.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 20 20 <cmdsynopsis> 21 21 <command>smbd</command> 22 <arg choice="opt">-D</arg> 23 <arg choice="opt">-F</arg> 24 <arg choice="opt">-S</arg> 25 <arg choice="opt">-i</arg> 26 <arg choice="opt">-h</arg> 22 <arg choice="opt">-D|--daemon</arg> 23 <arg choice="opt">-F|--foreground</arg> 24 <arg choice="opt">-S|--log-stdout</arg> 25 <arg choice="opt">-i|--interactive</arg> 27 26 <arg choice="opt">-V</arg> 28 <arg choice="opt">-b </arg>27 <arg choice="opt">-b|--build-options</arg> 29 28 <arg choice="opt">-d <debug level></arg> 30 <arg choice="opt">-l <log directory></arg>29 <arg choice="opt">-l|--log-basename <log directory></arg> 31 30 <arg choice="opt">-p <port number(s)></arg> 32 31 <arg choice="opt">-P <profiling level></arg> 33 <arg choice="opt">-O <socket option></arg>34 32 <arg choice="opt">-s <configuration file></arg> 33 <arg choice="opt">--no-process-group</arg> 35 34 </cmdsynopsis> 36 35 </refsynopsisdiv> … … 82 81 <variablelist> 83 82 <varlistentry> 84 <term>-D </term>83 <term>-D|--daemon</term> 85 84 <listitem><para>If specified, this parameter causes 86 85 the server to operate as a daemon. That is, it detaches … … 95 94 96 95 <varlistentry> 97 <term>-F </term>96 <term>-F|--foreground</term> 98 97 <listitem><para>If specified, this parameter causes 99 98 the main <command>smbd</command> process to not daemonize, … … 110 109 111 110 <varlistentry> 112 <term>-S </term>111 <term>-S|--log-stdout</term> 113 112 <listitem><para>If specified, this parameter causes 114 113 <command>smbd</command> to log to standard output rather … … 117 116 118 117 <varlistentry> 119 <term>-i </term>118 <term>-i|--interactive</term> 120 119 <listitem><para>If this parameter is specified it causes the 121 120 server to run "interactively", not as a daemon, even if the 122 121 server is executed on the command line of a shell. Setting this 123 122 parameter negates the implicit daemon mode when run from the 124 command line. <command>smbd</command> also logs to standard125 output, as if the <command>-S</command> parameter had been126 given.127 </para></listitem> 128 </varlistentry> 129 123 command line. <command>smbd</command> will only accept one 124 connection and terminate. It will also log to standard output, 125 as if the <command>-S</command> parameter had been given. 126 </para></listitem> 127 </varlistentry> 128 130 129 &stdarg.server.debug; 131 130 &popt.common.samba; 132 &stdarg.help; 133 134 <varlistentry> 135 <term>-b</term> 131 &popt.autohelp; 132 133 <varlistentry> 134 <term>--no-process-group</term> 135 <listitem><para>Do not create a new process group for smbd. 136 </para></listitem> 137 </varlistentry> 138 139 <varlistentry> 140 <term>-b|--build-options</term> 136 141 <listitem><para>Prints information about how 137 142 Samba was built.</para></listitem> … … 310 315 </varlistentry> 311 316 312 <varlistentry><term>connections.tdb</term>313 <listitem><para>share connections (used to enforce max connections, etc...)</para></listitem>314 </varlistentry>315 316 317 <varlistentry><term>gencache.tdb</term> 317 318 <listitem><para>generic caching db</para></listitem> … … 358 359 </varlistentry> 359 360 360 <varlistentry><term>s essionid.tdb</term>361 <varlistentry><term>smbXsrv_session_global.tdb</term> 361 362 <listitem><para>session information (e.g. support for 'utmp = yes')</para></listitem> 363 </varlistentry> 364 365 <varlistentry><term>smbXsrv_tcon_global.tdb</term> 366 <listitem><para>share connections (used to enforce max connections, etc...)</para></listitem> 367 </varlistentry> 368 369 <varlistentry><term>smbXsrv_open_global.tdb</term> 370 <listitem><para>open file handles (used durable handles, etc...)</para></listitem> 362 371 </varlistentry> 363 372 … … 418 427 <manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>smbclient</refentrytitle> 419 428 <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>testparm</refentrytitle> 420 <manvolnum>1</manvolnum></citerefentry>, <citerefentry><refentrytitle>testprns</refentrytitle>421 429 <manvolnum>1</manvolnum></citerefentry>, and the 422 430 Internet RFC's <filename>rfc1001.txt</filename>, <filename>rfc1002.txt</filename>. -
vendor/current/docs-xml/manpages/smbget.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 23 23 <arg choice="opt">-r, --resume</arg> 24 24 <arg choice="opt">-R, --recursive</arg> 25 <arg choice="opt">-u, --username=STRING</arg> 26 <arg choice="opt">-p, --password=STRING</arg> 25 <arg choice="opt">-U, --username=STRING</arg> 27 26 <arg choice="opt">-w, --workgroup=STRING</arg> 28 27 <arg choice="opt">-n, --nonprompt</arg> 29 28 <arg choice="opt">-d, --debuglevel=INT</arg> 30 29 <arg choice="opt">-D, --dots</arg> 31 <arg choice="opt">-P, --keep-permissions</arg>32 30 <arg choice="opt">-o, --outputfile</arg> 33 31 <arg choice="opt">-f, --rcfile</arg> … … 36 34 <arg choice="opt">-b, --blocksize</arg> 37 35 <arg choice="opt">-O, --stdout</arg> 36 <arg choice="opt">-u, --update</arg> 38 37 <arg choice="opt">-?, --help</arg> 39 38 <arg choice="opt">--usage</arg> … … 78 77 79 78 <varlistentry> 80 <term>-u, --username=STRING</term> 81 <listitem><para>Username to use</para></listitem> 82 </varlistentry> 83 84 <varlistentry> 85 <term>-p, --password=STRING</term> 86 <listitem><para>Password to use</para></listitem> 79 <term> -U, --username=<replaceable>username[%password]</replaceable></term> 80 <listitem><para>Username (and password) to use</para></listitem> 87 81 </varlistentry> 88 82 … … 108 102 109 103 <varlistentry> 110 <term>-P, --keep-permissions</term>111 <listitem><para>Set same permissions on local file as are set on remote file.</para></listitem>112 </varlistentry>113 114 <varlistentry>115 104 <term>-o, --outputfile</term> 116 105 <listitem><para>Write the file that is being downloaded to the specified file. Can not be used together with -R.</para></listitem> … … 151 140 <listitem><para>Display brief usage message</para></listitem> 152 141 </varlistentry> 142 143 <varlistentry> 144 <term>-u, --update</term> 145 <listitem><para>Download only when remote file is newer than local file or local file is missing.</para></listitem> 146 </varlistentry> 147 148 &stdarg.encrypt; 149 153 150 </refsect1> 154 151 -
vendor/current/docs-xml/manpages/smbgetrc.5.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">File Formats and Conventions</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 54 54 </varlistentry> 55 55 56 <varlistentry><term>user name <replaceable>name</replaceable></term>57 <listitem><para>Username to use when logging in to the remote server. Use an empty string for anonymous access.56 <varlistentry><term>user <replaceable>name[%password]</replaceable></term> 57 <listitem><para>Username (and password) to use when logging in to the remote server. Use an empty string for anonymous access. 58 58 </para></listitem> 59 </varlistentry>60 61 <varlistentry><term>password <replaceable>pass</replaceable></term>62 <listitem><para>Password to use when logging in.</para></listitem>63 59 </varlistentry> 64 60 -
vendor/current/docs-xml/manpages/smbpasswd.5.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">File Formats and Conventions</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 40 40 is very similar to the familiar Unix <filename>passwd(5)</filename> 41 41 file. It is an ASCII file containing one line for each user. Each field 42 ithin each line is separated from the next by a colon. Any entry42 within each line is separated from the next by a colon. Any entry 43 43 beginning with '#' is ignored. The smbpasswd file contains the 44 44 following information for each user: </para> -
vendor/current/docs-xml/manpages/smbpasswd.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 327 327 switch is used to specify the password to be used with the 328 328 <smbconfoption name="ldap admin dn"/>. Note that the password is stored in 329 the <filename>secrets.tdb</filename> and is keyed off 329 the <filename>secrets.tdb</filename> and is keyed off 330 330 of the admin's DN. This means that if the value of <parameter>ldap 331 331 admin dn</parameter> ever changes, the password will need to be -
vendor/current/docs-xml/manpages/smbspool.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 51 51 <listitem><para>smb://workgroup/server[:port]/printer</para></listitem> 52 52 <listitem><para>smb://username:password@server[:port]/printer</para></listitem> 53 <listitem><para>smb://domain\username:password@server[:port]/printer</para></listitem> 53 54 <listitem><para>smb://username:password@workgroup/server[:port]/printer</para></listitem> 54 55 </itemizedlist> … … 63 64 <envar>DEVICE_URI</envar> environment variable prior to 64 65 running smbspool.</para> 66 67 <para>smbspool will accept URI escaped characters. This allows setting 68 a domain in the username, or space in the printer name. For example 69 smb://domain%5Cusername/printer%20name</para> 65 70 </refsect1> 66 71 -
vendor/current/docs-xml/manpages/smbstatus.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 28 28 <arg choice="opt">-p</arg> 29 29 <arg choice="opt">-S</arg> 30 <arg choice="opt">-N</arg> 31 <arg choice="opt">-f</arg> 30 32 <arg choice="opt">-s <configuration file></arg> 31 33 <arg choice="opt">-u <username></arg> 34 <arg choice="opt">-n|--numeric</arg> 35 <arg choice="opt">-R|--profile-rates</arg> 32 36 </cmdsynopsis> 33 37 </refsynopsisdiv> … … 49 53 <varlistentry> 50 54 <term>-P|--profile</term> 51 <listitem><para>If samba has been compiled with the 52 profiling option, print only the contents of the profiling 55 <listitem><para>If samba has been compiled with the 56 profiling option, print only the contents of the profiling 53 57 shared memory area.</para></listitem> 58 </varlistentry> 59 60 <varlistentry> 61 <term>-R|--profile-rates</term> 62 <listitem><para>If samba has been compiled with the 63 profiling option, print the contents of the profiling 64 shared memory area and the call rates.</para></listitem> 54 65 </varlistentry> 55 66 … … 96 107 </varlistentry> 97 108 109 <varlistentry> 110 <term>-N|--notify</term> 111 <listitem><para>causes smbstatus to display registered file 112 notifications</para> 113 </listitem> 114 </varlistentry> 115 116 <varlistentry> 117 <term>-f|--fast</term> 118 <listitem><para>causes smbstatus to not check if the status data 119 is valid by checking if the processes that the status data refer to all still 120 exist. This speeds up execution on busy systems and clusters but 121 might display stale data of processes that died without cleaning up properly.</para> 122 </listitem> 123 </varlistentry> 124 98 125 &stdarg.help; 99 126 … … 101 128 <term>-u|--user=<username></term> 102 129 <listitem><para>selects information relevant to <parameter>username</parameter> only.</para> 130 </listitem> 131 </varlistentry> 132 133 <varlistentry> 134 <term>-n|--numeric</term> 135 <listitem><para>causes smbstatus to display numeric UIDs and GIDs instead of 136 resolving them to names.</para> 103 137 </listitem> 104 138 </varlistentry> -
vendor/current/docs-xml/manpages/smbtar.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/smbtree.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 71 71 &popt.common.samba; 72 72 &popt.common.credentials; 73 & stdarg.help;73 &popt.autohelp; 74 74 75 75 </variablelist> -
vendor/current/docs-xml/manpages/testparm.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 21 21 <cmdsynopsis> 22 22 <command>testparm</command> 23 <arg choice="opt">-s</arg> 24 <arg choice="opt">-h</arg> 25 <arg choice="opt">-v</arg> 26 <arg choice="opt">-t <encoding></arg> 23 <arg choice="opt">-s|--suppress-prompt</arg> 24 <arg choice="opt">--help</arg> 25 <arg choice="opt">-v|--verbose</arg> 27 26 <arg choice="req">config filename</arg> 28 27 <arg choice="opt">hostname hostIP</arg> … … 64 63 <variablelist> 65 64 <varlistentry> 66 <term>-s </term>65 <term>-s|--suppress-prompt</term> 67 66 <listitem><para>Without this option, <command>testparm</command> 68 67 will prompt for a carriage return after printing the service … … 70 69 </varlistentry> 71 70 72 &stdarg.help;73 71 &stdarg.version; 74 75 <varlistentry> 76 <term>-v</term> 72 &stdarg.option; 73 &popt.autohelp; 74 &stdarg.client.debug; 75 76 <varlistentry> 77 <term>-v|--verbose</term> 77 78 <listitem><para>If this option is specified, testparm 78 79 will also output all options that were not used in <citerefentry> … … 82 83 83 84 <varlistentry> 84 <term>-t encoding</term>85 <listitem><para>86 Output data in specified encoding.87 </para></listitem>88 </varlistentry>89 90 <varlistentry>91 85 <term>--parameter-name parametername</term> 92 86 <listitem><para> … … 104 98 <listitem><para> 105 99 Dumps the named section. 100 </para></listitem> 101 </varlistentry> 102 103 <varlistentry> 104 <term>--show-all-parameters</term> 105 <listitem><para> 106 Show the parameters, type, possible values. 107 </para></listitem> 108 </varlistentry> 109 110 <varlistentry> 111 <term>-l|--skip-logic-checks</term> 112 <listitem><para> 113 Skip the global checks. 106 114 </para></listitem> 107 115 </varlistentry> -
vendor/current/docs-xml/manpages/vfs_acl_tdb.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_acl_xattr.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_aio_fork.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 70 70 <title>VERSION</title> 71 71 72 <para>This man page is correct for version 3.6.0 of the Samba suite.72 <para>This man page is correct for version 4.0.0 of the Samba suite. 73 73 </para> 74 74 </refsect1> -
vendor/current/docs-xml/manpages/vfs_aio_pthread.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 104 104 <title>VERSION</title> 105 105 106 <para>This man page is correct for version 3.6.3of the Samba suite.106 <para>This man page is correct for version 4.0 of the Samba suite. 107 107 </para> 108 108 </refsect1> -
vendor/current/docs-xml/manpages/vfs_audit.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_cacheprime.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 85 85 <refsect1> 86 86 <title>CAVEATS</title> 87 <para><command>cacheprime</command> is not a asubstitute for87 <para><command>cacheprime</command> is not a substitute for 88 88 a general-purpose readahead mechanism. It is intended for use 89 89 only in very specific environments where disk operations must -
vendor/current/docs-xml/manpages/vfs_cap.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_catia.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 38 38 <para>This module is stackable.</para> 39 39 40 <para>Up to samba version 3.4.x a fixed character mapping was used. 41 The invalid windows characters \ / : * ? " < > | and the blank 42 character were mapped in a hardcoded way. 40 <para>The parameter "catia:mappings" specifies the mapping on a 41 per-character basis, see below. 43 42 </para> 44 45 <para>Starting with samba-3.5.0 a more flexible mapping was introduced. 46 The new parameter "catia:mappings" now specifies the mapping on a char by char 47 basis using the notation: unix hex char 0x.. : windows hex char 0x.. 48 Multiple character mappings are separated by a comma. 49 </para> 43 </refsect1> 50 44 51 45 46 47 <refsect1> 48 <title>OPTIONS</title> 49 <variablelist> 50 <varlistentry> 51 <term>catia:mappings = SERVER_HEX_CHAR:CLIENT_HEX_CHAR 52 </term> 53 <listitem> 54 <para>SERVER_HEX_CHAR specifies a 0x prefixed hexedecimal 55 character code that, when included in a Samba server-side 56 filename, will be mapped to CLIENT_HEX_CHAR for the CIFS 57 client.</para> 58 <para>The same mapping occurs in the opposite direction. 59 Multiple character mappings are separated by a comma.</para> 60 </listitem> 61 </varlistentry> 62 </variablelist> 52 63 </refsect1> 64 53 65 54 66 … … 56 68 <title>EXAMPLES</title> 57 69 58 <para>Samba versions up to 3.4.x:</para> 59 <para>Map Catia filenames on the [CAD] share:</para> 60 61 <programlisting> 62 <smbconfsection name="[CAD]"/> 63 <smbconfoption name="path">/data/cad</smbconfoption> 64 <smbconfoption name="vfs objects">catia</smbconfoption> 65 </programlisting> 66 67 <para>Samba versions 3.5.0 and later:</para> 68 <para>Map Catia filenames on the [CAD] share:</para> 70 <para>Map server-side quotation-marks (") to client-side diaeresis 71 (¨) on filenames in the [CAD] share:</para> 69 72 70 73 <programlisting> … … 75 78 </programlisting> 76 79 77 <para> To get the full formerly fixed mappings:</para>80 <para>Perform comprehensive mapping of common Catia filename characters:</para> 78 81 <programlisting> 79 82 <smbconfsection name="[CAD]"/> 80 83 <smbconfoption name="path">/data/cad</smbconfoption> 81 84 <smbconfoption name="vfs objects">catia</smbconfoption> 82 <smbconfoption name="catia:mappings">0x22:0xa8,0x2a:0xa4,0x2f:0xf8,0x3a:0xf7,0x3c:0xab,0x3e:0xbb,0x3f:0xbf,0x5c:0xff,0x7c:0xa6 ,0x20:0xb1</smbconfoption>85 <smbconfoption name="catia:mappings">0x22:0xa8,0x2a:0xa4,0x2f:0xf8,0x3a:0xf7,0x3c:0xab,0x3e:0xbb,0x3f:0xbf,0x5c:0xff,0x7c:0xa6</smbconfoption> 83 86 </programlisting> 84 87 85 <para> Unixfilename to be translated (Note that the path delimiter "/" is not used here):88 <para>Server-side filename to be translated (Note that the path delimiter "/" is not used here): 86 89 </para> 87 <para>a\a:a*a?a"a<a>a|a a</para>90 <para>a\a:a*a?a"a<a>a|a</para> 88 91 89 <para>Resulting windows filename:</para>92 <para>Resulting filename, as seen by the client:</para> 90 93 91 <para>aÿa÷a¤a¿a¨a«a»a¦a ±a94 <para>aÿa÷a¤a¿a¨a«a»a¦a 92 95 </para> 96 </refsect1> 93 97 94 <para>Note that the character mapping must work in BOTH directions 95 (unix -> windows and windows -> unix) to get unique and existing file names! 98 <refsect1> 99 <title>CAVEATS</title> 100 101 <para>Character mapping must work in BOTH directions (server -> 102 client and client -> server) to get unique and existing file names! 96 103 </para> 97 104 … … 105 112 </programlisting> 106 113 107 108 <para>Assuming a unix filename "a:should_work", which is well translated109 to windows as "a_should_work".</para>110 <para>BUT the reverse mapping from windows "a_should_work" to unix111 112 113 114 <para>Here the colon ":" is mapped to the underscore "_".</para> 115 <para>Assuming a server-side filename "a:should_work", which is 116 translated to "a_should_work" for the client.</para> 117 <para>BUT the reverse mapping from client "a_should_work" to server 118 will result in "a:should:work" - something like "file not found" 119 will be returned. 120 </para> 114 121 115 122 </refsect1> … … 118 125 <title>VERSION</title> 119 126 120 <para>This man page is correct for all versions up to 4.0.3 of the Samba suite.127 <para>This man page is correct for Samba versions from 3.5.0 to 4.0.6. 121 128 </para> 122 129 </refsect1> -
vendor/current/docs-xml/manpages/vfs_commit.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_crossrename.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 102 102 <refsect1> 103 103 <title>VERSION</title> 104 <para>This man page is correct for version 3.6.0 of the Samba suite.104 <para>This man page is correct for version 4.0.0 of the Samba suite. 105 105 </para> 106 106 </refsect1> -
vendor/current/docs-xml/manpages/vfs_default_quota.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_dirsort.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_extd_audit.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_fake_perms.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_fileid.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_full_audit.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 39 39 40 40 <simplelist> 41 <member>aio_cancel</member>42 <member>aio_error</member>43 <member>aio_fsync</member>44 <member>aio_read</member>45 <member>aio_return</member>46 <member>aio_suspend</member>47 <member>aio_write</member>48 41 <member>chdir</member> 49 42 <member>chflags</member> … … 54 47 <member>closedir</member> 55 48 <member>connect</member> 49 <member>copy_chunk_send</member> 50 <member>copy_chunk_recv</member> 56 51 <member>disconnect</member> 57 52 <member>disk_free</member> … … 68 63 <member>fsync</member> 69 64 <member>ftruncate</member> 65 <member>get_compression</member> 70 66 <member>get_nt_acl</member> 71 67 <member>get_quota</member> … … 75 71 <member>getxattr</member> 76 72 <member>kernel_flock</member> 77 <member>lgetxattr</member>78 73 <member>link</member> 79 74 <member>linux_setlease</member> 80 75 <member>listxattr</member> 81 <member>llistxattr</member>82 76 <member>lock</member> 83 <member>lremovexattr</member>84 77 <member>lseek</member> 85 <member>lsetxattr</member>86 78 <member>lstat</member> 87 79 <member>mkdir</member> … … 101 93 <member>seekdir</member> 102 94 <member>sendfile</member> 95 <member>set_compression</member> 103 96 <member>set_nt_acl</member> 104 97 <member>set_quota</member> 105 98 <member>setxattr</member> 99 <member>snap_check_path</member> 100 <member>snap_create</member> 101 <member>snap_delete</member> 106 102 <member>stat</member> 107 103 <member>statvfs</member> 108 104 <member>symlink</member> 109 <member>sys_acl_add_perm</member>110 <member>sys_acl_clear_perms</member>111 <member>sys_acl_create_entry</member>112 105 <member>sys_acl_delete_def_file</member> 113 <member>sys_acl_free_acl</member>114 <member>sys_acl_free_qualifier</member>115 <member>sys_acl_free_text</member>116 <member>sys_acl_get_entry</member>117 106 <member>sys_acl_get_fd</member> 118 107 <member>sys_acl_get_file</member> 119 <member>sys_acl_get_perm</member>120 <member>sys_acl_get_permset</member>121 <member>sys_acl_get_qualifier</member>122 <member>sys_acl_get_tag_type</member>123 <member>sys_acl_init</member>124 108 <member>sys_acl_set_fd</member> 125 109 <member>sys_acl_set_file</member> 126 <member>sys_acl_set_permset</member>127 <member>sys_acl_set_qualifier</member>128 <member>sys_acl_set_tag_type</member>129 <member>sys_acl_to_text</member>130 <member>sys_acl_valid</member>131 110 <member>telldir</member> 132 111 <member>unlink</member> … … 169 148 170 149 <varlistentry> 171 <term> vfs_full_audit:prefix = STRING</term>150 <term>full_audit:prefix = STRING</term> 172 151 <listitem> 173 152 <para>Prepend audit messages with STRING. STRING is … … 181 160 182 161 <varlistentry> 183 <term> vfs_full_audit:success = LIST</term>162 <term>full_audit:success = LIST</term> 184 163 <listitem> 185 164 <para>LIST is a list of VFS operations that should be 186 165 recorded if they succeed. Operations are specified using 187 166 the names listed above. Operations can be unset by prefixing 188 the names with "!". 167 the names with "!". The default is all operations. 189 168 </para> 190 169 … … 193 172 194 173 <varlistentry> 195 <term> vfs_full_audit:failure = LIST</term>174 <term>full_audit:failure = LIST</term> 196 175 <listitem> 197 176 <para>LIST is a list of VFS operations that should be 198 177 recorded if they failed. Operations are specified using 199 178 the names listed above. Operations can be unset by prefixing 200 the names with "!". 179 the names with "!". The default is all operations. 201 180 </para> 202 181 … … 224 203 </para> 225 204 205 </listitem> 206 </varlistentry> 207 208 <varlistentry> 209 <term>full_audit:syslog = true/false</term> 210 <listitem> 211 <para>Log messages to syslog (default) or as a debug level 1 212 message. 213 </para> 214 </listitem> 215 </varlistentry> 216 217 <varlistentry> 218 <term>full_audit:log_secdesc = true/false</term> 219 <listitem> 220 <para>Log an sddl form of the security descriptor coming in 221 when a client sets an acl. Defaults to false. 222 </para> 226 223 </listitem> 227 224 </varlistentry> -
vendor/current/docs-xml/manpages/vfs_gpfs.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 43 43 </para> 44 44 45 <para><command>NOTE:</command> This module follows the posix-acl behaviour45 <para><command>NOTE:</command> This module follows the posix-acl behaviour 46 46 and hence allows permission stealing via chown. Samba might allow at a later 47 47 point in time, to restrict the chown via this module as such restrictions … … 49 49 </para> 50 50 51 <para>This module makes use of the smb.conf parameter 52 <smbconfoption name="acl map full control"></smbconfoption>. 53 When set to yes (the default), this parameter will add in the FILE_DELETE_CHILD 54 bit on a returned ACE entry for a file (not a directory) that already 55 contains all file permissions except for FILE_DELETE and FILE_DELETE_CHILD. 56 This can prevent Windows applications that request GENERIC_ALL access 57 from getting ACCESS_DENIED errors when running against a filesystem 58 with NFSv4 compatible ACLs. 59 </para> 60 51 61 <para>This module is stackable.</para> 62 63 <para>Since Samba 4.0 all options are per share options.</para> 52 64 53 65 </refsect1> … … 119 131 </para></listitem> 120 132 <listitem><para> 121 <command>no</command> - Announce HSM. 122 </para></listitem> 123 </itemizedlist> 124 </listitem> 125 133 <command>yes</command> - Announce HSM. 134 </para></listitem> 135 </itemizedlist> 136 </listitem> 137 138 </varlistentry> 139 140 <varlistentry> 141 <term>gpfs:recalls = [ yes | no ]</term> 142 <listitem> 143 <para> When this option is set to no, an attempt to 144 open an offline file will be rejected with access 145 denied. This helps preventing recall storms triggered 146 by careless applications like Finder and 147 Explorer.</para> 148 149 <itemizedlist> 150 <listitem><para><command>yes(default)</command> - Open 151 files that are offline. This will recall the files 152 from HSM.</para></listitem> 153 <listitem><para><command>no</command> - Reject access 154 to offline files with access denied. This will prevent 155 recalls of files from HSM. Using this setting also 156 requires gpfs:hsm to be set to yes.</para></listitem> 157 </itemizedlist> 158 159 </listitem> 126 160 </varlistentry> 127 161 … … 175 209 <para> 176 210 GPFS ACLs doesn't know about the 'APPEND' right. 177 This option enlets Samba map the 'APPEND' right to 'WRITE'.211 This option lets Samba map the 'APPEND' right to 'WRITE'. 178 212 </para> 179 213 … … 184 218 <listitem><para> 185 219 <command>no</command> - do not map 'APPEND' to 'WRITE'. 220 </para></listitem> 221 </itemizedlist> 222 </listitem> 223 224 </varlistentry> 225 <varlistentry> 226 227 <term>gpfs:acl = [ yes | no ]</term> 228 <listitem> 229 <para> 230 This option lets Samba use or ignore GPFS ACLs. 231 </para> 232 233 <itemizedlist> 234 <listitem><para> 235 <command>yes(default)</command> - use GPFS ACLs. 236 </para></listitem> 237 <listitem><para> 238 <command>no</command> - do not use GPFS ACLs and pass everything 239 to the next SMB_VFS module. 186 240 </para></listitem> 187 241 </itemizedlist> … … 222 276 <varlistentry> 223 277 278 <term>gpfs:dfreequota = [ yes | no ]</term> 279 <listitem> 280 <para> 281 Adjust reporting of the size and free space of a share 282 according to quotas. If this setting is "yes", a 283 request for size and free space will also evaluate the 284 user quota of the user requesting the data and the 285 group quota of the primary group of the user. Fileset 286 quotas are not queried, since GPFS already provides 287 the option --dfreequota to reflect the fileset quota 288 in the free space query. Please use that option to 289 include fileset quotas in the reported disk space. 290 </para> 291 292 <para> 293 If any of the soft or hard quota limits has been 294 reached, the free space will be reported as 0. If a 295 quota is in place, but the limits have not been 296 reached, the free space will be reported according to 297 the space left in the quota. If more than one quota 298 applies the free space will be reported as the smallest 299 space left in those quotas. The size of the share 300 will be reported according to the quota usage. If more 301 than one quota applies, the smallest size will be 302 reported for the share size according to these quotas. 303 </para> 304 305 <itemizedlist> 306 <listitem><para> 307 <command>yes</command> - include the quotas 308 when reporting the share size and free space 309 </para></listitem> 310 <listitem><para> 311 <command>no(default)</command> - do not include quotas, 312 simply report the size and free space of the file system 313 </para></listitem> 314 </itemizedlist> 315 </listitem> 316 317 </varlistentry> 318 <varlistentry> 319 320 <term>gpfs:prealloc = [ yes | no ]</term> 321 <listitem> 322 <para> 323 If set to yes the gpfs_prealloc function will be used in the 324 fallocate callback when appropriate. If set to no gpfs_prealloc 325 will not be used. In both cases the system and libc calls are 326 avoided. 327 </para> 328 329 <itemizedlist> 330 <listitem><para> 331 <command>yes (default)</command> - Use gpfs_prealloc for the 332 fallocate callback. 333 </para></listitem> 334 <listitem><para> 335 <command>no</command> - Do not use gpfs_prealloc for the 336 fallocate callback. 337 </para></listitem> 338 </itemizedlist> 339 </listitem> 340 341 </varlistentry> 342 343 <varlistentry> 344 345 <term>gpfs:settimes = [ yes | no ]</term> 346 <listitem> 347 <para> 348 Use the gpfs_set_times API when changing the 349 timestamps of a file or directory. If the GPFS API is 350 not available the old method of using utime and the 351 GPFS winattr call will be used instead. 352 </para> 353 354 <itemizedlist> 355 <listitem><para> 356 <command>yes(default)</command> - Use gpfs_set_times. 357 Fall back to utime and winattr when it is not available. 358 </para></listitem> 359 <listitem><para> 360 <command>no</command> - Do not use gpfs_set_times. 361 </para></listitem> 362 </itemizedlist> 363 </listitem> 364 365 </varlistentry> 366 <varlistentry> 367 224 368 <term>nfs4:mode = [ simple | special ]</term> 225 369 <listitem> 226 370 <para> 227 Enable/Disable substitution of special IDs on GPFS. This parameter228 should not affect the windows users in anyway. It only ensures that Samba 229 sets the special IDs - OWNER@ and GROUP@ ( mappings to simple uids ) 230 that are relevant to GPFS.371 Controls substitution of special IDs (OWNER@ and GROUP@) on GPFS. 372 The use of mode simple is recommended. 373 In this mode only non inheriting ACL entries for the file owner 374 and group are mapped to special IDs. 231 375 </para> 232 376 233 377 <para>The following MODEs are understood by the module:</para> 234 378 <itemizedlist> 235 <listitem><para><command>simple(default)</command> - do not use special IDs in GPFS ACEs</para></listitem>236 <listitem><para><command>special </command> - use special IDs in GPFS ACEs. </para></listitem>379 <listitem><para><command>simple(default)</command> - use OWNER@ and GROUP@ special IDs for non inheriting ACEs only.</para></listitem> 380 <listitem><para><command>special(deprecated)</command> - use OWNER@ and GROUP@ special IDs in ACEs for all file owner and group ACEs.</para></listitem> 237 381 </itemizedlist> 238 382 </listitem> … … 288 432 </para> 289 433 <itemizedlist> 290 <listitem><para><command>yes</command> Open files with O_SYNC291 </para></listitem> 292 <listitem><para><command>no (default)</command> Open files as434 <listitem><para><command>yes</command> - Open files with O_SYNC 435 </para></listitem> 436 <listitem><para><command>no (default)</command> - Open files as 293 437 normal Samba would do 294 438 </para></listitem> … … 328 472 <para> 329 473 At build time, only the header file <command>gpfs_gpl.h</command> 330 is required 474 is required, which is a symlink to <command>gpfs.h</command> in 331 475 gpfs versions newer than 3.2.1 PTF8. 332 476 </para> -
vendor/current/docs-xml/manpages/vfs_netatalk.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_prealloc.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_preopen.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_readahead.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_readonly.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_recycle.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfs_shadow_copy.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 14 14 <refnamediv> 15 15 <refname>vfs_shadow_copy</refname> 16 <refpurpose> Make a Samba share read only for a specified time period</refpurpose>16 <refpurpose>Expose snapshots to Windows clients as shadow copies.</refpurpose> 17 17 </refnamediv> 18 18 -
vendor/current/docs-xml/manpages/vfs_shadow_copy2.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 14 14 <refnamediv> 15 15 <refname>vfs_shadow_copy2</refname> 16 <refpurpose>Expose snapshots to Windows clients as shadow copies.</refpurpose> 16 <refpurpose>Expose snapshots to Windows clients as shadow copies. 17 </refpurpose> 17 18 </refnamediv> 18 19 … … 30 31 <manvolnum>7</manvolnum></citerefentry> suite.</para> 31 32 32 <para>The <command>vfs_shadow_copy2</command> VFS module functionality 33 that is similar to Microsoft Shadow Copy services. When setup properly, 33 <para> 34 The <command>vfs_shadow_copy2</command> VFS module offers a 35 functionality similar to Microsoft Shadow Copy services. 36 When set up properly, 34 37 this module allows Microsoft Shadow Copy clients to browse 35 "shadow copies" on Samba shares. 36 </para> 37 38 <para>This is a 2nd implementation of a shadow copy module. This 39 version has the following features:</para> 38 through file system snapshots as "shadow copies" on Samba shares. 39 </para> 40 41 <para> 42 This is a second implementation of a shadow copy module 43 which has the following additional features (compared to the original 44 <citerefentry><refentrytitle>shadow_copy</refentrytitle> 45 <manvolnum>8</manvolnum></citerefentry> module): 46 </para> 40 47 <orderedlist continuation="restarts" inheritnum="ignore" numeration="arabic"> 41 <listitem><para>You don't need to populate your shares with symlinks to the 42 snapshots. This can be very important when you have thousands of 43 shares, or use [homes].</para></listitem> 44 <listitem><para>The inode number of the files is altered so it is different 45 from the original. This allows the 'restore' button to work 46 without a sharing violation.</para></listitem> 48 <listitem><para> 49 There is no need any more to populate your share's root directory 50 with symlinks to the snapshots if the file system stores the 51 snapshots elsewhere. 52 Instead, you can flexibly configure the module where to look for 53 the file system snapshots. 54 This can be very important when you have thousands of 55 shares, or use [homes]. 56 </para></listitem> 57 <listitem><para> 58 Snapshot directories need not be in one fixed central place but 59 can be located anywhere in the directory tree. This mode helps to 60 support file systems that offer snapshotting of particular 61 subtrees, for example the GPFS independent file sets. 62 </para></listitem> 63 <listitem><para> 64 Vanity naming for snapshots: snapshots can be named in any format 65 compatible with str[fp]time conversions. 66 </para></listitem> 67 <listitem><para> 68 Timestamps can be represented in localtime rather than UTC. 69 </para></listitem> 70 <listitem><para> 71 The inode number of the files can optionally be altered to be 72 different from the original. This fixes the 'restore' button 73 in the Windows GUI to work without a sharing violation when 74 serving from file systems, like GPFS, that return the same 75 device and inode number for the snapshot file and the original. 76 </para></listitem> 77 <listitem><para> 78 Shadow copy results are by default sorted before being sent to the 79 client. This is beneficial for filesystems that don't read 80 directories alphabetically (the default unix). Sort ordering can be 81 configured and sorting can be turned off completely if the file 82 system sorts its directory listing. 83 </para></listitem> 47 84 </orderedlist> 48 85 … … 59 96 </para> 60 97 61 <para>Filesystem snapshots must be mounted on98 <para>Filesystem snapshots must be available under 62 99 specially named directories in order to be recognized by 63 <command>vfs_shadow_copy2</command>. The snapshot mount points must 64 be immediate children of a the directory being shared.</para> 65 66 <para>The snapshot naming convention is @GMT-YYYY.MM.DD-hh.mm.ss, 67 where: 100 <command>vfs_shadow_copy2</command>. These snapshot directory 101 is typically a direct subdirectory of the share root's mountpoint 102 but there are other modes that can be configured with the 103 parameters described in detail below.</para> 104 105 <para>The snapshot at a given point in time is expected in a 106 subdirectory of the snapshot directory where the snapshot's 107 directory is expected to be a formatted version of the 108 snapshot time. The default format which can be changed 109 with the <command>shadow:format</command> option 110 is @GMT-YYYY.MM.DD-hh.mm.ss, where: 68 111 <itemizedlist> 69 <listitem><para><command>YYYY</command> is the 4 digit year</para></listitem> 70 <listitem><para><command>MM</command> is the 2 digit month</para></listitem> 71 <listitem><para><command>DD</command> is the 2 digit day</para></listitem> 72 <listitem><para><command>hh</command> is the 2 digit hour</para></listitem> 73 <listitem><para><command>mm</command> is the 2 digit minute</para></listitem> 74 <listitem><para><command>ss</command> is the 2 digit second.</para></listitem> 75 </itemizedlist> 76 </para> 77 78 <para>The <command>vfs_shadow_copy2</command> snapshot naming convention can be 79 produced with the following <citerefentry><refentrytitle>date</refentrytitle> 112 <listitem><para><command>YYYY</command> is the 4 digit year</para></listitem> 113 <listitem><para><command>MM</command> is the 2 digit month</para></listitem> 114 <listitem><para><command>DD</command> is the 2 digit day</para></listitem> 115 <listitem><para><command>hh</command> is the 2 digit hour</para></listitem> 116 <listitem><para><command>mm</command> is the 2 digit minute</para></listitem> 117 <listitem><para><command>ss</command> is the 2 digit second.</para></listitem> 118 </itemizedlist> 119 </para> 120 121 <para>The <command>vfs_shadow_copy2</command> snapshot naming 122 convention can be produced with the following 123 <citerefentry><refentrytitle>date</refentrytitle> 80 124 <manvolnum>1</manvolnum></citerefentry> command: 81 125 <programlisting> … … 90 134 <variablelist> 91 135 <varlistentry> 136 <term>shadow:mountpoint = MOUNTPOINT 137 </term> 138 <listitem> 139 <para> 140 With this parameter, one can specify the mount point 141 of the filesystem that contains the share path. 142 Usually this mount point is automatically detected. 143 But for some constellations, in particular tests, 144 it can be convenient to be able to specify it. 145 </para> 146 <para>Example: shadow:mountpoint = /path/to/filesystem</para> 147 <para>Default: shadow:mountpoint = NOT SPECIFIED</para> 148 </listitem> 149 </varlistentry> 150 151 <varlistentry> 92 152 <term>shadow:snapdir = SNAPDIR 93 153 </term> 94 154 <listitem> 95 <para>Path to the directory where snapshots are kept. 96 </para> 155 <para> 156 Path to the directory where the file system of 157 the share keeps its snapshots. 158 If an absolute path is specified, it is used as-is. 159 If a relative path is specified, then it is taken 160 relative to the mount point of the filesystem of 161 the share root. (See <command>shadow:mountpoint</command>.) 162 </para> 163 <para> 164 Note that <command>shadow:snapdirseverywhere</command> 165 depends on this parameter and needs a relative path. 166 Setting an absolute path disables 167 <command>shadow:snapdirseverywhere</command>. 168 </para> 169 <para> 170 Note that the <command>shadow:crossmountpoints</command> 171 option also requires a relative snapdir. 172 Setting an absolute path disables 173 <command>shadow:crossmountpoints</command>. 174 </para> 175 <para>Example: shadow:snapdir = /some/absolute/path</para> 176 <para>Default: shadow:snapdir = .snapshots</para> 97 177 </listitem> 98 178 </varlistentry> … … 102 182 </term> 103 183 <listitem> 104 <para>Path to the base directory that snapshots are from. 184 <para> 185 The basedir option allows one to specify a directory 186 between the share's mount point and the share root, 187 relative to which the file system's snapshots are taken. 188 </para> 189 <para> 190 For example, if 191 <itemizedlist> 192 <listitem><para> 193 <command>basedir = mountpoint/rel_basedir</command> 194 </para></listitem> 195 <listitem><para> 196 <command>share_root = basedir/rel_share_root</command> 197 </para></listitem> 198 <listitem><para> 199 <command>snapshot_path = mountpoint/snapdir</command> 200 </para> 201 <para> 202 or 203 <command>snapshot_path = snapdir</command> 204 if snapdir is absolute 205 </para></listitem> 206 </itemizedlist> 207 then the snapshot of a 208 <command>file = mountpoint/rel_basedir/rel_share_root/rel_file</command> 209 at a time TIME will be found under 210 <command>snapshot_path/FS_GMT_TOKEN(TIME)/rel_share_root/rel_file</command>, 211 where FS_GMT_TOKEN(TIME) is the timestamp string belonging 212 to TIME in the format required by the file system. 213 (See <command>shadow:format</command>.) 214 </para> 215 <para>The default for the basedir is the mount point 216 of the file system of the share root 217 (see <command>shadow:mountpoint</command>). 218 </para> 219 <para> 220 Note that the <command>shadow:snapdirseverywhere</command> 221 and <command>shadow:crossmountpoints</command> 222 options are incompatible with <command>shadow:basedir</command> 223 and disable the basedir setting. 224 </para> 225 </listitem> 226 </varlistentry> 227 228 <varlistentry> 229 <term>shadow:snapsharepath = SNAPSHAREPATH 230 </term> 231 <listitem> 232 <para> 233 With this parameter, one can specify the path of the share's 234 root directory in snapshots, relative to the snapshot's 235 root directory. It is an alternative method to 236 <command>shadow:basedir</command>, allowing greater control. 237 </para> 238 <para> 239 For example, if within each 240 snapshot the files of the share have a 241 <command>path/to/share/</command> prefix, then 242 <command>shadow:snapsharepath</command> can be 243 set to <command>path/to/share</command>. 244 </para> 245 <para> 246 With this parameter, it is no longer assumed that a 247 snapshot represents an image of the original file system or 248 a portion of it. For example, a system could perform 249 backups of only files contained in shares, and then 250 expose the backup files in a logical structure: 251 </para> 252 <itemizedlist> 253 <listitem><para>share1/</para></listitem> 254 <listitem><para>share2/</para></listitem> 255 <listitem><para>.../</para></listitem> 256 </itemizedlist> 257 <para> 258 Note that the <command>shadow:snapdirseverywhere</command> 259 and the <command>shadow:basedir</command> options 260 are incompatible with <command>shadow:snapsharepath</command> 261 and disable <command>shadow:snapsharepath</command> setting. 262 </para> 263 <para>Example: shadow:snapsharepath = path/to/share</para> 264 <para>Default: shadow:snapsharepath = NOT SPECIFIED</para> 265 </listitem> 266 </varlistentry> 267 268 <varlistentry> 269 <term>shadow:sort = asc/desc 270 </term> 271 <listitem> 272 <para>By default, this module sorts the shadow copy data 273 alphabetically before sending it to the client. 274 With this parameter, one can specify the sort order. 275 Possible known values are desc (descending, the default) 276 and asc (ascending). If the file system lists directories 277 alphabetically sorted, one can turn off sorting in this 278 module by specifying any other value. 279 </para> 280 <para>Example: shadow:sort = asc</para> 281 <para>Example: shadow:sort = none</para> 282 <para>Default: shadow:sort = desc</para> 283 </listitem> 284 </varlistentry> 285 286 <varlistentry> 287 <term>shadow:localtime = yes/no 288 </term> 289 <listitem> 290 <para>This is an optional parameter that indicates whether the 291 snapshot names are in UTC/GMT or in local time. If it is 292 disabled then UTC/GMT is expected. 105 293 </para> 106 </listitem>107 </ varlistentry>108 109 <varlistentry> 110 <term>shadow:sort = asc/desc, or not specified for unsorted (default) 111 < /term>112 < listitem>113 < para>By this parameter one can specify that the shadow114 copy directories should be sorted before they are sent to the 115 client. This can be beneficial as unix filesystems are usually116 not listed alphabetically sorted. If enabled, you typically117 want to specify descending order.294 <para>shadow:localtime = no</para> 295 </listitem> 296 </varlistentry> 297 298 <varlistentry> 299 <term>shadow:format = format specification for snapshot names 300 </term> 301 <listitem> 302 <para>This is an optional parameter that specifies the format 303 specification for the naming of snapshots in the file system. 304 The format must be compatible with the conversion 305 specifications recognized by str[fp]time. 118 306 </para> 119 </listitem> 120 </varlistentry> 121 122 <varlistentry> 123 <term>shadow:localtime = yes/no 124 </term> 125 <listitem> 126 <para>This is an optional parameter that indicates whether the 127 snapshot names are in UTC/GMT or in local time. By default 128 UTC is expected. 129 </para> 130 </listitem> 131 </varlistentry> 132 133 <varlistentry> 134 <term>shadow:format = format specification for snapshot names 135 </term> 136 <listitem> 137 <para>This is an optional parameter that specifies the format 138 specification for the naming of snapshots. The format must 139 be compatible with the conversion specifications recognized 140 by str[fp]time. The default value is "@GMT-%Y.%m.%d-%H.%M.%S". 141 </para> 142 </listitem> 143 </varlistentry> 307 <para>Default: shadow:format = "@GMT-%Y.%m.%d-%H.%M.%S"</para> 308 </listitem> 309 </varlistentry> 310 311 <varlistentry> 312 <term>shadow:sscanf = yes/no</term> 313 <listitem> 314 <para> 315 This parameter can be used to specify that the time in 316 format string is given as an unsigned long integer (%lu) 317 rather than a time strptime() can parse. 318 The result must be a unix time_t time. 319 </para> 320 <para>Default: shadow:sscanf = no</para> 321 </listitem> 322 </varlistentry> 144 323 145 324 <varlistentry> … … 156 335 will fail with a sharing violation. 157 336 </para> 158 </listitem> 159 </varlistentry> 337 <para>Default: shadow:fixinodes = no</para> 338 </listitem> 339 </varlistentry> 340 341 <varlistentry> 342 <term>shadow:snapdirseverywhere = yes/no 343 </term> 344 <listitem> 345 <para> 346 If you enable 347 <command moreinfo="none">shadow:snapdirseverywhere </command> 348 then this module will look 349 out for snapshot directories in the current working directory 350 and all parent directories, stopping at the mount point 351 by default. 352 But see <command>shadow:crossmountpoints</command> how to change 353 that behaviour. 354 </para> 355 <para> 356 An example where this is needed are independent filesets in 357 IBM's GPFS, but other filesystems might support snapshotting 358 only particular subtrees of the filesystem as well. 359 </para> 360 <para> 361 Note that <command>shadow:snapdirseverywhere</command> 362 depends on <command>shadow:snapdir</command> and needs it to be 363 a relative path. Setting an absolute snapdir path disables 364 <command>shadow:snapdirseverywhere</command>. 365 </para> 366 <para> 367 Note that this option is incompatible with the 368 <command>shadow:basedir</command> option and removes the 369 <command>shadow:basedir</command> setting by itself. 370 </para> 371 <para>Example: shadow:snapdirseverywhere = yes</para> 372 <para>Default: shadow:snapdirseverywhere = no</para> 373 </listitem> 374 </varlistentry> 375 376 <varlistentry> 377 <term>shadow:crossmountpoints = yes/no 378 </term> 379 <listitem> 380 <para> 381 This option is effective in the case of 382 <command>shadow:snapdirseverywhere = yes</command>. 383 Setting this option makes the module not stop at the 384 first mount point encountered when looking for snapdirs, 385 but lets it search potentially all through the path 386 instead. 387 </para> 388 <para> 389 An example where this is needed are independent filesets in 390 IBM's GPFS, but other filesystems might support snapshotting 391 only particular subtrees of the filesystem as well. 392 </para> 393 <para> 394 Note that <command>shadow:crossmountpoints</command> 395 depends on <command>shadow:snapdir</command> and needs it to be 396 a relative path. Setting an absolute snapdir path disables 397 <command>shadow:crossmountpoints</command>. 398 </para> 399 <para> 400 Note that this option is incompatible with the 401 <command>shadow:basedir</command> option and removes the 402 <command>shadow:basedir</command> setting by itself. 403 </para> 404 <para>Example: shadow:crossmountpoints = yes</para> 405 <para>Default: shadow:crossmountpoints = no</para> 406 </listitem> 407 </varlistentry> 408 160 409 </variablelist> 161 410 </refsect1> … … 195 444 <title>VERSION</title> 196 445 197 <para>This man page is correct for version 3.2.7of the Samba suite.446 <para>This man page is correct for version 4.0 of the Samba suite. 198 447 </para> 199 448 </refsect1> -
vendor/current/docs-xml/manpages/vfs_streams_depot.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 53 53 </varlistentry> 54 54 55 <varlistentry> 56 <term>streams_depot:delete_lost = [ yes | no ]</term> 57 <listitem> 58 <para>In the case of an already existing data streams directory 59 for a newly created file the streams directory will be renamed 60 to "lost-%lu", random(). With this option lost stream directories 61 will be removed instead of renamed.</para> 62 <itemizedlist> 63 <listitem><para> 64 <command>no(default)</command> - rename lost streams to 65 "lost-%lu", random(). 66 </para></listitem> 67 <listitem><para> 68 <command>yes</command> - remove lost streams. 69 </para></listitem> 70 </itemizedlist> 71 </listitem> 72 </varlistentry> 73 55 74 </variablelist> 56 75 </refsect1> -
vendor/current/docs-xml/manpages/vfs_streams_xattr.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 34 34 system does not support the concept of multiple data streams per file, 35 35 the streams_xattr module stores the data in posix extended attributes 36 (xattrs). The name of these attributes is 37 user.DosStream."ADS-NAME".</para> 36 (xattrs). The name of these attributes by default is 37 user.DosStream."ADS-NAME". The prefix "user.DosStream." can be changed 38 with the module option <command>streams_xattr:prefix</command>, but be 39 aware that this will also expose those ADS over the SMB extended 40 attributes interface.</para> 38 41 39 42 <para>The file system that is shared with this module enabled must … … 44 47 that stores small zone information in streams but will fail for 45 48 applications that store serious amounts of data in ADSs.</para> 49 50 <para>CAUTION: Make sure to set "kernel oplocks = no" in smb.conf if 51 if you use this module because this combination is currently broken. 52 See Bug 7537 for details.</para> 53 </refsect1> 54 55 <refsect1> 56 <title>OPTIONS</title> 57 58 <variablelist> 59 60 <varlistentry> 61 <term>streams_xattr:prefix = STRING</term> 62 <listitem> 63 <para>Name prefix used when storing an ADS in an xattr, defaults to 64 <command>user.DosStream.</command>. Changing this will also 65 expose ADS over the SMB extended attributes interface.</para> 66 </listitem> 67 </varlistentry> 68 69 <varlistentry> 70 <term>streams_xattr:store_stream_type = [yes|no]</term> 71 <listitem> 72 <para>Whether the xattr names for Alternate Data Streams of type 73 "$DATA" are suffixed by the stream type string ":$DATA". 74 The default is <command>yes</command>.</para> 75 </listitem> 76 </varlistentry> 77 78 </variablelist> 79 46 80 </refsect1> 47 81 -
vendor/current/docs-xml/manpages/vfs_time_audit.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 32 32 <para>The <command>time_audit</command> VFS module logs system calls 33 33 that take longer than the number of milliseconds defined by the variable 34 <command>time_audit: audit_timeout</command>. It will log the calls and34 <command>time_audit:timeout</command>. It will log the calls and 35 35 the time spent in it. 36 36 </para> … … 52 52 <varlistentry> 53 53 54 <term>time_audit: audit_timeout = number of milliseconds</term>54 <term>time_audit:timeout = number of milliseconds</term> 55 55 <listitem> 56 56 <para>VFS calls that take longer than the defined number of milliseconds … … 75 75 <smbconfoption name="path">/test/sample_share</smbconfoption> 76 76 <smbconfoption name="vfs objects">time_audit</smbconfoption> 77 <smbconfoption name="time_audit: audit_timeout">3000</smbconfoption>77 <smbconfoption name="time_audit:timeout">3000</smbconfoption> 78 78 </programlisting> 79 79 </refsect1> … … 82 82 <refsect1> 83 83 <title>VERSION</title> 84 <para>This man page is correct for version 3.6.0 of the Samba suite.84 <para>This man page is correct for version 4.0.0 of the Samba suite. 85 85 </para> 86 86 </refsect1> -
vendor/current/docs-xml/manpages/vfs_xattr_tdb.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/vfstest.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 48 48 <varlistentry> 49 49 <term>-c|--command=command</term> 50 <listitem><para>Execute the specified ( colon-separated) commands.50 <listitem><para>Execute the specified (<constant>semicolon</constant>-separated) commands. 51 51 See below for the commands that are available. 52 52 </para> </listitem> … … 116 116 <listitem><para><command>mknod</command> - VFS mknod()</para></listitem> 117 117 <listitem><para><command>realpath</command> - VFS realpath()</para></listitem> 118 119 <listitem><para><command>getxattr</command> - VFS getxattr()</para></listitem> 120 <listitem><para><command>listxattr</command> - VFS listxattr()</para></listitem> 121 <listitem><para><command>setxattr</command> - VFS setxattr()</para></listitem> 122 <listitem><para><command>removexattr</command> - VFS removexattr()</para></listitem> 123 <listitem><para><command>fget_nt_acl</command> - VFS fget_nt_acl()</para></listitem> 124 <listitem><para><command>get_nt_acl</command> - VFS get_nt_acl()</para></listitem> 125 <listitem><para><command>fset_nt_acl</command> - VFS fset_nt_acl()</para></listitem> 126 <listitem><para><command>set_nt_acl</command> - VFS open() and fset_nt_acl()</para></listitem> 127 <listitem><para><command>fchmod_acl</command> - VFS fchmod_acl()</para></listitem> 128 <listitem><para><command>chmod_acl</command> - VFS chmod_acl()</para></listitem> 129 <listitem><para><command>sys_acl_get_file</command> - VFS sys_acl_get_file()</para></listitem> 130 <listitem><para><command>sys_acl_get_fd</command> - VFS sys_acl_get_fd()</para></listitem> 131 <listitem><para><command>sys_acl_blob_get_file</command> - VFS sys_acl_blob_get_file()</para></listitem> 132 <listitem><para><command>sys_acl_blob_get_fd</command> - VFS sys_acl_blob_get_fd()</para></listitem> 133 <listitem><para><command>sys_acl_delete_def_file</command> - VFS sys_acl_delete_def_file()</para></listitem> 134 <listitem><para><command>test_chain</command> - test chain code</para></listitem> 135 <listitem><para><command>translate_name</command> - VFS translate_name()</para></listitem> 136 118 137 </itemizedlist> 119 138 … … 136 155 <title>VERSION</title> 137 156 138 <para>This man page is correct for version 3 of the Samba157 <para>This man page is correct for version 3 and 4 of the Samba 139 158 suite.</para> 140 159 </refsect1> … … 148 167 to the way the Linux kernel is developed.</para> 149 168 150 <para>The vfstest man page was written by Jelmer Vernooij. </para>169 <para>The vfstest man page was written by Jelmer Vernooij. Updated version by Guenter Kukkukk.</para> 151 170 </refsect1> 152 171 -
vendor/current/docs-xml/manpages/wbinfo.1.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">User Commands</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 25 25 <arg choice="opt">--allocate-uid</arg> 26 26 <arg choice="opt">-c</arg> 27 <arg choi de="opt">--ccache-save</arg>28 <arg choi de="opt">--change-user-password</arg>27 <arg choice="opt">--ccache-save</arg> 28 <arg choice="opt">--change-user-password</arg> 29 29 <arg choice="opt">-D domain</arg> 30 <arg choice="opt">--dc-info domain</arg> 30 31 <arg choice="opt">--domain domain</arg> 31 <arg choi de="opt">--dsgetdcname domain</arg>32 <arg choice="opt">--dsgetdcname domain</arg> 32 33 <arg choice="opt">-g</arg> 33 34 <arg choice="opt">--getdcname domain</arg> 34 35 <arg choice="opt">--get-auth-user</arg> 35 36 <arg choice="opt">-G gid</arg> 36 <arg choi de="opt">--gid-info</arg>37 <arg choi de="opt">--group-info</arg>37 <arg choice="opt">--gid-info gid</arg> 38 <arg choice="opt">--group-info group</arg> 38 39 <arg choice="opt">--help|-?</arg> 39 40 <arg choice="opt">-i user</arg> 40 41 <arg choice="opt">-I ip</arg> 41 42 <arg choice="opt">-K user%password</arg> 42 <arg choide="opt">--lanman</arg> 43 <arg choice="opt">--krb5ccname cctype</arg> 44 <arg choice="opt">--lanman</arg> 45 <arg choice="opt">--logoff</arg> 46 <arg choice="opt">--logoff-uid uid</arg> 47 <arg choice="opt">--logoff-user username</arg> 48 <arg choice="opt">--lookup-sids</arg> 43 49 <arg choice="opt">-m</arg> 44 50 <arg choice="opt">-n name</arg> 45 51 <arg choice="opt">-N netbios-name</arg> 46 <arg choi de="opt">--ntlmv2</arg>47 <arg choi de="opt">--online-status</arg>52 <arg choice="opt">--ntlmv2</arg> 53 <arg choice="opt">--online-status</arg> 48 54 <arg choice="opt">--own-domain</arg> 49 55 <arg choice="opt">-p</arg> 50 56 <arg choice="opt">-P|--ping-dc</arg> 57 <arg choice="opt">--pam-logon user%password</arg> 51 58 <arg choice="opt">-r user</arg> 52 <arg choide="opt">-R|--lookup-rids</arg> 59 <arg choice="opt">-R|--lookup-rids</arg> 60 <arg choice="opt">--remove-gid-mapping gid,sid</arg> 61 <arg choice="opt">--remove-uid-mapping uid,sid</arg> 53 62 <arg choice="opt">-s sid</arg> 54 63 <arg choice="opt">--separator</arg> 64 <arg choice="opt">--sequence</arg> 55 65 <arg choice="opt">--set-auth-user user%password</arg> 66 <arg choice="opt">--set-gid-mapping gid,sid</arg> 67 <arg choice="opt">--set-uid-mapping uid,sid</arg> 56 68 <arg choice="opt">-S sid</arg> 57 <arg choide="opt">--sid-aliases</arg> 58 <arg choide="opt">--sid-to-fullname</arg> 69 <arg choice="opt">--sid-aliases sid</arg> 70 <arg choice="opt">--sid-to-fullname sid</arg> 71 <arg choice="opt">--sids-to-unix-ids sidlist</arg> 59 72 <arg choice="opt">-t</arg> 60 73 <arg choice="opt">-u</arg> 61 74 <arg choice="opt">--uid-info uid</arg> 62 <arg choi de="opt">--usage</arg>75 <arg choice="opt">--usage</arg> 63 76 <arg choice="opt">--user-domgroups sid</arg> 77 <arg choice="opt">--user-sidinfo sid</arg> 64 78 <arg choice="opt">--user-sids sid</arg> 65 79 <arg choice="opt">-U uid</arg> … … 142 156 143 157 <varlistentry> 158 <term>--dc-info <replaceable>domain</replaceable></term> 159 <listitem><para>Displays information about the current domain controller for a domain. 160 </para></listitem> 161 </varlistentry> 162 163 <varlistentry> 144 164 <term>--domain <replaceable>name</replaceable></term> 145 165 <listitem><para>This parameter sets the domain on which any specified 146 166 operations will performed. If special domain name '.' is used to represent 147 167 the current domain to which <citerefentry><refentrytitle>winbindd</refentrytitle> 148 <manvolnum>8</manvolnum></citerefentry> belongs. Currently only the 149 <option>-u</option>, and <option>-g</option> options honor this parameter. 168 <manvolnum>8</manvolnum></citerefentry> belongs. A '*' as the domain name 169 means to enumerate over all domains (NOTE: This can take a long time and use 170 a lot of memory). 150 171 </para></listitem> 151 172 </varlistentry> … … 171 192 172 193 <varlistentry> 173 <term>--group-info <replaceable> user</replaceable></term>174 <listitem><para>Get group info f or user.194 <term>--group-info <replaceable>group</replaceable></term> 195 <listitem><para>Get group info from group name. 175 196 </para></listitem> 176 197 </varlistentry> … … 181 202 in the Windows NT domain for which the <citerefentry><refentrytitle>samba</refentrytitle> 182 203 <manvolnum>7</manvolnum></citerefentry> daemon is operating in. Groups in all trusted domains 183 will also be listed. Note that this operation does not assign204 can be listed with the --domain='*' option. Note that this operation does not assign 184 205 group ids to any groups that have not already been 185 206 seen by <citerefentry><refentrytitle>winbindd</refentrytitle> … … 238 259 239 260 <varlistentry> 261 <term>--krb5ccname <replaceable>KRB5CCNAME</replaceable></term> 262 <listitem><para>Allows one to request a sepcific kerberos credential 263 cache type used for authentication. 264 </para></listitem> 265 </varlistentry> 266 267 <varlistentry> 240 268 <term>--lanman</term> 241 269 <listitem><para>Use lanman cryptography for user authentication. 270 </para></listitem> 271 </varlistentry> 272 273 <varlistentry> 274 <term>--logoff</term> 275 <listitem><para>Logoff a user. 276 </para></listitem> 277 </varlistentry> 278 279 <varlistentry> 280 <term>--logoff-uid <replaceable>UID</replaceable></term> 281 <listitem><para>Define user uid used during logoff request. 282 </para></listitem> 283 </varlistentry> 284 285 <varlistentry> 286 <term>--logoff-user <replaceable>USERNAME</replaceable></term> 287 <listitem><para>Define username used during logoff request. 288 </para></listitem> 289 </varlistentry> 290 291 <varlistentry> 292 <term>--lookup-sids <replaceable>SID1,SID2...</replaceable></term> 293 <listitem><para>Looks up SIDs. SIDs must be specified as ASCII strings in the traditional Microsoft 294 format. For example, S-1-5-21-1455342024-3071081365-2475485837-500. 242 295 </para></listitem> 243 296 </varlistentry> … … 298 351 299 352 <varlistentry> 353 <term>--pam-logon <replaceable>username%password</replaceable></term> 354 <listitem><para>Attempt to authenticate a user in the same way 355 pam_winbind would do. 356 </para></listitem> 357 </varlistentry> 358 359 <varlistentry> 300 360 <term>-p|--ping</term> 301 361 <listitem><para>Check whether <citerefentry><refentrytitle>winbindd</refentrytitle> … … 326 386 <listitem><para>Converts RIDs to names. Uses a comma separated 327 387 list of rids. 388 </para></listitem> 389 </varlistentry> 390 391 <varlistentry> 392 <term>--remove-gid-mapping <replaceable>GID,SID</replaceable></term> 393 <listitem><para>Removes an existing GID to SID mapping from the database. 394 </para></listitem> 395 </varlistentry> 396 397 <varlistentry> 398 <term>--remove-uid-mapping <replaceable>UID,SID</replaceable></term> 399 <listitem><para>Removes an existing UID to SID mapping from the database. 328 400 </para></listitem> 329 401 </varlistentry> … … 341 413 <term>--separator</term> 342 414 <listitem><para>Get the active winbind separator. 415 </para></listitem> 416 </varlistentry> 417 418 <varlistentry> 419 <term>--sequence</term> 420 <listitem><para>This command has been deprecated. Please use 421 the --online-status option instead. 343 422 </para></listitem> 344 423 </varlistentry> … … 356 435 357 436 <varlistentry> 437 <term>--set-gid-mapping <replaceable>GID,SID</replaceable></term> 438 <listitem><para>Create a GID to SID mapping in the database. 439 </para></listitem> 440 </varlistentry> 441 442 <varlistentry> 443 <term>--set-uid-mapping <replaceable>UID,SID</replaceable></term> 444 <listitem><para>Create a UID to SID mapping in the database. 445 </para></listitem> 446 </varlistentry> 447 448 <varlistentry> 358 449 <term>-S|--sid-to-uid <replaceable>sid</replaceable></term> 359 450 <listitem><para>Convert a SID to a UNIX user id. If the SID … … 374 465 (DOMAIN\username). 375 466 </para></listitem> 467 </varlistentry> 468 469 <varlistentry> 470 <term>--sids-to-unix-ids <replaceable>sid1,sid2,sid3...</replaceable></term> 471 <listitem><para>Resolve SIDs to Unix IDs. 472 SIDs must be specified as ASCII strings 473 in the traditional Microsoft format. For example, 474 S-1-5-21-1455342024-3071081365-2475485837-500. </para></listitem> 376 475 </varlistentry> 377 476 … … 390 489 in the Windows NT domain for which the <citerefentry><refentrytitle>winbindd</refentrytitle> 391 490 <manvolnum>8</manvolnum></citerefentry> daemon is operating in. Users in all trusted domains 392 will also be listed. Note that this operation does not assign491 can be listed with the --domain='*' option. Note that this operation does not assign 393 492 user ids to any users that have not already been seen by <citerefentry> 394 493 <refentrytitle>winbindd</refentrytitle><manvolnum>8</manvolnum></citerefentry> … … 413 512 </para></listitem> 414 513 </varlistentry> 514 515 <varlistentry> 516 <term>--user-sidinfo <replaceable>sid</replaceable></term> 517 <listitem><para>Get user info by sid. 518 </para></listitem> 519 </varlistentry> 520 415 521 416 522 <varlistentry> -
vendor/current/docs-xml/manpages/winbind_krb5_locator.7.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">7</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 -
vendor/current/docs-xml/manpages/winbindd.8.xml
r860 r988 8 8 <refmiscinfo class="source">Samba</refmiscinfo> 9 9 <refmiscinfo class="manual">System Administration tools</refmiscinfo> 10 <refmiscinfo class="version"> 3.6</refmiscinfo>10 <refmiscinfo class="version">4.4</refmiscinfo> 11 11 </refmeta> 12 12 … … 21 21 <cmdsynopsis> 22 22 <command>winbindd</command> 23 <arg choice="opt">-D </arg>24 <arg choice="opt">-F </arg>25 <arg choice="opt">-S </arg>26 <arg choice="opt">-i </arg>23 <arg choice="opt">-D|--daemon</arg> 24 <arg choice="opt">-F|--foreground</arg> 25 <arg choice="opt">-S|--stdout</arg> 26 <arg choice="opt">-i|--interactive</arg> 27 27 <arg choice="opt">-d <debug level></arg> 28 28 <arg choice="opt">-s <smb config file></arg> 29 <arg choice="opt">-n</arg> 29 <arg choice="opt">-n|--no-caching</arg> 30 <arg choice="opt">--no-process-group</arg> 30 31 </cmdsynopsis> 31 32 </refsynopsisdiv> … … 136 137 <variablelist> 137 138 <varlistentry> 138 <term>-D </term>139 <term>-D|--daemon</term> 139 140 <listitem><para>If specified, this parameter causes 140 141 the server to operate as a daemon. That is, it detaches … … 146 147 147 148 <varlistentry> 148 <term>-F </term>149 <term>-F|--foreground</term> 149 150 <listitem><para>If specified, this parameter causes 150 151 the main <command>winbindd</command> process to not daemonize, … … 161 162 162 163 <varlistentry> 163 <term>-S </term>164 <term>-S|--stdout</term> 164 165 <listitem><para>If specified, this parameter causes 165 166 <command>winbindd</command> to log to standard output rather … … 169 170 &stdarg.server.debug; 170 171 &popt.common.samba; 171 & stdarg.help;172 173 <varlistentry> 174 <term>-i </term>172 &popt.autohelp; 173 174 <varlistentry> 175 <term>-i|--interactive</term> 175 176 <listitem><para>Tells <command>winbindd</command> to not 176 177 become a daemon and detach from the current terminal. This … … 183 184 184 185 <varlistentry> 185 <term>-n </term>186 <listitem><para>Disable caching. This means winbindd will187 alwayshave to wait for a response from the domain controller186 <term>-n|--no-caching</term> 187 <listitem><para>Disable some caching. This means winbindd will 188 often have to wait for a response from the domain controller 188 189 before it can respond to a client and this thus makes things 189 190 slower. The results will however be more accurate, since 190 191 results from the cache might not be up-to-date. This 191 192 might also temporarily hang winbindd if the DC doesn't respond. 193 This does not disable the samlogon cache, which is required for 194 group membership tracking in trusted environments. 195 </para></listitem> 196 </varlistentry> 197 198 <varlistentry> 199 <term>--no-process-group</term> 200 <listitem><para>Do not create a new process group for winbindd. 192 201 </para></listitem> 193 202 </varlistentry> … … 363 372 machine, unless a shared <smbconfoption name="idmap config * : backend"/> is configured.</para> 364 373 365 <para>If the theWindows NT SID to UNIX user and group id mapping374 <para>If the Windows NT SID to UNIX user and group id mapping 366 375 file is damaged or destroyed then the mappings will be lost. </para> 367 376 </refsect1>
Note:
See TracChangeset
for help on using the changeset viewer.