summaryrefslogtreecommitdiffstats
path: root/ax25/axspawn.conf.5
blob: f03af9506fc77d9320fcfc6a6f0ded6f7e8eae91 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
.TH AXSPAWN.CONF 5 "16 January 2014" Linux "Linux Programmer's Manual"
.SH NAME
axspawn.conf \- Control the operation of axspawn.
.SH DESCRIPTION
.LP
The
.B axspawn.conf
file controls the operation of the axspawn(8) program. The operation of the
config file can best be seen in an example:
.LP
.RS
# this is /etc/ax25/axspawn.conf
.br
#
.br
# allow automatic creation of user accounts
.br
create    yes
.br
# allow empty password field (so user may login via telnet, too) [default no]
.br
create_empty_password       no
.br
#create_empty_password       yes
.br
# create with system utility useradd(8)? [default no]
.br
#create_with_useradd  no
.br
create_with_useradd  yes
.br
#
.br
# pwcheck method: password or call or group. [default: password]
.br
#pwcheck call
.br
#pwcheck group
.br
pwcheck password
.br
#
.br
# guest user if above is 'no' or everything else
.br
# fails. Disable with "no"
.br
guest     guest
.br
#
.br
# group id or name for autoaccount
.br
group     hams
.br
#
.br
# first user id to use
.br
first_uid 400
.br
#
.br
# maximum user id
.br
max_uid   2000
.br
#
.br
# where to add the home directory for the new user
.br
home      /home/hams
.br
#
.br
# secure homedirectories (g-rwx)
.br
#secure_home yes
.br
#
.br
# user's shell (if not configured, it's /bin/bash, or if
.br
# create_with_useradd is set, useradd uses the shell
.br
# configured in /etc/default/useradd).
.br
shell     /bin/bash
.br
#
.br
# bind user id to callsign for outgoing connects.
.br
associate yes
.RE
.LP
The \(lqassociate\(rq option has to be used with great care. If a user logs
on it removes any existing callsign from the translation table for this
userid and replaces it with the callsign and SSID of the user. This will
happen with multiple connects (same callsign, different SSIDs), too. Unless
you want your users to be able to call out from your machine disable
\(lqassociate\(rq.
.SH FILES
.LP
/etc/ax25/axspawn.conf
.SH "SEE ALSO"
.BR axspawn (8).