plan9fox/sys/man/8/cifsd

107 lines
2.1 KiB
Plaintext

.TH CIFSD 8
.SH NAME
cifsd \- CIFS/SMB network daemon
.SH SYNOPSIS
.PP
.B ip/cifsd
[
.B -t
] [
.B -d
] [
.B -f
.I debuglog
] [
.B -w
.I name
] [
.B -o
.I option
] ... [
.I conndir
]
.SH DESCRIPTION
.I Cifsd
exports filesystems to
.SM CIFS or
.SM SMB
clients like Microsoft \(tm Windows.
.PP
It is normally started by the network listen process via the
.B /rc/bin/service/tcp445
service script (see
.IR listen (8)),
wich passes
.I conndir
and filedescriptors 0 and 1 to the incoming connection.
.PP
Users are authenticated by ther Inferno/pop secret held by the auth server.
When successfull,
.I cifsd
changes its user id and namespace to the authenticated user.
Informative log messages are appended to
.B /sys/log/cifsd
if it exists.
.PP
By default the share
.B local
is offered, which represents the root of the namespace
described by
.B /lib/namespace.
If a different name is explicitly requested by the client then
.B /bin/9fs
(see
.IR srv (4))
is invoked to attach that filesystem, which is then exported instead.
.PP
The flags are:
.TP
.B t
Run the server in trusted mode, so it will not require
authentication from the client and keep running in the callers
namespace.
.TP
.B d
Enable or increases debug verbosity for the
.I debuglog
file. Debug messages are never written to the system logfile.
.TP
.B f
Specify the filename for the
.I debuglog
file. If not specified no debug messages are generated.
.TP
.B w
Set the workgroup (or primary domain) to
.I name. The default is
.SM WORKGROUP
.TP
.B o
Enables the following
.I option
string.
This flag can appear multiple times when more than one option has to
be enabled. Valid options are:
.RS
.TP
.B trspaces
transforms whitespaces in filenames to non breaking whitespaces. This is usefull
when exporting filesystems other than fossil.
.TP
.B casesensitive
By default, filename lookups are done case insensitive to match
windows filesystem sematics. This option disables case insensitive
lookups wich can result in a performance improvement, but might break
some applications.
.SH FILES
.B /rc/bin/service/tcp445
.br
.B /sys/log/cifsd
.br
.B /lib/namespace
.SH SOURCE
.B /sys/src/cmd/ip/cifsd
.SH "SEE ALSO"
.IR listen (8),
.IR srv (4)