]> git.lizzy.rs Git - plan9front.git/blob - sys/man/8/cifsd
3e6076571e02f75686a3121e4505b945810529d5
[plan9front.git] / sys / man / 8 / cifsd
1 .TH CIFSD 8
2 .SH NAME
3 cifsd \- CIFS/SMB network daemon
4 .SH SYNOPSIS
5 .PP
6 .B ip/cifsd
7 [
8 .B -t
9 ] [
10 .B -d
11 ] [
12 .B -f
13 .I debuglog
14 ] [
15 .B -w
16 .I name
17 ] [
18 .B -o
19 .I option
20 ] ... [
21 .I conndir
22 ]
23 .SH DESCRIPTION
24 .I Cifsd
25 exports filesystems to
26 .SM CIFS or
27 .SM SMB
28 clients like Microsoft \(tm Windows.
29 .PP
30 It is normally started by the network listen process via the
31 .B /rc/bin/service/tcp445
32 service script (see
33 .IR listen (8)),
34 which passes
35 .I conndir
36 and filedescriptors 0 and 1 to the incoming connection.
37 .PP
38 Users are authenticated by ther Inferno/pop secret held by the auth server.
39 When successful,
40 .I cifsd
41 changes its user id and namespace to the authenticated user.
42 Informative log messages are appended to
43 .B /sys/log/cifsd
44 if it exists.
45 .PP
46 By default the share 
47 .B local
48 is offered, which represents the root of the namespace
49 described by
50 .B /lib/namespace.
51 If a different name is explicitly requested by the client then
52 .B /bin/9fs
53 (see
54 .IR srv (4))
55 is invoked to attach that filesystem, which is then exported instead.
56 .PP
57 The flags are:
58 .TP
59 .B t
60 Run the server in trusted mode, so it will not require
61 authentication from the client and keep running in the callers
62 namespace.
63 .TP
64 .B d
65 Enable or increases debug verbosity for the
66 .I debuglog
67 file. Debug messages are never written to the system logfile.
68 .TP
69 .B f
70 Specify the filename for the
71 .I debuglog
72 file. If not specified no debug messages are generated.
73 .TP
74 .B w
75 Set the workgroup (or primary domain) to
76 .I name. The default is
77 .SM WORKGROUP
78 .TP
79 .B o
80 Enables the following
81 .I option
82 string.
83 This flag can appear multiple times when more than one option has to
84 be enabled.  Valid options are:
85 .RS
86 .TP
87 .B trspaces
88 transforms whitespace in filenames to non breaking whitespace. This is useful
89 when exporting filesystems other than fossil.
90 .TP
91 .B casesensitive
92 By default, filename lookups are done case insensitive to match
93 windows filesystem semantics.  This option disables case insensitive
94 lookups which can result in a performance improvement, but might break
95 some applications.
96 .SH FILES
97 .B /rc/bin/service/tcp445
98 .br
99 .B /sys/log/cifsd
100 .br
101 .B /lib/namespace
102 .SH SOURCE
103 .B /sys/src/cmd/ip/cifsd
104 .SH "SEE ALSO"
105 .IR listen (8),
106 .IR srv (4)
107 .SH HISTORY
108 .I Cifsd
109 first appeared in 9front (May, 2011).