sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2025-01-14 19:24:43 +03:00
Code

Convert RoutedNetworks to SGML

Browse Source 
(This used to be commit c38bdb2aa0a96006094d1455b23183e97b2e7b2a)
This commit is contained in:
Jelmer Vernooij 2003-04-03 18:54:40 +00:00
parent fdb11bb655
commit 754d895cea
10 changed files with 345 additions and 178 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/docbook/projdoc/Other-Clients.sgml
View File

@ -339,4 +339,14 @@ create accounts on the Samba host for Domain users.</emphasis></para>
</sect1>
<sect1>
<title>Windows NT 3.1</title>
<para>If you have problems communicating across routers with Windows
NT 3.1 workstations, read <ulink url="http://support.microsoft.com/default.aspx?scid=kb;[LN];Q103765">this Microsoft Knowledge Base article</ulink>.
</para>
</sect1>
</chapter>

2
docs/docs-status
View File

@ -20,7 +20,6 @@ docs/docbook/projdoc/winbind.sgml - needs documentation for ADS
docs/textdocs/CUPS-PrintingInfo.txt - needs to be converted to sgml - Kurt Pfeifle
docs/textdocs/PROFILES.txt - needs to be converted to sgml
docs/textdocs/README.jis - Seems to need updating - possibly obsoleted by a newer japanese howto?
docs/textdocs/RoutedNetworks.txt - still valid, but shouldn't this go into Other_clients.sgml ? This text originally comes from microsoft, what about copyright?
docs/docbook/manpages/ntlm_auth.1.sgml - Is very basic at the moment, parameters need better descriptions - abartlet
Stuff that needs to be documented:
@ -43,7 +42,6 @@ profile acls // protocol
client lanman auth // security
client NTLMv2 auth // security
idmap backend // security
sam backend // security
kernel change notify // tuning
lpq cache time // tuning
-valid // misc

330
docs/manpages/rpcclient.1
View File

