plan9fox/sys/man/8/cifsd
2014-04-26 01:47:36 +02:00

110 lines
2.2 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)),
which 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 successful,
.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 whitespace in filenames to non breaking whitespace. This is useful
when exporting filesystems other than fossil.
.TP
.B casesensitive
By default, filename lookups are done case insensitive to match
windows filesystem semantics. This option disables case insensitive
lookups which 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)
.SH HISTORY
.I Cifsd
first appeared in 9front (May, 2011).