365 lines
5.6 KiB
HTML
365 lines
5.6 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>Configuring axspawn</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.63
|
|
"><LINK
|
|
REL="HOME"
|
|
TITLE="Linux Amateur Radio AX.25 HOWTO"
|
|
HREF="index.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="Configuring the node software"
|
|
HREF="x1688.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="Configuring the pms"
|
|
HREF="x1914.html"></HEAD
|
|
><BODY
|
|
CLASS="SECT1"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="3"
|
|
ALIGN="center"
|
|
>Linux Amateur Radio AX.25 HOWTO</TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="left"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="x1688.html"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
></TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="x1914.html"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="SECT1"
|
|
><H1
|
|
CLASS="SECT1"
|
|
><A
|
|
NAME="AEN1839"
|
|
>14. Configuring <EM
|
|
>axspawn</EM
|
|
></A
|
|
></H1
|
|
><P
|
|
>The <EM
|
|
>axspawn</EM
|
|
> program is a simple program that
|
|
allows AX.25 stations who connect to be logged in to your machine. It
|
|
may be invoked from the <EM
|
|
>ax25d</EM
|
|
> program as
|
|
described above in a manner similar to the <EM
|
|
>node</EM
|
|
>
|
|
program. To allow a user to log in to your machine you should add a
|
|
line similar to the following into your
|
|
<TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/ax25d.conf</TT
|
|
> file:</P
|
|
><P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
>default * * * * * 1 root /usr/sbin/axspawn axspawn %u</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></P
|
|
><P
|
|
>If the line ends in the <TT
|
|
CLASS="LITERAL"
|
|
>+</TT
|
|
> character then the connecting user must
|
|
hit return before they will be allowed to login. The default is to not wait.
|
|
Any individual host configurations that follow this line will have the
|
|
<EM
|
|
>axspawn</EM
|
|
> program run when they connect. When <EM
|
|
>axspawn</EM
|
|
> is
|
|
run it first checks that the command line argument it is supplied is a legal
|
|
callsign, strips the SSID, then it checks that <TT
|
|
CLASS="LITERAL"
|
|
>/etc/passwd</TT
|
|
> file to
|
|
see if that user has an account configured. If there is an account, and the
|
|
password is either <TT
|
|
CLASS="LITERAL"
|
|
>""</TT
|
|
> (null) or <TT
|
|
CLASS="LITERAL"
|
|
>+</TT
|
|
> then the user is logged
|
|
in, if there is anything in the password field the user is prompted to enter
|
|
a password. If there is not an existing account in the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/passwd</TT
|
|
>
|
|
file then <EM
|
|
>axspawn</EM
|
|
> may be configured to automatically create one.</P
|
|
><DIV
|
|
CLASS="SECT2"
|
|
><H2
|
|
CLASS="SECT2"
|
|
><A
|
|
NAME="AEN1858"
|
|
>14.1. Creating the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/axspawn.conf</TT
|
|
> file</A
|
|
></H2
|
|
><P
|
|
>You can alter the behaviour of <EM
|
|
>axspawn</EM
|
|
> in various ways by use of
|
|
the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/ax25/axspawn.conf</TT
|
|
> file. This file is formatted as
|
|
follows:</P
|
|
><P
|
|
><TABLE
|
|
BORDER="1"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="SCREEN"
|
|
># /etc/ax25/axspawn.conf
|
|
#
|
|
# allow automatic creation of user accounts
|
|
create yes
|
|
#
|
|
# guest user if above is 'no' or everything else fails. Disable with "no"
|
|
guest no
|
|
#
|
|
# group id or name for autoaccount
|
|
group ax25
|
|
#
|
|
# first user id to use
|
|
first_uid 2001
|
|
#
|
|
# maximum user id
|
|
max_uid 3000
|
|
#
|
|
# where to add the home directory for the new users
|
|
home /home/ax25
|
|
#
|
|
# user shell
|
|
shell /bin/bash
|
|
#
|
|
# bind user id to callsign for outgoing connects.
|
|
associate yes</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
> </P
|
|
><P
|
|
>The eight configurable characteristics of <EM
|
|
>axspawn</EM
|
|
> are as follows:</P
|
|
><P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="VARIABLELIST"
|
|
><DL
|
|
><DT
|
|
>#</DT
|
|
><DD
|
|
><P
|
|
>indicates a comment.</P
|
|
></DD
|
|
><DT
|
|
>create</DT
|
|
><DD
|
|
><P
|
|
>if this field is set to <TT
|
|
CLASS="LITERAL"
|
|
>yes</TT
|
|
> then <EM
|
|
>axspawn</EM
|
|
>
|
|
will attempt to automatically create a user account for any user who connects
|
|
and does not already have an entry in the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/passwd</TT
|
|
> file.</P
|
|
></DD
|
|
><DT
|
|
>guest</DT
|
|
><DD
|
|
><P
|
|
>this field names the login name of the account that will
|
|
be used for people who connect who do not already have accounts if
|
|
<EM
|
|
>create</EM
|
|
> is set to <TT
|
|
CLASS="LITERAL"
|
|
>no</TT
|
|
>. This is usually <TT
|
|
CLASS="LITERAL"
|
|
>ax25</TT
|
|
> or
|
|
<TT
|
|
CLASS="LITERAL"
|
|
>guest</TT
|
|
>.</P
|
|
></DD
|
|
><DT
|
|
>group</DT
|
|
><DD
|
|
><P
|
|
>this field names the group name that will be used for any
|
|
users who connect and do not already have an entry in the <TT
|
|
CLASS="LITERAL"
|
|
>/etc/passwd</TT
|
|
>
|
|
file.</P
|
|
></DD
|
|
><DT
|
|
>first_uid</DT
|
|
><DD
|
|
><P
|
|
>this is the number of the first userid that will be
|
|
automatically created for new users.</P
|
|
></DD
|
|
><DT
|
|
>max_uid</DT
|
|
><DD
|
|
><P
|
|
>this is the maximum number that will be used for the userid
|
|
of new users.</P
|
|
></DD
|
|
><DT
|
|
>home</DT
|
|
><DD
|
|
><P
|
|
>this is the home (login) directory of new users.</P
|
|
></DD
|
|
><DT
|
|
>shell</DT
|
|
><DD
|
|
><P
|
|
>this is the login shell of any new users.</P
|
|
></DD
|
|
><DT
|
|
>associate</DT
|
|
><DD
|
|
><P
|
|
>this flag indicates whether outgoing AX.25 connections
|
|
made by this user after they login will use their own callsign, or your
|
|
stations callsign.</P
|
|
></DD
|
|
></DL
|
|
></DIV
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="x1688.html"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
>Home</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="x1914.html"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>Configuring the <EM
|
|
>node</EM
|
|
> software</TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Configuring the <EM
|
|
>pms</EM
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |