Move Samba utilities into Appendix authored by Tim Beale's avatar Tim Beale
The idea is not to bombard the reader with too much info in the first
chapter.
......@@ -147,40 +147,6 @@ so the *machine account* (the object in the domain that represents the
domain member) can be used to make or accept Kerberised network
requests.
### [ntlm_auth](https://www.samba.org/samba/docs/current/man-html/ntlm_auth.1.html)
The `ntlm_auth` tool allows for external projects like FreeRadius (for
802.1x authentication), Squid and Apache (for NTLM over HTTP) to
authenticate users against the joined domain.
* [source3/utils/ntlm_auth.c](https://git.samba.org/?p=samba.git;a=blob;f=source3/utils/ntlm_auth.c)
### [pam_winbindd](https://www.samba.org/samba/docs/current/man-html/pam_winbind.8.html)
`pam_winbind` allows local logins to be authenticated against the
joined domain using UNIX pluggable authentication modules (PAM).
* [nsswitch/pam_winbind.c](https://git.samba.org/?p=samba.git;a=blob;f=nsswitch/pam_winbind.c)
### nss_winbind
`nss_winbind` is a key part of running Samba as a domain member as it
provides local user and group entries to the Name Service Switch (NSS)
subsystem. It can also be used on systems that provide local desktop
logins.
* [nsswitch](https://git.samba.org/?p=samba.git;a=tree;f=nsswitch)
### libwbclient
Modern FreeRadius versions actually link directly to the winbind
client library `libwbclient` and so avoid the `fork()`/`exec()` cost of
calling `ntlm_auth`.
* [FreeRadius](http://freeradius.org/)
* [nsswitch](https://git.samba.org/?p=samba.git;a=tree;f=nsswitch)
## [Netbios Name server](https://www.samba.org/samba/docs/current/man-html/nmbd.8.html)
Samba can announce its name and accept name resolution requests via
......@@ -199,35 +165,12 @@ replication support.
## Client
### [smbclient](https://www.samba.org/samba/docs/current/man-html/smbclient.1.html)
The command line `smbclient` tool is described as *ftp like* in
reference to the early command-like ftp client. It allows `get`,
`put`, `mkdir` and many similar commands againt an SMB server.
* [source3/client](https://git.samba.org/?p=samba.git;a=tree;f=source3/client)
### [net](https://www.samba.org/samba/docs/current/man-html/net.8.html)
The command line `net` tool provides are more extensive set of
administrative functionality for Samba. The most notable function is
`net ads join` used to join new members servers to an AD domain.
Samba provides a wide range of client utilities.
These are documented in more detail in Appendix I.
The focus of this tool is on aspects of the file server .
* [source3/utils](https://git.samba.org/?p=samba.git;a=tree;f=source3/utils)
### [rpcclient](https://www.samba.org/samba/docs/current/man-html/rpcclient.1.html)
The command line `rpcclient` tool provides access to some low-level
RPC operations and can be useful during development. It is not
normally used for administration.
* [source3/rpcclient](https://git.samba.org/?p=samba.git;a=tree;f=source3/rpcclient)
### [samba-tool](https://www.samba.org/samba/docs/current/man-html/samba-tool.8.html)
The command line `samba-tool` tool provides an extensive set of
One of the most important Samba command-line tools is
[samba-tool](https://www.samba.org/samba/docs/current/man-html/samba-tool.8.html).
`samba-tool` provides an extensive set of
administrative functionality for Samba. The most notable functions
are `samba-tool domain provision` used to create a new AD Domain,
`samba-tool domain join` used to join a new DC to an AD Domain and
......@@ -235,13 +178,6 @@ are `samba-tool domain provision` used to create a new AD Domain,
* [python/samba/netcmd](https://git.samba.org/?p=samba.git;a=tree;f=python/samba/netcmd)
### [libsmbclient](https://www.samba.org/samba/docs/current/man-html/libsmbclient.7.html)
`libsmbclient` allows client applications like Gnome to browse and
view files on a remote SMB server.
* [source3/libsmb](https://git.samba.org/?p=samba.git;a=tree;f=source3/libsmb)
### Python API
The python API used by Samba to build tools like samba-tool is
......@@ -249,19 +185,3 @@ available for direct use as well.
* [python](https://git.samba.org/?p=samba.git;a=tree;f=python)
## Other
### [smbstatus](https://www.samba.org/samba/docs/current/man-html/smbstatus.1.html)
The command line `smbstatus` tool gives information on which files are
open and which locks are held by Samba clients.
* [source3/utils/status.c](https://git.samba.org/?p=samba.git;a=blob;f=source3/utils/status.c)
### [smbcontrol](https://www.samba.org/samba/docs/current/man-html/smbcontrol.1.html)
The command line `smbcontrol` tool gives (diagnostic) information on and allows
control of the Unix processes that Samba creates.
* [source3/utils/smbcontrol.c](https://git.samba.org/?p=samba.git;a=blob;f=source3/utils/smbcontrol.c)