@ -172,56 +172,146 @@ options.
\fB-h|--help\fR
Print a summary of command line options.
.SH "COMMANDS"
.PP
\fBLSARPC\fR
.TP 0.2i
\(bu
.SS "LSARPC"
.TP
\fBlsaquery\fR
.TP 0.2i
\(bu
\fBlookupsids\fR - Resolve a list
Query info policy
.TP
\fBlookupsids\fR
Resolve a list
of SIDs to usernames.
.TP 0.2i
\(bu
\fBlookupnames\fR - Resolve a list
.TP
\fBlookupnames\fR
Resolve a list
of usernames to SIDs.
.TP 0.2i
\(bu
.TP
\fBenumtrusts\fR
Enumerate trusted domains
.TP
\fBenumprivs\fR
Enumerate privileges
.TP
\fBgetdispname\fR
Get the privilege name
.TP
\fBlsaenumsid\fR
Enumerate the LSA SIDS
.TP
\fBlsaenumprivsaccount\fR
Enumerate the privileges of an SID
.TP
\fBlsaenumacctrights\fR
Enumerate the rights of an SID
.TP
\fBlsaenumacctwithright\fR
Enumerate accounts with a right
.TP
\fBlsaaddacctrights\fR
Add rights to an account
.TP
\fBlsaremoveacctrights\fR
Remove rights from an account
.TP
\fBlsalookupprivvalue\fR
Get a privilege value given its name
.TP
\fBlsaquerysecobj\fR
Query LSA security object
.SS "LSARPC-DS"
.TP
\fBdsroledominfo\fR
Get Primary Domain Information
.PP
.PP
\fBSAMR\fR
.TP 0.2i
\(bu
\fBDFS\fR
.TP
\fBdfsexist\fR
Query DFS support
.TP
\fBdfsadd\fR
Add a DFS share
.TP
\fBdfsremove\fR
Remove a DFS share
.TP
\fBdfsgetinfo\fR
Query DFS share info
.TP
\fBdfsenum\fR
Enumerate dfs shares
.SS "REG"
.TP
\fBshutdown\fR
Remote Shutdown
.TP
\fBabortshutdown\fR
Abort Shutdown
.SS "SRVSVC"
.TP
\fBsrvinfo\fR
Server query info
.TP
\fBnetshareenum\fR
Enumerate shares
.TP
\fBnetfileenum\fR
Enumerate open files
.TP
\fBnetremotetod\fR
Fetch remote time of day
.SS "SAMR"
.TP
\fBqueryuser\fR
.TP 0.2i
\(bu
Query user info
.TP
\fBquerygroup\fR
.TP 0.2i
\(bu
Query group info
.TP
\fBqueryusergroups\fR
.TP 0.2i
\(bu
Query user groups
.TP
\fBquerygroupmem\fR
.TP 0.2i
\(bu
Query group membership
.TP
\fBqueryaliasmem\fR
.TP 0.2i
\(bu
Query alias membership
.TP
\fBquerydispinfo\fR
.TP 0.2i
\(bu
Query display info
.TP
\fBquerydominfo\fR
.TP 0.2i
\(bu
Query domain info
.TP
\fBenumdomusers\fR
Enumerate domain users
.TP
\fBenumdomgroups\fR
.PP
.PP
\fBSPOOLSS\fR
.TP 0.2i
\(bu
\fBadddriver <arch> <config>\fR
- Execute an AddPrinterDriver() RPC to install the printer driver
Enumerate domain groups
.TP
\fBenumalsgroups\fR
Enumerate alias groups
.TP
\fBcreatedomuser\fR
Create domain user
.TP
\fBsamlookupnames\fR
Look up names
.TP
\fBsamlookuprids\fR
Look up names
.TP
\fBdeletedomuser\fR
Delete domain user
.TP
\fBsamquerysecobj\fR
Query SAMR security object
.TP
\fBgetdompwinfo\fR
Retrieve domain password info
.SS "SPOOLSS"
.TP
\fBadddriver <arch> <config>\fR
Execute an AddPrinterDriver() RPC to install the printer driver
information on the server. Note that the driver files should
already exist in the directory returned by
\fBgetdriverdir\fR. Possible values for
@ -250,111 +340,149 @@ use of a bi-directional link for communication. This field should
be "NULL". On a remote NT print server, the Print Monitor for a
driver must already be installed prior to adding the driver or
else the RPC will fail.
.TP 0.2i
\(bu
\fBaddprinter <printername>
<sharename> <drivername> <port>\fR
- Add a printer on the remote server. This printer
.TP
\fBaddprinter <printername> <sharename> <drivername> <port>\fR
Add a printer on the remote server. This printer
will be automatically shared. Be aware that the printer driver
must already be installed on the server (see \fBadddriver\fR)
and the \fIport\fRmust be a valid port name (see
\fBenumports\fR.
.TP 0.2i
\(bu
\fBdeldriver\fR - Delete the
.TP
\fBdeldriver\fR
Delete the
specified printer driver for all architectures. This
does not delete the actual driver files from the server,
only the entry from the server's list of drivers.
.TP 0.2i
\(bu
\fBenumdata\fR - Enumerate all
.TP
\fBenumdata\fR
Enumerate all
printer setting data stored on the server. On Windows NT clients,
these values are stored in the registry, while Samba servers
store them in the printers TDB. This command corresponds
to the MS Platform SDK GetPrinterData() function (* This
command is currently unimplemented).
.TP 0.2i
\(bu
\fBenumjobs <printer>\fR
- List the jobs and status of a given printer.
.TP
\fBenumdataex\fR
Enumerate printer data for a key
.TP
\fBenumjobs <printer>\fR
List the jobs and status of a given printer.
This command corresponds to the MS Platform SDK EnumJobs()
function (* This command is currently unimplemented).
.TP 0.2i
\(bu
\fBenumports [level]\fR
- Executes an EnumPorts() call using the specified
function
.TP
\fBenumkey\fR
Enumerate printer keys
.TP
\fBenumports [level]\fR
Executes an EnumPorts() call using the specified
info level. Currently only info levels 1 and 2 are supported.
.TP 0.2i
\(bu
\fBenumdrivers [level]\fR
- Execute an EnumPrinterDrivers() call. This lists the various installed
.TP
\fBenumdrivers [level]\fR
Execute an EnumPrinterDrivers() call. This lists the various installed
printer drivers for all architectures. Refer to the MS Platform SDK
documentation for more details of the various flags and calling
options. Currently supported info levels are 1, 2, and 3.
.TP 0.2i
\(bu
\fBenumprinters [level]\fR
- Execute an EnumPrinters() call. This lists the various installed
.TP
\fBenumprinters [level]\fR
Execute an EnumPrinters() call. This lists the various installed
and share printers. Refer to the MS Platform SDK documentation for
more details of the various flags and calling options. Currently
supported info levels are 0, 1, and 2.
.TP 0.2i
\(bu
\fBgetdata <printername>\fR
- Retrieve the data for a given printer setting. See
.TP
\fBgetdata <printername> <valuename;>\fR
Retrieve the data for a given printer setting. See
the \fBenumdata\fR command for more information.
This command corresponds to the GetPrinterData() MS Platform
SDK function (* This command is currently unimplemented).
.TP 0.2i
\(bu
\fBgetdriver <printername>\fR
- Retrieve the printer driver information (such as driver file,
SDK function.
.TP
\fBgetdataex\fR
Get printer driver data with keyname
.TP
\fBgetdriver <printername>\fR
Retrieve the printer driver information (such as driver file,
config file, dependent files, etc...) for
the given printer. This command corresponds to the GetPrinterDriver()
MS Platform SDK function. Currently info level 1, 2, and 3 are supported.
.TP 0.2i
\(bu
\fBgetdriverdir <arch>\fR
- Execute a GetPrinterDriverDirectory()
.TP
\fBgetdriverdir <arch>\fR
Execute a GetPrinterDriverDirectory()
RPC to retrieve the SMB share name and subdirectory for
storing printer driver files for a given architecture. Possible
values for \fIarch\fR are "Windows 4.0"
(for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows
Alpha_AXP", and "Windows NT R4000".
.TP 0.2i
\(bu
\fBgetprinter <printername>\fR
- Retrieve the current printer information. This command
.TP
\fBgetprinter <printername>\fR
Retrieve the current printer information. This command
corresponds to the GetPrinter() MS Platform SDK function.
.TP 0.2i
\(bu
\fBopenprinter <printername>\fR
- Execute an OpenPrinterEx() and ClosePrinter() RPC
.TP
\fBgetprintprocdir\fR
Get print processor directory
.TP
\fBopenprinter <printername>\fR
Execute an OpenPrinterEx() and ClosePrinter() RPC
against a given printer.
.TP 0.2i
\(bu
\fBsetdriver <printername>
<drivername>\fR
- Execute a SetPrinter() command to update the printer driver
.TP
\fBsetdriver <printername> <drivername>\fR
Execute a SetPrinter() command to update the printer driver
associated with an installed printer. The printer driver must
already be correctly installed on the print server.
See also the \fBenumprinters\fR and
\fBenumdrivers\fR commands for obtaining a list of
of installed printers and drivers.
.PP
\fBGENERAL OPTIONS\fR
.TP 0.2i
\(bu
\fBdebuglevel\fR - Set the current
.TP
\fBaddform\fR
Add form
.TP
\fBsetform\fR
Set form
.TP
\fBgetform\fR
Get form
.TP
\fBdeleteform\fR
Delete form
.TP
\fBenumforms\fR
Enumerate form
.TP
\fBsetprinter\fR
Set printer comment
.TP
\fBsetprinterdata\fR
Set REG_SZ printer data
.TP
\fBrffpcnex\fR
Rffpcnex test
.SS "NETLOGON"
.TP
\fBlogonctrl2\fR
Logon Control 2
.TP
\fBlogonctrl\fR
Logon Control
.TP
\fBsamsync\fR
Sam Synchronisation
.TP
\fBsamdeltas\fR
Query Sam Deltas
.TP
\fBsamlogon\fR
Sam Logon
.SS "GENERAL COMMANDS"
.TP
\fBdebuglevel\fR
Set the current
debug level used to log information.
.TP 0.2i
\(bu
\fBhelp (?)\fR - Print a listing of all
.TP
\fBhelp (?)\fR
Print a listing of all
known commands or extended help on a particular command.
.TP 0.2i
\(bu
\fBquit (exit)\fR - Exit \fBrpcclient
.TP
\fBquit (exit)\fR
Exit \fBrpcclient
\fR.
.SH "BUGS"
.PP

5
docs/manpages/smbmnt.8
View File

@ -9,7 +9,7 @@
smbmnt \- helper utility for mounting SMB filesystems
.SH SYNOPSIS
\fBsmbmnt\fR \fBmount-point\fR [ \fB-s <share>\fR ] [ \fB-r\fR ] [ \fB-u <uid>\fR ] [ \fB-g <gid>\fR ] [ \fB-f <mask>\fR ] [ \fB-d <mask>\fR ] [ \fB-o <options>\fR ]
\fBsmbmnt\fR \fBmount-point\fR [ \fB-s <share>\fR ] [ \fB-r\fR ] [ \fB-u <uid>\fR ] [ \fB-g <gid>\fR ] [ \fB-f <mask>\fR ] [ \fB-d <mask>\fR ] [ \fB-o <options>\fR ] [ \fB-h\fR ]
.SH "DESCRIPTION"
.PP
@ -49,6 +49,9 @@ applied
\fB-o options\fR
list of options that are passed as-is to smbfs, if this
command is run on a 2.4 or higher Linux kernel.
.TP
\fB-h|--help\fR
Print a summary of command line options.
.SH "AUTHOR"
.PP
Volker Lendecke, Andrew Tridgell, Michael H. Warfield

17
docs/manpages/smbmount.8
View File

@ -70,6 +70,9 @@ This is preferred over having passwords in plaintext in a
shared file, such as \fI/etc/fstab\fR. Be sure to protect any
credentials file properly.
.TP
\fBkrb\fR
Use kerberos (Active Directory).
.TP
\fBnetbiosname=<arg>\fR
sets the source NetBIOS name. It defaults
to the local hostname.
@ -95,30 +98,30 @@ permissions that remote files have in the local filesystem.
The default is based on the current umask.
.TP
\fBdmask=<arg>\fR
sets the directory mask. This determines the
Sets the directory mask. This determines the
permissions that remote directories have in the local filesystem.
The default is based on the current umask.
.TP
\fBdebug=<arg>\fR
sets the debug level. This is useful for
Sets the debug level. This is useful for
tracking down SMB connection problems. A suggested value to
start with is 4. If set too high there will be a lot of
output, possibly hiding the useful output.
.TP
\fBip=<arg>\fR
sets the destination host or IP address.
Sets the destination host or IP address.
.TP
\fBworkgroup=<arg>\fR
sets the workgroup on the destination
Sets the workgroup on the destination
.TP
\fBsockopt=<arg>\fR
sets the TCP socket options. See the \fBsmb.conf\fR(5) \fIsocket options\fR option.
Sets the TCP socket options. See the \fBsmb.conf\fR(5) \fIsocket options\fR option.
.TP
\fBscope=<arg>\fR
sets the NetBIOS scope
Sets the NetBIOS scope
.TP
\fBguest\fR
don't prompt for a password
Don't prompt for a password
.TP
\fBro\fR
mount read-only

84
docs/manpages/smbsh.1
View File

@ -39,6 +39,90 @@ the user to set the directory prefix for SMB access. The
default value if this option is not specified is
\fBsmb\fR.
.TP
\fB-s <configuration file>\fR
The file specified contains the
configuration details required by the server. The
information in this file includes server-specific
information such as what printcap file to use, as well
as descriptions of all the services that the server is
to provide. See \fIsmb.conf(5)\fR for more information.
The default configuration file name is determined at
compile time.
.TP
\fB-d|--debug=debuglevel\fR
\fIdebuglevel\fR is an integer
from 0 to 10. The default value if this parameter is
not specified is zero.
The higher this value, the more detail will be
logged to the log files about the activities of the
server. At level 0, only critical errors and serious
warnings will be logged. Level 1 is a reasonable level for
day to day running - it generates a small amount of
information about operations carried out.
Levels above 1 will generate considerable
amounts of log data, and should only be used when
investigating a problem. Levels above 3 are designed for
use only by developers and generate HUGE amounts of log
data, most of which is extremely cryptic.
Note that specifying this parameter here will
override the log
level file.
.TP
\fB-R <name resolve order>\fR
This option is used to determine what naming
services and in what order to resolve
host names to IP addresses. The option takes a space-separated
string of different name resolution options.
The options are: "lmhosts", "host", "wins" and "bcast".
They cause names to be resolved as follows :
.RS
.TP 0.2i
\(bu
lmhosts:
Lookup an IP address in the Samba lmhosts file. If the
line in lmhosts has no name type attached to the
NetBIOS name
(see the \fBlmhosts\fR(5) for details)
then any name type matches for lookup.
.TP 0.2i
\(bu
host:
Do a standard host name to IP address resolution, using
the system \fI/etc/hosts\fR, NIS, or DNS
lookups. This method of name resolution is operating
system dependent, for instance on IRIX or Solaris this
may be controlled by the \fI/etc/nsswitch.conf\fR file). Note that this method is only used
if the NetBIOS name type being queried is the 0x20
(server) name type, otherwise it is ignored.
.TP 0.2i
\(bu
wins:
Query a name with the IP address listed in the
\fIwins server\fR parameter. If no
WINS server has been specified this method will be
ignored.
.TP 0.2i
\(bu
bcast:
Do a broadcast on each of the known local interfaces
listed in the \fIinterfaces\fR
parameter. This is the least reliable of the name
resolution methods as it depends on the target host
being on a locally connected subnet.
.RE
If this parameter is not set then the name resolve order
defined in the \fBsmb.conf\fR(5) file parameter
(\fIname resolve order\fR) will be used.
The default order is lmhosts, host, wins, bcast. Without
this parameter or any entry in the \fIname resolve order\fR parameter of the \fBsmb.conf\fR(5) file, the name resolution methods
will be attempted in this order.
.TP
\fB-L libdir\fR
This parameter specifies the location of the
shared libraries used by \fBsmbsh\fR. The default

4
docs/manpages/smbspool.8
View File

@ -9,7 +9,7 @@
smbspool \- send a print file to an SMB printer
.SH SYNOPSIS
\fBsmbspool\fR [ \fBjob\fR ] [ \fBuser\fR ] [ \fBtitle\fR ] [ \fBcopies\fR ] [ \fBoptions\fR ] [ \fBfilename\fR ]
\fBsmbspool\fR \fBjob\fR \fBuser\fR \fBtitle\fR \fBcopies\fR \fBoptions\fR [ \fBfilename\fR ]
.SH "DESCRIPTION"
.PP
@ -78,7 +78,7 @@ name of the file to print. If this argument is not specified
then the print file is read from the standard input.
.SH "VERSION"
.PP
This man page is correct for version 2.2 of the Samba suite.
This man page is correct for version 3.0 of the Samba suite.
.SH "SEE ALSO"
.PP
\fBsmbd\fR(8) and \fBSamba\fR(7).

6
docs/manpages/smbtar.1
View File

@ -9,7 +9,7 @@
smbtar \- shell script for backing up SMB/CIFS shares directly to UNIX tape drives
.SH SYNOPSIS
\fBsmbtar\fR \fB-s server\fR [ \fB-p password\fR ] [ \fB-x services\fR ] [ \fB-X\fR ] [ \fB-d directory\fR ] [ \fB-u user\fR ] [ \fB-t tape\fR ] [ \fB-t tape\fR ] [ \fB-b blocksize\fR ] [ \fB-N filename\fR ] [ \fB-i\fR ] [ \fB-r\fR ] [ \fB-l loglevel\fR ] [ \fB-v\fR ] \fBfilenames\fR
\fBsmbtar\fR [ \fB-r\fR ] [ \fB-i\fR ] [ \fB-a\fR ] [ \fB-v\fR ] \fB-s server\fR [ \fB-p password\fR ] [ \fB-x services\fR ] [ \fB-X\fR ] [ \fB-N filename\fR ] [ \fB-b blocksize\fR ] [ \fB-d directory\fR ] [ \fB-l loglevel\fR ] [ \fB-u user\fR ] [ \fB-t tape\fR ] \fBfilenames\fR
.SH "DESCRIPTION"
.PP
@ -46,6 +46,10 @@ Default: none
The user id to connect as. Default:
UNIX login name.
.TP
\fB-a\fR
Reset DOS archive bit mode to
indicate file has been archived.
.TP
\fB-t tape\fR
Tape device. May be regular file or tape
device. Default: \fI$TAPE\fR environmental

2
docs/manpages/testprns.1
View File

@ -69,7 +69,7 @@ for errors and warnings.
Other messages are self-explanatory.
.SH "VERSION"
.PP
This man page is correct for version 2.2 of
This man page is correct for version 3.0 of
the Samba suite.
.SH "SEE ALSO"
.PP

63
docs/textdocs/RoutedNetworks.txt
View File

@ -1,63 +0,0 @@
#NOFNR Flag in LMHosts to Communicate Across Routers
Last reviewed: May 5, 1997
Article ID: Q103765
The information in this article applies to:
Microsoft Windows NT operating system version 3.1
Microsoft Windows NT Advanced Server version 3.1
SUMMARY
Some of the LAN Manager for UNIX and Pathworks servers may have
problems in communicating across routers with
Windows NT workstations. The use of #NOFNR flag in the LMHosts
file solves the problem.
MORE INFORMATION
When you are communicating with a server across a router in a IP
routed environment, the LMHosts file is used to
resolve Workstation name-to-IP address mapping. The LMHosts
entry for a remote machine name provides the IP
address for the remote machine. In Lan Manager 2.x, providing
the LMHosts entry eliminates the need to do a Name
Query broadcast to the local domain and instead a TCP session is
established with the remote machine. Windows NT
performs the same function in a different way.
When an LMHosts entry exists for a remote server, Windows NT
will not send a Name Query broadcast to the local
subnet and instead send a directed Name Query to the remote
server. If the remote server does not respond to the Name
Query, further communications (TCP SYN, and so on) will not take
place. This was done to eliminate the performance
issues when trying to connect to a remote machine when it was
not available (down).
Some of the older LAN Manager for UNIX and DEC Pathworks servers
do not respond to directed Name Queries sent
by Windows NT. In that case, the users will see an error 53
(Path not found), even though they have specified the
LMHosts entries correctly. A new LMHosts flag #NOFNR was added
to solve this problem. By specifying the
#NOFNR flag on the same line where the name resolution
information for the server is provided, the directed Name
Query can be avoided. For example:
130.20.1.1 mylmxserver #PRE #NOFNR
Note that this will only apply to mylmxserver and not to any
other entries in the LMHosts file. To set
a global flag, an entry could be added in the registry. To
completely remove any directed Name
Queries sent from a Windows NT machine, create the following
value in
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Nbt\Parameters:
NoDirectedFNR REG_DWORD 1
This will cause the directed Name Queries to not go out for any