💾 Archived View for kamid.omarpolo.com › kamid.conf.5.txt captured on 2023-04-19 at 22:22:00.
⬅️ Previous capture (2023-01-29)
-=-=-=-=-=-=-
KAMID.CONF(5) File Formats Manual KAMID.CONF(5)
NAME
kamid.conf 9p file server daemon configuration file
DESCRIPTION
kamid.conf is the configuration file for the 9p file server
daemon kamid(8).
The format of the configuration file is fairly flexible.
The current line can be extended over multiple lines using a
backslash (\). Comments can be put anywhere in the file
using a hash mark (#), and extend to the end of the
current line. Care should be taken when commenting out
multi-line text: the comment is effective until the end of
the entire block. Arguments names not beginning with a
letter, digit, or underscore, as well as reserved words
(such as listen, pki and table) must be quoted. Arguments
containing whitespace should be surrounded by double quotes
(").
Macros can be defined that are later expanded in context.
Macro names must start with a letter, digit, or underscore,
and may contain any of those characters, but may not be
reserved words. Macros are not expanded inside quotes. For
example:
lan_addr = "192.168.0.1"
listen on $lan_addr prot 5640 tls auth <users>
Additional configuration files can be included with the
include keyword, for example:
include "/etc/kamid.conf.local"
The syntax of kamid.conf is described below.
listen [options...]
The options are as follows:
on address port number
Listen on the address for incoming
connection on the given port number.
address can be an IP address or a domain
name.
tls pki name
Use the tls certificate name previously
defined with the pki rule.
auth <table>
Use the given authentication table to
authorize the clients.
userdata <table>
Maps user (virtuals or not) to their
exported tree. By default the user home
directory obtained with getpwnam(3) is used.
virtual <table>
Maps virtual users to local user.
pki pkiname cert certfile
Associate certificate file certfile with pki entry
pkiname. The pki entry defines a keypair
configuration that can be referenced in listener
rules.
pki pkiname key keyfile
Associate the key located in keyfile with pki entry
pkiname.
table name {value => value [, ...]}
Tables provide additional configuration information
for kamid(8) in the form of key-value mappings.
Declare a mapping table containing the given static
key-value pairs.
EXAMPLES
A sample configuration file:
pki localhost cert "/etc/ssl/localhost.crt"
pki localhost key "/etc/ssl/private/localhost.key"
table users { "SHA256:..." => "op" }
listen on localhost port 5640 tls pki localhost auth <users>
SEE ALSO
kamictl(8), kamid(8)
OpenBSD 7.2 December 14, 2021 OpenBSD 7.2