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