1CANNASERVER(1M) CANNASERVER(1M)
2
6 cannaserver - Kana-Kanji conversion server
7
9 cannaserver [-d] [-u userid] [-inet] [-inet6] [-l n] [-syslog] [-p num]
10 [ddpath]
11
13 cannaserver(1M) provides the Kana-Kanji conversion service. Most com‐
14 monly this daemon starts at daemon bootup framework like /etc/rc
15 depending on your system, so you do not usually start it up manually.
16 By default, cannaserver(1M) only accepts connections from clients at
18 the same host where the server is running (via UNIX domain socket).
19 You can make it accessible from other hosts via TCP by using option
20 -inet (or -inet6). Whether you use this option or not, you can get
21 access control based on user and host using /etc/hosts.canna.
22 cannaserver(1M) immediately forks and gets into the background after it
24 starts. You do not need to use '&' explicitly to make it run in the
25 background.
26 When it starts, cannaserver(1M) creates the UNIX domain socket
28 /var/run/.iroha_unix/IROHA[:num] to communicate clients. The socket is
29 deleted automatically if cannaserver(1M) terminates normally. The
30 socket may exist while cannaserver(1M) is not running (because, for
31 example, cannaserver(1M) terminated abnormally). In this case, delete
32 the file manually or you cannot start it.
33 /var/lib/canna/dic/*/dics.dir includes the list of dictionaries which
35 are available to clients. Users (i.e. clients) can choose which to use
36 and specify them in ~/.canna.
37
39 ddpath Specifies the directory that contains dictionaries.
40 -inet This option lets cannaserver(1M) accept connections from
42 remote hosts using inet domain socket (IPv4). By default,
43 the cannaserver(1M) uses only UNIX domain socket, i.e. only
44 clients in your local machine can connect to the server.
45 -inet6 Enable IPv6. If this option is used solely, IPv4 access is
47 disabled. If you want to use IPv4 at the same time, use
48 both -inet and -inet6.
49 -l n Outputs the cannaserver(1M) log to /tmp/canna.log. n (1 to
51 5) specifies the log level.
52 -d Starts cannaserver(1M) in debug mode. It is executed as
54 the foreground process. Log data at log level 5 is output
55 to the standard output.
56 -u userid Specifies which user cannaserver(1M) runs as. By default,
58 cannaserver(1M) runs as the user who started can‐
59 naserver(1M).
60 -syslog Outputs the cannaserver(1M) log to syslogd(8). If you spec‐
62 ify this option, logs are not output to
63 /var/log/canna/CANNA?msgs.
64 -p num By this option cannaserver(1M) uses the port number 5680 +
66 num. The default port number is 5680. This option also has
67 an effect on the filename of the socket and the log file.
68 See below.
69
71 /var/run/.iroha_unix/IROHA[:num]
72 Socket. [:num] part is added only when you specify -p.
73 /var/lib/canna/dic/*/dics.dir
75 Dictionary directory
76 /etc/hosts.canna
78 Access control file
79 /var/log/canna/CANNA?msgs
81 Log file. "?" is replaced with num specified with -p, and
82 defaults to 0 without -p num. Log messages are not output to
83 this file when -syslog is specified.
84
86 cannakill(1M), cannastat(1), cannacheck(1), cshost(1)
87 CANNASERVER(1M)