From 7476d9c6d0624a08542e11976641d086cb2eff90 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Fri, 3 Jan 2003 17:35:18 +0000 Subject: regenerate man pages (This used to be commit 4461cd3adb4051383d052fb38c357d85ee473a74) --- docs/docbook/manpages/smbd.8.sgml | 2 +- docs/htmldocs/nmbd.8.html | 124 ++++++++++++++++++++++--------------- docs/htmldocs/smbd.8.html | 76 +++++++++++++++++++---- docs/htmldocs/smbgroupedit.8.html | 94 +++++++++++++++++++++++----- docs/htmldocs/winbindd.8.html | 126 +++++++++++++++++++++++++++++++------- docs/manpages/nmbd.8 | 25 +++++++- docs/manpages/smbd.8 | 25 +++++++- docs/manpages/smbgroupedit.8 | 4 +- docs/manpages/winbindd.8 | 25 +++++++- 9 files changed, 393 insertions(+), 108 deletions(-) (limited to 'docs') diff --git a/docs/docbook/manpages/smbd.8.sgml b/docs/docbook/manpages/smbd.8.sgml index 6dfb0f5746..a679af6718 100644 --- a/docs/docbook/manpages/smbd.8.sgml +++ b/docs/docbook/manpages/smbd.8.sgml @@ -118,7 +118,7 @@ parameter negates the implicit deamon mode when run from the command line. smbd also logs to standard output, as if the -S parameter had been - given. + given. diff --git a/docs/htmldocs/nmbd.8.html b/docs/htmldocs/nmbd.8.html index c9cdb5908b..1183a14522 100644 --- a/docs/htmldocs/nmbd.8.html +++ b/docs/htmldocs/nmbd.8.html @@ -1,11 +1,12 @@ - + nmbd

nmbd

nmbd

Synopsis

nmbd [-D] [-a] [-i] [-o] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log directory>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]

[-D] [-F] [-S] [-a] [-i] [-o] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log directory>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]

DESCRIPTION

-n option (see OPTIONS below). Thus

OPTIONS

-F

If specified, this parameter causes + the main nmbd process to not daemonize, + i.e. double-fork and disassociate with the terminal. + Child processes are still created as normal to service + each connection request, but the main process does not + exit. This operation mode is suitable for running + nmbd under process supervisors such + as supervise and svscan + from Daniel J. Bernstein's daemontools + package, or the AIX process monitor. +

-S

If specified, this parameter causes + nmbd to log to standard output rather + than a file.

-a

nmbd also logs to standard + output, as if the -S parameter had been + given.

-o
.

-H <filename>
-H <filename>

NetBIOS lmhosts file. The lmhosts @@ -209,24 +252,18 @@ CLASS="FILENAME" > to resolve any NetBIOS name queries needed by the server. Note - that the contents of this file are NOT used by nmbd to answer any name queries. Adding a line to this file affects name NetBIOS resolution - from this host ONLY.

The default path to this file is compiled into @@ -264,7 +301,7 @@ CLASS="COMMAND" >.

-d <debug level>
-d <debug level>

debuglevel is an integer @@ -300,7 +337,7 @@ CLASS="FILENAME" > file.

-l <log directory>
-l <log directory>

The -l parameter specifies a directory @@ -320,12 +357,9 @@ CLASS="FILENAME" /var/log/log.nmb. . Beware: If the directory specified does not exist,

-n <primary NetBIOS name>
-n <primary NetBIOS name>

This option allows you to override @@ -360,7 +394,7 @@ CLASS="FILENAME" >.

-p <UDP port number>
-p <UDP port number>

UDP port number is a positive integer value. @@ -373,7 +407,7 @@ CLASS="COMMAND" won't need help!

-s <configuration file>
-s <configuration file>

The default configuration file name @@ -400,7 +434,7 @@ CLASS="FILENAME" >

FILES

