1 .\" Copyright (c) 2021 Omar Polo <op@omarpolo.com>
2 .\"
3 .\" Permission to use, copy, modify, and distribute this software for any
4 .\" purpose with or without fee is hereby granted, provided that the above
5 .\" copyright notice and this permission notice appear in all copies.
6 .\"
7 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 .\"
15 .Dd $Mdocdate: January 31 2022 $
16 .Dt KAMID 8
17 .Os
18 .Sh NAME
19 .Nm kamid
20 .Nd 9p file server daemon
21 .Sh SYNOPSIS
22 .Nm
23 .Op Fl dnv
24 .Op Fl D Ar macro Ns = Ns Ar value
25 .Op Fl f Pa file
26 .Op Fl s Pa socket
27 .Sh DESCRIPTION
28 .Nm
29 is a 9p file server daemon.
30 .Pp
31 The options are as follows:
32 .Bl -tag -width Ds
33 .It Fl D Ar macro Ns = Ns Ar value
34 Set a
35 .Ar macro
36 to a
37 .Ar value .
38 Macros can be referenced in the configuration files.
39 .It Fl d
40 Do not daemonize.
41 If this option is specified,
42 .Nm
43 will run in the foreground and log to
44 .Em stderr .
45 .It Fl f Ar file
46 specify an alternative configuration file.
47 .It Fl n
48 Configtest mode.
49 Only check the configuration file for validity.
50 .It Fl s Ar socket
51 Use an alternate location for the default control socket.
52 .It Fl v
53 Produce more verbose output.
54 .El
55 .Sh FILES
56 .Bl -tag -width "/var/run/kamid.sockXX" -compact
57 .It Pa /etc/kamid.conf
58 Default
59 .Nm
60 configuration file.
61 .It Pa /var/run/kamid.sock
62 UNIX-domain socket used for communication with
63 .Xr kamictl 8 .
64 .El
65 .Sh SEE ALSO
66 .Xr kami.conf 5 ,
67 .Xr kamictl 8
68 .Sh AUTHORS
69 .An -nosplit
70 The
71 .Nm
72 program was written by
73 .An Omar Polo Aq Mt op@omarpolo.com .
74 .Sh CAVEATS
75 .Nm
76 doesn't handle very well when a user directory is over multiple
77 devices since it uses the inode of files to build the QID path field.
78 .Pp
79 Opening or creating a file with the
80 .Dv OEXEC
81 flag set result in an error.