From 68aa8432723241ac2bf3ee5baf57a36c05f2594d Mon Sep 17 00:00:00 2001 From: vorlon Date: Wed, 6 Aug 2008 08:20:34 +0000 Subject: Load samba-3.2.1 into branches/samba/upstream. git-svn-id: svn://svn.debian.org/svn/pkg-samba/branches/samba/upstream@2104 fc4039ab-9d04-0410-8cac-899223bdd6b0 --- docs/htmldocs/manpages/net.8.html | 53 ++++++++++++++++++++++++++++----------- 1 file changed, 38 insertions(+), 15 deletions(-) (limited to 'docs/htmldocs/manpages/net.8.html') diff --git a/docs/htmldocs/manpages/net.8.html b/docs/htmldocs/manpages/net.8.html index e2f0cf8e1b..b8c3d0172f 100644 --- a/docs/htmldocs/manpages/net.8.html +++ b/docs/htmldocs/manpages/net.8.html @@ -365,17 +365,19 @@ The deployment of this configuration data can be activated in two levels from th activated by setting registry shares to “yes” in the [global] section and global configuration options are activated by setting include = registry in -the [global] section. +the [global] section for a mixed configuration or by setting +config backend = registry in the [global] +section for a registry-only configuration. See the smb.conf(5) manpage for details.

The conf commands are:

net conf list - Dump the complete configuration in smb.conf like format.
net conf import - Import configuration from file in smb.conf format.
net conf listshares - List the registry shares.
net conf drop - Delete the complete configuration from -registry.
net conf showshare - Show the definition of a registry share.
net conf addshare - Create a new registry share.
net conf delshare - Delete a registry share.
net conf setparm - Store a parameter.
net conf getparm - Retrieve the value of a parameter.
net conf delparm - Delete a parameter.

-

CONF LIST

+registry.net conf showshare - Show the definition of a registry share.net conf addshare - Create a new registry share.net conf delshare - Delete a registry share.net conf setparm - Store a parameter.net conf getparm - Retrieve the value of a parameter.net conf delparm - Delete a parameter.net conf getincludes - Show the includes of a share definition.net conf setincludes - Set includes for a share.net conf delincludes - Delete includes from a share definition.

+

CONF LIST

Print the configuration data stored in the registry in a smb.conf-like format to standard output. -

CONF IMPORT [--test|-T] filename [section]

+

CONF IMPORT [--test|-T] filename [section]

This command imports configuration from a file in smb.conf format. If a section encountered in the input file is present in registry, its contents is replaced. Sections of registry configuration that have @@ -385,32 +387,53 @@ Optionally, a section may be specified to restrict the effect of the import command to that specific section. A test mode is enabled by specifying the parameter "-T" on the commandline. In test mode, no changes are made to the registry, and the resulting configuration is printed to standard output instead. -

CONF LISTSHARES

+

CONF LISTSHARES

List the names of the shares defined in registry. -

CONF DROP

+

CONF DROP

Delete the complete configuration data from registry. -

CONF SHOWSHARE sharename

+

CONF SHOWSHARE sharename

Show the definition of the share or section specified. It is valid to specify "global" as sharename to retrieve the global configuration options from registry. -

CONF ADDSHARE sharename path [writeable={y|N} [guest_ok={y|N} [comment]]]

Create a new share definition in registry. +

CONF ADDSHARE sharename path [writeable={y|N} [guest_ok={y|N} [comment]]]

Create a new share definition in registry. The sharename and path have to be given. The share name may not be "global". Optionally, values for the very common options "writeable", "guest ok" and a "comment" may be specified. The same result may be obtained by a sequence of "net conf setparm" commands. -

CONF DELSHARE sharename

+

CONF DELSHARE sharename

Delete a share definition from registry. -

CONF SETPARM section parameter value

+

CONF SETPARM section parameter value

Store a parameter in registry. The section may be global or a sharename. The section is created if it does not exist yet. -

CONF GETPARM section parameter

+

CONF GETPARM section parameter

Show a parameter stored in registry. -

CONF DELPARM section parameter

+

CONF DELPARM section parameter

Delete a parameter stored in registry. -

-

HELP [COMMAND]

Gives usage information for the specified command.

VERSION

This man page is complete for version 3.0 of the Samba - suite.

AUTHOR

The original Samba software and related utilities +

CONF GETINCLUDES section

+Get the list of includes for the provided section (global or share). +

+Note that due to the nature of the registry database and the nature of include directives, +the includes need special treatment: Parameters are stored in registry by the parameter +name as valuename, so there is only ever one instance of a parameter per share. +Also, a specific order like in a text file is not guaranteed. For all real +parameters, this is perfectly ok, but the include directive is rather a meta +parameter, for which, in the smb.conf text file, the place where it is specified +between the other parameters is very important. This can not be achieved by the +simple registry smbconf data model, so there is one ordered list of includes +per share, and this list is evaluated after all the parameters of the share. +

+Further note that currently, only files can be included from registry +configuration. In the future, there will be the ability to include configuration +data from other registry keys. +

CONF SETINCLUDES section [filename]+

+Set the list of includes for the provided section (global or share) to the given +list of one or more filenames. The filenames may contain the usual smb.conf +macros like %I. +

CONF DELINCLUDES section

+Delete the list of includes from the provided section (global or share). +

HELP [COMMAND]

Gives usage information for the specified command.

VERSION

This man page is complete for version 3 of the Samba + suite.

AUTHOR

The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.

The net manpage was written by Jelmer Vernooij.

-- cgit v1.2.3