If nmbd is acting as a is acting as a browse master (see the

SIGNALS

nmbd
process it is recommended - that SIGKILL (-9) NOT be used, except as a last resort, as this may leave the name database in an inconsistent state. The correct way to terminate

VERSION

SEE ALSO

AUTHOR

smbd [-D] [-i] [-h] [-V] [-b] [-d <debug level>] [-l <log directory>] [-p <port number>] [-O <socket option>] [-s <configuration file>]

[-D] [-F] [-S] [-i] [-h] [-V] [-b] [-d <debug level>] [-l <log directory>] [-p <port number>] [-O <socket option>] [-s <configuration file>]

DESCRIPTION

OPTIONS

-F

If specified, this parameter causes + the main smbd process to not daemonize, + i.e. double-fork and disassociate with the terminal. + Child processes are still created as normal to service + each connection request, but the main process does not + exit. This operation mode is suitable for running + smbd under process supervisors such + as supervise and svscan + from Daniel J. Bernstein's daemontools + package, or the AIX process monitor. +

-S

If specified, this parameter causes + smbd to log to standard output rather + than a file.

-i

smbd also logs to standard + output, as if the -S parameter had been + given.

FILES

LIMITATIONS

ENVIRONMENT VARIABLES

PAM INTERACTION

VERSION

DIAGNOSTICS

SIGNALS

SEE ALSO

AUTHOR

+ smbgroupedit

smbgroupedit

smbgroupedit

Synopsis

smbroupedit [-v [l|s]] [-a UNIX-groupname [-d NT-groupname|-p privilege|]]

[-v [l|s]] [-a UNIX-groupname [-d NT-groupname|-p privilege|]]

give a long listing, of the format:

"NT Group Name"
@@ -97,10 +100,19 @@ CLASS="PROGRAMLISTING"
     Group type     :
     Comment        :
     Privilege      :

For examples,

Users
@@ -109,6 +121,9 @@ CLASS="PROGRAMLISTING"
     Group type: Local group
     Comment   :
     Privilege : No privilege

display a short listing of the format:

NTGroupName(SID) -> UnixGroupName

For example,

Users (S-1-5-32-545) -> -1

Get the SID for the Windows NT "Domain Admins" group:

smbgroupedit -vs | grep "Domain Admins"
 Domain Admins (S-1-5-21-1108995562-3116817432-1375597819-512) -> -1

  • smbgroupedit \
     -c S-1-5-21-1108995562-3116817432-1375597819-512 \
    --u domadm

    warning: don't copy and paste this sample, the Domain Admins SID (the S-1-5-21-...-512) is different for every PDC.

    To verify that your mapping has taken effect:

    smbgroupedit -vs|grep "Domain Admins"
     Domain Admins (S-1-5-21-1108995562-3116817432-1375597819-512) -> domadm

    To give access to a certain directory on a domain member machine (an NT/W2K or a samba server running winbind) to some users who are member of a group on your samba PDC, flag that group as a domain group:

    smbgroupedit -a unixgroup -td

  • + winbindd

    winbindd

    winbindd

    Synopsis

    winbindd [-i] [-B] [-d <debug level>] [-s <smb config file>] [-n]

    [-F] [-S] [-i] [-B] [-d <debug level>] [-s <smb config file>] [-n]

    DESCRIPTION

    and then from the Windows NT server.

    passwd:         files winbind
     group:          files winbind
     	

    The following simple configuration in the @@ -192,7 +198,7 @@ CLASS="FILENAME" >

    OPTIONS

    -F

    If specified, this parameter causes + the main winbindd process to not daemonize, + i.e. double-fork and disassociate with the terminal. + Child processes are still created as normal to service + each connection request, but the main process does not + exit. This operation mode is suitable for running + winbindd under process supervisors such + as supervise and svscan + from Daniel J. Bernstein's daemontools + package, or the AIX process monitor. +

    -S

    If specified, this parameter causes + winbindd to log to standard output rather + than a file.

    -d debuglevel

    winbindd is required.

    is required. + winbindd also logs to standard output, + as if the -S parameter had been given. +

    -n

    NAME AND ID RESOLUTION

    CONFIGURATION

    EXAMPLE SETUP

    put the following:

    passwd:     files winbind
     group:      files winbind
     	

    In lines with something like this:

    auth       required	/lib/security/pam_securetty.so
    @@ -475,6 +547,9 @@ auth       required	/lib/security/pam_nologin.so
     auth       sufficient	/lib/security/pam_winbind.so
     auth       required     /lib/security/pam_pwdb.so use_first_pass shadow nullok
     	

    Note in particular the use of the containing directives like the following:

    [global]
    @@ -568,6 +649,9 @@ CLASS="PROGRAMLISTING"
             security = domain
             password server = *
     	

    Now start winbindd and you should find that your user and @@ -586,7 +670,7 @@ CLASS="COMMAND" >

    NOTES

    SIGNALS

    FILES

    VERSION

    SEE ALSO

    AUTHOR

    .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "NMBD" "8" "05 November 2002" "" "" +.TH "NMBD" "8" "03 January 2003" "" "" .SH NAME nmbd \- NetBIOS name server to provide NetBIOS over IP naming services to clients .SH SYNOPSIS -\fBnmbd\fR [ \fB-D\fR ] [ \fB-a\fR ] [ \fB-i\fR ] [ \fB-o\fR ] [ \fB-h\fR ] [ \fB-V\fR ] [ \fB-d \fR ] [ \fB-H \fR ] [ \fB-l \fR ] [ \fB-n \fR ] [ \fB-p \fR ] [ \fB-s \fR ] +\fBnmbd\fR [ \fB-D\fR ] [ \fB-F\fR ] [ \fB-S\fR ] [ \fB-a\fR ] [ \fB-i\fR ] [ \fB-o\fR ] [ \fB-h\fR ] [ \fB-V\fR ] [ \fB-d \fR ] [ \fB-H \fR ] [ \fB-l \fR ] [ \fB-n \fR ] [ \fB-p \fR ] [ \fB-s \fR ] .SH "DESCRIPTION" .PP @@ -57,6 +57,23 @@ will operate as a daemon if launched from a command shell. nmbd can also be operated from the \fBinetd\fR meta-daemon, although this is not recommended. .TP +\fB-F\fR +If specified, this parameter causes +the main \fBnmbd\fR process to not daemonize, +i.e. double-fork and disassociate with the terminal. +Child processes are still created as normal to service +each connection request, but the main process does not +exit. This operation mode is suitable for running +\fBnmbd\fR under process supervisors such +as \fBsupervise\fR and \fBsvscan\fR +from Daniel J. Bernstein's \fBdaemontools\fR +package, or the AIX process monitor. +.TP +\fB-S\fR +If specified, this parameter causes +\fBnmbd\fR to log to standard output rather +than a file. +.TP \fB-a\fR If this parameter is specified, each new connection will append log messages to the log file. @@ -67,7 +84,9 @@ If this parameter is specified it causes the server to run "interactively", not as a daemon, even if the server is executed on the command line of a shell. Setting this parameter negates the implicit daemon mode when run from the -command line. +command line. \fBnmbd\fR also logs to standard +output, as if the \fB-S\fR parameter had been +given. .TP \fB-o\fR If this parameter is specified, the diff --git a/docs/manpages/smbd.8 b/docs/manpages/smbd.8 index 3e350f80e9..811bb60575 100644 --- a/docs/manpages/smbd.8 +++ b/docs/manpages/smbd.8 @@ -3,12 +3,12 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBD" "8" "26 November 2002" "" "" +.TH "SMBD" "8" "03 January 2003" "" "" .SH NAME smbd \- server to provide SMB/CIFS services to clients .SH SYNOPSIS -\fBsmbd\fR [ \fB-D\fR ] [ \fB-i\fR ] [ \fB-h\fR ] [ \fB-V\fR ] [ \fB-b\fR ] [ \fB-d \fR ] [ \fB-l \fR ] [ \fB-p \fR ] [ \fB-O \fR ] [ \fB-s \fR ] +\fBsmbd\fR [ \fB-D\fR ] [ \fB-F\fR ] [ \fB-S\fR ] [ \fB-i\fR ] [ \fB-h\fR ] [ \fB-V\fR ] [ \fB-b\fR ] [ \fB-d \fR ] [ \fB-l \fR ] [ \fB-p \fR ] [ \fB-O \fR ] [ \fB-s \fR ] .SH "DESCRIPTION" .PP @@ -60,12 +60,31 @@ servers that provide more than casual use file and print services. This switch is assumed if \fBsmbd \fR is executed on the command line of a shell. .TP +\fB-F\fR +If specified, this parameter causes +the main \fBsmbd\fR process to not daemonize, +i.e. double-fork and disassociate with the terminal. +Child processes are still created as normal to service +each connection request, but the main process does not +exit. This operation mode is suitable for running +\fBsmbd\fR under process supervisors such +as \fBsupervise\fR and \fBsvscan\fR +from Daniel J. Bernstein's \fBdaemontools\fR +package, or the AIX process monitor. +.TP +\fB-S\fR +If specified, this parameter causes +\fBsmbd\fR to log to standard output rather +than a file. +.TP \fB-i\fR If this parameter is specified it causes the server to run "interactively", not as a daemon, even if the server is executed on the command line of a shell. Setting this parameter negates the implicit deamon mode when run from the -command line. +command line. \fBsmbd\fR also logs to standard +output, as if the \fB-S\fR parameter had been +given. .TP \fB-h\fR Prints the help information (usage) diff --git a/docs/manpages/smbgroupedit.8 b/docs/manpages/smbgroupedit.8 index 0aebf3276e..b514b99793 100644 --- a/docs/manpages/smbgroupedit.8 +++ b/docs/manpages/smbgroupedit.8 @@ -3,7 +3,7 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "SMBGROUPEDIT" "8" "05 November 2002" "" "" +.TH "SMBGROUPEDIT" "8" "03 January 2003" "" "" .SH NAME smbgroupedit \- Query/set/change UNIX - Windows NT group mapping .SH SYNOPSIS @@ -111,7 +111,7 @@ map the unix domadm group to the Windows NT .nf root# \fBsmbgroupedit \\ -c S-1-5-21-1108995562-3116817432-1375597819-512 \\ --u domadm\fR +-u domadm -td\fR .fi \fBwarning:\fR don't copy and paste this sample, the diff --git a/docs/manpages/winbindd.8 b/docs/manpages/winbindd.8 index 6ac186cbab..8cfb403723 100644 --- a/docs/manpages/winbindd.8 +++ b/docs/manpages/winbindd.8 @@ -3,12 +3,12 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "WINBINDD" "8" "05 November 2002" "" "" +.TH "WINBINDD" "8" "03 January 2003" "" "" .SH NAME winbindd \- Name Service Switch daemon for resolving names from NT servers .SH SYNOPSIS -\fBwinbindd\fR [ \fB-i\fR ] [ \fB-B\fR ] [ \fB-d \fR ] [ \fB-s \fR ] [ \fB-n\fR ] +\fBwinbindd\fR [ \fB-F\fR ] [ \fB-S\fR ] [ \fB-i\fR ] [ \fB-B\fR ] [ \fB-d \fR ] [ \fB-s \fR ] [ \fB-n\fR ] .SH "DESCRIPTION" .PP @@ -74,6 +74,23 @@ resolve hostnames from \fI/etc/hosts\fR and then from the WINS server. .SH "OPTIONS" .TP +\fB-F\fR +If specified, this parameter causes +the main \fBwinbindd\fR process to not daemonize, +i.e. double-fork and disassociate with the terminal. +Child processes are still created as normal to service +each connection request, but the main process does not +exit. This operation mode is suitable for running +\fBwinbindd\fR under process supervisors such +as \fBsupervise\fR and \fBsvscan\fR +from Daniel J. Bernstein's \fBdaemontools\fR +package, or the AIX process monitor. +.TP +\fB-S\fR +If specified, this parameter causes +\fBwinbindd\fR to log to standard output rather +than a file. +.TP \fB-d debuglevel\fR Sets the debuglevel to an integer between 0 and 100. 0 is for no debugging and 100 is for reams and @@ -84,7 +101,9 @@ level 100 (see BUGS.txt). Tells \fBwinbindd\fR to not become a daemon and detach from the current terminal. This option is used by developers when interactive debugging -of \fBwinbindd\fR is required. +of \fBwinbindd\fR is required. +\fBwinbindd\fR also logs to standard output, +as if the \fB-S\fR parameter had been given. .TP \fB-n\fR Disable caching. This means winbindd will -- cgit