Updating manpages so they're not gzipped, added new debian folder,
patched out installman
This commit is contained in:
Dave Hibberd
parent
4685b08774
commit
f9627d1e66
|
|
@ -0,0 +1,2 @@
|
||||||
|
Manpages from upstream have been patched out due to being supplied as
|
||||||
|
gzipped files. They have been unzipped and moved to debian/manpages.
|
||||||
|
|
@ -0,0 +1,52 @@
|
||||||
|
.TH AXDIGI 8 "28 April 2013" Linux "Linux Programmer's Manual"
|
||||||
|
.SH NAME
|
||||||
|
axdigi \- axdigi file.
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.LP
|
||||||
|
.B axdigi
|
||||||
|
This executable should be loaded in your startup script with the command:
|
||||||
|
/usr/local/sbin/axdigi (or path to where you installed it). This file enables
|
||||||
|
cross-port digipeating within your linux's ax25 stack.
|
||||||
|
.LP
|
||||||
|
Special Conditions:
|
||||||
|
.B axdigi
|
||||||
|
In order to digipeat, you or the user *must* know your SSID associated
|
||||||
|
with the ifconfig <interface> that is the direct link to the outbound
|
||||||
|
path they wish to digi to. axdigi will handle the appropriate digipeat
|
||||||
|
accordingly. If you have multiple ax25 interfaces, you should somehow
|
||||||
|
list them for the users in the axports description so they will see
|
||||||
|
them when doing an "Interface" command while on URONode. If the user
|
||||||
|
wishes to log off URONode and digi through, then they must use the
|
||||||
|
interface's SSID associated with the OUTBOUND path to their destination.
|
||||||
|
.sp
|
||||||
|
commands are:
|
||||||
|
.TP 14
|
||||||
|
.B C <destination> via <your interface-SSID>
|
||||||
|
If the user heard station A1BCD-7 on your ax0 interface, and that
|
||||||
|
interface's SSID is: W1XYZ-9 (NOT the FlexID of URONode!) then the user
|
||||||
|
would enter:
|
||||||
|
c a1bcd-7 via w1xyz-9
|
||||||
|
even if their inbound interface might be ax1 and it's ifconfig shows
|
||||||
|
your SSID as w1xyz-10!
|
||||||
|
.TP 14
|
||||||
|
.B Detailed information
|
||||||
|
If you have 3 ax25 interfaces ifconfigured as:
|
||||||
|
ax0 - w1xyz-9
|
||||||
|
ax1 - w1xyz-10
|
||||||
|
ax2 - w1xyz-11
|
||||||
|
|
||||||
|
User k2lmn would enter your node via ax2 and they wish to digi to
|
||||||
|
a1bcd-7 which is heard on ax0 they would simply enter:
|
||||||
|
c a1bcd-7 via w1xyz-9 to connect. Axdigi handles the crossport
|
||||||
|
functions. If they tried:
|
||||||
|
c a1bcd-7 via w1xyz-11
|
||||||
|
the connect would fail because it would attempt to digi OUT on your
|
||||||
|
ax2 interface. This may get tricky so expect a need to educate your
|
||||||
|
users on this. Unfortunately, linux lacks native cross-port digipeating
|
||||||
|
at this time so this is a work-around.
|
||||||
|
.SH FILES
|
||||||
|
.LP
|
||||||
|
/usr/local/sbin/axdigi
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
.BR axports (5),
|
||||||
|
.BR ax25 (4).
|
||||||
|
|
@ -0,0 +1,51 @@
|
||||||
|
.TH FLEXD.CONF 5 "28 April 2013" Linux "Linux Programmer's Manual"
|
||||||
|
.SH NAME
|
||||||
|
flexd.conf \- flexd configuration file.
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.LP
|
||||||
|
.B flexd.conf
|
||||||
|
file is read by flexd at program startup and is used to modify the
|
||||||
|
behaviour of the robot.
|
||||||
|
.LP
|
||||||
|
The lines within
|
||||||
|
.B flexd.conf
|
||||||
|
must either be a comment line, which starts with a # in the first column, or
|
||||||
|
one of the commands listed below. Commands and arguments are delimited
|
||||||
|
by white space. Arguments can contain white space if they are enclosed
|
||||||
|
in double quotes. Also C-style escapes (\\n, \\x0A, \\012 etc.) are parsed
|
||||||
|
within double quotes.
|
||||||
|
.sp
|
||||||
|
Available configuration commands are:
|
||||||
|
.TP 14
|
||||||
|
.B MyCall <xx#xx>
|
||||||
|
Sets up the callsign AND ssid you wish to use to connect to your flexnet
|
||||||
|
neighbor for destinations import. Do NOT use an ssid of your ax25 interface
|
||||||
|
which you'll be polling from as you may create a loop between your system
|
||||||
|
and the flexnet neighbor.
|
||||||
|
An example: MyCall kb1uuu-13
|
||||||
|
.TP 14
|
||||||
|
.B PollInterval <time/secs>
|
||||||
|
This string tells the robot how many times in SECONDS to poll your flexnet
|
||||||
|
neighbor and import their destination table. In my production environment
|
||||||
|
300 (or 5 minutes) seemed to be fine. I would NOT go below 180 (3 minutes)
|
||||||
|
as you may create more traffic than needed.
|
||||||
|
.TP 14
|
||||||
|
.B FlexGate <xx#xx-##>
|
||||||
|
This is the callsign of your flexnet neighbor. The robot will read this
|
||||||
|
callsign-ssid and attempt a connect to it every ## minutes assigned in
|
||||||
|
PollInterval <time/mins>. Be sure you do NOT configure it to connect to
|
||||||
|
a service linked within the flexnet neighbor such as a BBS! You will NOT
|
||||||
|
receive any destinations to your system that way and the BBS will think
|
||||||
|
you're attempting a feed.
|
||||||
|
.TP 14
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
.SH FILES
|
||||||
|
.LP
|
||||||
|
/usr/local/etc/ax25/flexd.conf
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
.BR uronode (8),
|
||||||
|
.BR uronode.perms (5),
|
||||||
|
.BR axports (5),
|
||||||
|
.BR ax25 (4).
|
||||||
|
|
@ -0,0 +1,36 @@
|
||||||
|
.TH NODEUSERS 1 "28 April 1998" Linux "Linux Programmer's Manual"
|
||||||
|
.SH NAME
|
||||||
|
nodeusers \- URONode user information lookup program
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.B nodeusers [-a] [-i] [-l]
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.LP
|
||||||
|
.B Nodeusers
|
||||||
|
displays information about current URONode users.
|
||||||
|
.SH OPTIONS
|
||||||
|
.TP 10
|
||||||
|
.BI \-a
|
||||||
|
Tells nodeusers to use a plain <CR> as end-of-line. This is useful
|
||||||
|
if nodeusers is called from ax25d.
|
||||||
|
.TP 10
|
||||||
|
.BI \-i
|
||||||
|
Tells nodeusers to use a <CR><LF> pair as end-of-line sequence and also
|
||||||
|
to wait for one line of input before sending the user data. This
|
||||||
|
should be used if nodeusers is used in an internet environment (eg. as
|
||||||
|
a fingerd replacement).
|
||||||
|
.TP 10
|
||||||
|
.BI \-l
|
||||||
|
Enables logging of errors to the system logging facility.
|
||||||
|
.SH FILES
|
||||||
|
.LP
|
||||||
|
.TP 5
|
||||||
|
.B /var/ax25/node/loggedin
|
||||||
|
Database of current users.
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
.BR uronode (8)
|
||||||
|
.SH AUTHOR
|
||||||
|
Brian Rogers N1URO <n1uro@n1uro.com>
|
||||||
|
.br
|
||||||
|
Stefano Noferi IZ5AWZ <iz5awz@radio-ge.cnuce.cnr.it>
|
||||||
|
.br
|
||||||
|
Tomi Manninen OH2BNS <tpmannin@cc.hut.fi>
|
||||||
|
|
@ -0,0 +1,245 @@
|
||||||
|
.TH URONODE 8 "28 April 1998" Linux "Linux System Managers Manual"
|
||||||
|
.SH NAME
|
||||||
|
URONode \- Node front end for AX.25, NET/ROM, Rose and TCP
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.B node
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.LP
|
||||||
|
.B URONode
|
||||||
|
is a simple node front end, modelled after the node shells of LinuxNode,
|
||||||
|
AWZNode, and Flexnode.
|
||||||
|
.SH COMMANDS
|
||||||
|
The following commands are supported for users of
|
||||||
|
.B URONode:
|
||||||
|
.TP 14
|
||||||
|
.BI ?
|
||||||
|
Give short list of available commands.
|
||||||
|
.TP 14
|
||||||
|
.BI Bye
|
||||||
|
Disconnect user from the node.
|
||||||
|
.TP 14
|
||||||
|
.BI "Connect <call | alias> [s|d] For NETROM"
|
||||||
|
.TP 14
|
||||||
|
.BI "Connect <port> <call> [via <call1> ...] [d|s] For AX.25"
|
||||||
|
.TP 14
|
||||||
|
.BI "Connect <call> <address> [<digi>] [d|s] For ROSE"
|
||||||
|
.TP 14
|
||||||
|
.BI "Connect <destination> [s|d] For FlexNet"
|
||||||
|
.sp 1
|
||||||
|
Initiates an AX25, NET/ROM, ROSE or Flexnet connection to a remote host.
|
||||||
|
If more than two parameters are entered and the second parameter is ten
|
||||||
|
charachers in length then it is interpreted as a ROSE connection,
|
||||||
|
otherwise the first parameter is interpreted as a port name and AX25 is
|
||||||
|
used to make the connection via that port. If only one parameter is given
|
||||||
|
the connection is made searching for the callsign in NET/ROM nodes,
|
||||||
|
in AX25 Fixed links, in FlexNet destinations and last in Mheard database
|
||||||
|
in this order.
|
||||||
|
.sp
|
||||||
|
For a ROSE connection the <address> part must be exactly six or ten digits.
|
||||||
|
If only six digits are supplied, the DNIC (first four digits) default to the
|
||||||
|
local DNIC. The local DNIC is assumed to be that of the first configured
|
||||||
|
Rose port in /etc/ax25/rsports.
|
||||||
|
.sp
|
||||||
|
The user may optionally supply as the last argument a single character
|
||||||
|
which modifies the default behaviour on disconnection of the connection.
|
||||||
|
If a single `s' is entered as the last argument, then when the remote host
|
||||||
|
disconnects you will be returned to this node. If a single `d' is entered as
|
||||||
|
the last argument, you will be disconnected from this node too. The Default
|
||||||
|
behaviour (neither `s' nor `d' entered) is configured in the node configuration
|
||||||
|
file and depends on the sysop preference.
|
||||||
|
.TP 14
|
||||||
|
.BI "CAllbook <call>[@<server>]"
|
||||||
|
Retrieve data about a callsign from an internet-accessible
|
||||||
|
callbook server. The server name can usually be omitted, since
|
||||||
|
the default server configured by the operator is usually
|
||||||
|
valid. The default setting can be overridden by specifying
|
||||||
|
a host name.
|
||||||
|
.TP 14
|
||||||
|
.BI "Escape [<escape string>]"
|
||||||
|
Override the sysop configured default escape character setting. If the Escape
|
||||||
|
command is given without an argument then the current escape character setting
|
||||||
|
is returned to the user. The escape string may be specified using any of the
|
||||||
|
well known codings:
|
||||||
|
.IP
|
||||||
|
.BI "<char>"
|
||||||
|
to enter the escape character in its binary form.
|
||||||
|
.IP
|
||||||
|
.BI "^C"
|
||||||
|
to enter the escape character as a control character value.
|
||||||
|
.IP
|
||||||
|
.BI "NNN"
|
||||||
|
to set the escape character to a Decimal value.
|
||||||
|
.IP
|
||||||
|
.BI "0xNN"
|
||||||
|
to set the escape character to a HexaDecimal value.
|
||||||
|
.IP
|
||||||
|
.BI "0NNN"
|
||||||
|
to set the escape character to an Octal value.
|
||||||
|
.IP
|
||||||
|
.BI "off"
|
||||||
|
to disable the escape character.
|
||||||
|
.TP 14
|
||||||
|
.BI "Finger [<username>][@<hostname>]"
|
||||||
|
Retrieve information about users of a system. If the user
|
||||||
|
name is omitted, shows the users currently logged on the
|
||||||
|
host. If the hostname is omitted, defaults to the local host.
|
||||||
|
.TP 14
|
||||||
|
.BI "Help [<command>]"
|
||||||
|
Give help for the specified command or this text if no
|
||||||
|
command is specified. Commands can not be abbreviated.
|
||||||
|
Use the "?" command to retrieve a list of available commands.
|
||||||
|
.TP 14
|
||||||
|
.BI "HOst <hostname> | <ip address>"
|
||||||
|
Give the Domain Name Service host name information about <hostname> or
|
||||||
|
<ip address>.
|
||||||
|
.TP 14
|
||||||
|
.BI Info
|
||||||
|
Display the version information and the contents of the
|
||||||
|
/usr/local/etc/ax25/uronode.info file, which should describe any aspects
|
||||||
|
of your system that you would like to brag about.
|
||||||
|
.TP 14
|
||||||
|
.BI INTerfaces
|
||||||
|
Display the node's interface schema, most folks often call these "ports".
|
||||||
|
.TP 14
|
||||||
|
.BI "Links [d | n | v | <call>]"
|
||||||
|
Shows the AX25 link table of the local node. The destinations
|
||||||
|
on this list can be reached using the Connect command without
|
||||||
|
knowing the actual network path used (assuming the network is OK).
|
||||||
|
|
||||||
|
The optional parameter d show the AX25 nodes directly linked.
|
||||||
|
The optional parameter n show the AX25 nodes linked connecting
|
||||||
|
another node and passing a string like "C XX0XX".
|
||||||
|
The optional parameter v show the AX25 links via digipeaters.
|
||||||
|
|
||||||
|
You can also specify a destination callsign to get the verbose
|
||||||
|
information for a single destination.
|
||||||
|
.TP 14
|
||||||
|
.BI "Mheard [<portname>]"
|
||||||
|
Give a list of heard AX.25 stations on the specified port.
|
||||||
|
.TP 14
|
||||||
|
.BI "Nodes [* | <node>]"
|
||||||
|
Show the NET/ROM node table of the local host. The nodes on this
|
||||||
|
list can be reached using the Connect command without knowing the
|
||||||
|
actual network path used (assuming the network is OK).
|
||||||
|
.sp
|
||||||
|
The optional argument '*' toggles verbose mode, showing the
|
||||||
|
Obsolescence counter, relative path quality and the port and
|
||||||
|
neighbour node used to reach each node. You can also specify
|
||||||
|
a node callsign to get the verbose information for a single node.
|
||||||
|
In that case a "which" field that tells what route the kernel
|
||||||
|
will use to reach the node is also shown.
|
||||||
|
.TP 14
|
||||||
|
.BI "Ping <host> [<size>]"
|
||||||
|
Check if a host can be reached trough the network by sending
|
||||||
|
an ICMP Echo Request packet to the host and waiting for it to
|
||||||
|
reply. If a reply is received the round-trip-time (RTT)
|
||||||
|
between the local and remote hosts is shown.
|
||||||
|
.sp
|
||||||
|
If an optional length is specified the data portion of the
|
||||||
|
packet is filled with length number of bytes.
|
||||||
|
.TP 14
|
||||||
|
.BI Routes
|
||||||
|
Shows the NET/ROM route table of the local host (eg. the nodes
|
||||||
|
which the local node directly talks with). These nodes are used
|
||||||
|
to reach the other nodes on the node table. Fields shown are:
|
||||||
|
.IP
|
||||||
|
.BI "Link"
|
||||||
|
Is there an AX25 connection active to this node.
|
||||||
|
.IP
|
||||||
|
.BI "Port"
|
||||||
|
Which port is this route on.
|
||||||
|
.IP
|
||||||
|
.BI "Callsign"
|
||||||
|
The callsign of the neighbour node.
|
||||||
|
.IP
|
||||||
|
.BI "Quality"
|
||||||
|
A relative quality for the path (0-255).
|
||||||
|
.IP
|
||||||
|
.BI "Destinations"
|
||||||
|
Number of other nodes reached via this route.
|
||||||
|
.IP
|
||||||
|
.BI "Lock"
|
||||||
|
Is the quality of this route locked by the operator.
|
||||||
|
.IP
|
||||||
|
.BI "QSO"
|
||||||
|
Number of NET/ROM session enties.
|
||||||
|
.TP 14
|
||||||
|
.BI "Telnet <host> [<port>] [<string>] [d|s]"
|
||||||
|
Initiate a telnet session to a remote host using TCP/IP.
|
||||||
|
By default, the telnet command connects to the TCP port 23
|
||||||
|
(allocated for telnet). You can specify another TCP port or
|
||||||
|
a TCP port name.
|
||||||
|
.sp
|
||||||
|
If an optional third argument <string> is given, that string, followed
|
||||||
|
by a CRLF is sent to the remote host right after the connection is
|
||||||
|
established. This is mainly useful for command aliases.
|
||||||
|
.sp
|
||||||
|
If a single `s' is entered as the last parameter, then when
|
||||||
|
the remote host disconnects you will be returned to this node.
|
||||||
|
If a single `d' is entered as the last parameter, you will
|
||||||
|
be disconnected from this node too. Default behaviour (neither
|
||||||
|
`s' nor `d' entered) depends on sysop configuration.
|
||||||
|
.TP 14
|
||||||
|
.BI "MSG <user> <message>"
|
||||||
|
Send a message to another user of the node. The user
|
||||||
|
in question must be in idle state (ie. not connected/connecting
|
||||||
|
anywhere or running a program).
|
||||||
|
.sp
|
||||||
|
If the user has an SSID other than zero, the SSID must be
|
||||||
|
specified. If multiple users are logged in with the same
|
||||||
|
callsign/SSID pair, those who are in idle state, get the message.
|
||||||
|
.TP 14
|
||||||
|
.BI Users
|
||||||
|
Show a list of users currently connected to the local node,
|
||||||
|
where the users are coming from, and what are they doing at the
|
||||||
|
moment.
|
||||||
|
.SH FILES
|
||||||
|
.LP
|
||||||
|
.TP 5
|
||||||
|
.B /usr/local/etc/ax25/uronode.conf
|
||||||
|
URONode configuration file.
|
||||||
|
.br
|
||||||
|
.TP 5
|
||||||
|
.B /usr/local/etc/ax25/uronode.perms
|
||||||
|
URONode permissions file.
|
||||||
|
.br
|
||||||
|
.TP 5
|
||||||
|
.B /usr/local/etc/ax25/uronode.users
|
||||||
|
URONode users settings file.
|
||||||
|
.br
|
||||||
|
.TP 5
|
||||||
|
.B /usr/local/etc/ax25/uronode.motd
|
||||||
|
URONode message of the day file.
|
||||||
|
.br
|
||||||
|
.TP 5
|
||||||
|
.B /usr/local/etc/ax25/uronode.info
|
||||||
|
The response to the 'info' command.
|
||||||
|
This file should be edited to reflect the local configuration.
|
||||||
|
.br
|
||||||
|
.TP 5
|
||||||
|
.B /usr/local/var/ax25/node/loggedin
|
||||||
|
Database of current users.
|
||||||
|
.br
|
||||||
|
.TP 5
|
||||||
|
.B /usr/local/var/ax25/mheard/mheard.dat
|
||||||
|
Information about AX.25 stations heard.
|
||||||
|
.br
|
||||||
|
.TP 5
|
||||||
|
.B /usr/local//ax25/node/help/*.hlp
|
||||||
|
The online help files.
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
.BR uronode.conf (5),
|
||||||
|
.BR uronode.perms (5),
|
||||||
|
.BR axports (5),
|
||||||
|
.BR ax25d (8),
|
||||||
|
.BR mheardd (8).
|
||||||
|
.SH AUTHOR
|
||||||
|
Brian Rogers N1URO <n1uro@n1uro.com>
|
||||||
|
.SH THANKS TO
|
||||||
|
Stefano Noferi IZ5AWZ <iz5awz@radio-gw.cnuce.cnr.it>
|
||||||
|
.br
|
||||||
|
Tomi Manninen OH2BNS <tpmannin@cc.hut.fi>
|
||||||
|
.br
|
||||||
|
Alan Cox GW4PTS <gw4pts@gw4pts.ampr.org>
|
||||||
|
.br
|
||||||
|
Roy PE1RJA <roy@esrac.ele.tue.nl>
|
||||||
|
|
@ -0,0 +1,252 @@
|
||||||
|
.TH URONODE.CONF 5 "28 April 1998" Linux "Linux Programmer's Manual"
|
||||||
|
.SH NAME
|
||||||
|
uronode.conf \- URONode configuration file.
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.LP
|
||||||
|
.B uronode.conf
|
||||||
|
file is read by URONode at program startup and is used to modify the
|
||||||
|
behaviour of the node. The URONode node.conf is no compatible with
|
||||||
|
the LinuxNode file, as it add new entries: FlexId Prompt and PassPromt.
|
||||||
|
.LP
|
||||||
|
The lines within
|
||||||
|
.B uronode.conf
|
||||||
|
must either be a comment line, which starts with a # in the first column, or
|
||||||
|
one of the commands listed below. Commands and arguments are delimited
|
||||||
|
by white space. Arguments can contain white space if they are enclosed
|
||||||
|
in double quotes. Also C-style escapes (\\n, \\x0A, \\012 etc.) are parsed
|
||||||
|
within double quotes. Tabs may also be used for delimiting columns.
|
||||||
|
.sp
|
||||||
|
Available configuration commands are:
|
||||||
|
.TP 14
|
||||||
|
.B Alias <NAme> \(lq<command> [<args...>]\(rq
|
||||||
|
Sets up a command alias. The number of uppercase characters at the
|
||||||
|
beginning of <NAme> specifies how much the user may abbreviate the
|
||||||
|
command. The uppercase part should be long enough to separate the command
|
||||||
|
from other commands starting with the same letters. If there are no
|
||||||
|
uppercase letters in the beginning, the whole name is converted to upper
|
||||||
|
case and user can not abbreviate the command.
|
||||||
|
The command and arguments are subject to
|
||||||
|
.B parameter expansion
|
||||||
|
(see below).
|
||||||
|
.TP 14
|
||||||
|
.B ConnTimeout <timeout>
|
||||||
|
When user is connected to another system via this system and the
|
||||||
|
connection is idle (no data flowing in either direction) for <timeout>
|
||||||
|
seconds the connection is dropped and user disconnected from node.
|
||||||
|
Default is 3600 seconds
|
||||||
|
(1 hour).
|
||||||
|
.TP 14
|
||||||
|
.B Email <your@node.ampr.org>
|
||||||
|
This is your amprnet or commercial email address that's displayed
|
||||||
|
to users on interfaces you require having a password on to access
|
||||||
|
your node, highly suggested on inet interfaces. You may leave
|
||||||
|
off the <>'s. If you do not have an Email line in node.conf
|
||||||
|
then your email address to users will display as (null) and
|
||||||
|
will make you look sloppy :-)
|
||||||
|
.TP 14
|
||||||
|
.B EscapeChar <escape>
|
||||||
|
Specifies the escape character. <escape> should be the decimal
|
||||||
|
representation of the ASCII code of the wanted escape character.
|
||||||
|
Setting escape character to \-1 disables the feature altogether.
|
||||||
|
The default is 20 (ctrl-t).
|
||||||
|
.sp
|
||||||
|
Note that the escape mechanism breaks 8-bit transparency of URONode
|
||||||
|
and you should either disable it or set the no-escape flag in node.perms
|
||||||
|
for the forwarding stations if (compressed) forward is run trough
|
||||||
|
URONode.
|
||||||
|
.TP 14
|
||||||
|
.B ExtCmd <NAme> <flags> <uid> <exec> <args...>
|
||||||
|
.RS
|
||||||
|
.TP 10
|
||||||
|
.B NAme
|
||||||
|
This is the name under which the command appears at nodes command list.
|
||||||
|
The number of uppercase characters at the beginning of <NAme> specifies
|
||||||
|
how much the user may abbreviate the command.
|
||||||
|
The uppercase part should be long enough to separate the command
|
||||||
|
from other commands starting with the same letters. If there are no
|
||||||
|
uppercase letters in the beginning, the whole name is converted to upper
|
||||||
|
case and user can not abbreviate the command.
|
||||||
|
.TP 10
|
||||||
|
.B flags
|
||||||
|
This is a sum of flags that control the way the external
|
||||||
|
command is executed. Currently two flags are implemented:
|
||||||
|
.RS
|
||||||
|
.TP 5
|
||||||
|
.B 1
|
||||||
|
Run command through pipe. Without this flag node just fork()s and exec()s
|
||||||
|
the specified command and then waits for it to terminate. The command must
|
||||||
|
it self be aware about the underlying protocol. It must handle packetising
|
||||||
|
and any end of line conversions. With this flag however node sets up a pipe
|
||||||
|
between it self and the command and handles packetising and end of line
|
||||||
|
conversions for it.
|
||||||
|
.TP 5
|
||||||
|
.B 2
|
||||||
|
Reconnected to flag. If this flag is set, the user gets a reconnected to
|
||||||
|
prompt after the external command is finished.
|
||||||
|
.RE
|
||||||
|
.TP 10
|
||||||
|
.B uid
|
||||||
|
This is the userid that the following command should run under when
|
||||||
|
executing.
|
||||||
|
.TP 10
|
||||||
|
.B exec
|
||||||
|
This is the executable that should be executed.
|
||||||
|
.TP 10
|
||||||
|
.B args...
|
||||||
|
These are the optional arguments that are passed to the executable.
|
||||||
|
The arguments are subject to
|
||||||
|
.SM
|
||||||
|
.B "parameter expansion"
|
||||||
|
(see below).
|
||||||
|
.RE
|
||||||
|
.TP 14
|
||||||
|
.B HiddenPorts <portname> ...
|
||||||
|
Marks <portname> as hidden. Hidden ports are not shown to users in
|
||||||
|
Links, Mheard, Ports and Routes commands and can not be used to make
|
||||||
|
AX.25 downlink connections unless user is specially permitted to do
|
||||||
|
so (see node.perms(5)). Up to 32 hidden ports can be specified with
|
||||||
|
this command.
|
||||||
|
.TP 14
|
||||||
|
.B HostName <hostname>
|
||||||
|
This is the visible hostname of the node. It will be shown at telnet
|
||||||
|
login and in the node welcome message.
|
||||||
|
.TP 14
|
||||||
|
.B IdleTimeout <timeout>
|
||||||
|
After <timeout> seconds of inactivity while waiting for a command user
|
||||||
|
is disconnected from node. Default is 900 seconds (15 mins).
|
||||||
|
.TP 14
|
||||||
|
.B LocalNet <network>
|
||||||
|
Defines a "local" network. Users telneting from hosts in this network
|
||||||
|
are treated separately (see node.perms(5)). <network> is a KA9Q NOS
|
||||||
|
style network address consisting of a dotted quad ip address of the
|
||||||
|
network and a number of significant bits separated by a slash. Note
|
||||||
|
that 127.0.0.0/8 (loopback net) is also considered "local" by default.
|
||||||
|
.TP 14
|
||||||
|
.B LogLevel <loglevel>
|
||||||
|
Specifies what node should log. The available levels are:
|
||||||
|
.RS
|
||||||
|
.TP 5
|
||||||
|
.B 0
|
||||||
|
Don't log anything.
|
||||||
|
.TP 5
|
||||||
|
.B 1
|
||||||
|
Log only critical errors.
|
||||||
|
.TP 5
|
||||||
|
.B 2
|
||||||
|
Log errors and logins/logouts.
|
||||||
|
.TP 5
|
||||||
|
.B 3
|
||||||
|
Log errors, logins/logouts and all gateway commands.
|
||||||
|
.LP
|
||||||
|
Default is to log only critical errors.
|
||||||
|
.RE
|
||||||
|
.TP 14
|
||||||
|
.B NodeId <nodeid>
|
||||||
|
This is the node id that is shown in every message from node. Default
|
||||||
|
is "URONode".
|
||||||
|
.TP 14
|
||||||
|
.B FlexID <flexid>
|
||||||
|
This is typically your ax25 callsign-ssid that links to flexnet and/or
|
||||||
|
to your user interface set by the sysop in ax25d.conf.
|
||||||
|
.TP 14
|
||||||
|
.B RoseID <rosecall@dnic,######>
|
||||||
|
This is your node's rosecall-ssid and your full dnic number typically
|
||||||
|
consisting of your country code, area code, and phone extension. An
|
||||||
|
example is: 3100,860906. The full string would be for this part of
|
||||||
|
the conf file using my config: RoseID n1uro-8@3100860906 or if you do not
|
||||||
|
use rose enter: RoseID none
|
||||||
|
.TP 14
|
||||||
|
.B NrPort <portname>
|
||||||
|
This is the name of the netrom port that is used when making outgoing
|
||||||
|
netrom connects. Normally it should match the portname that is used
|
||||||
|
in ax25d.conf to listen for incoming netrom calls. Default is the first
|
||||||
|
netrom port.
|
||||||
|
.TP 14
|
||||||
|
.B ReConnect on|off
|
||||||
|
ReConnect flag. If this is on, users gatewaying to another host
|
||||||
|
get reconnected to this node after the remote host closes connection.
|
||||||
|
If it's off connection to the user will also be closed. User can
|
||||||
|
override the default behaviour with a single `s' or `d' at the end
|
||||||
|
of the gatewaying command (connect or telnet). Default is off.
|
||||||
|
.TP 14
|
||||||
|
.B Prompt <NodePrompt>
|
||||||
|
This is the prompt string of the node. It's delimited by double quotes.
|
||||||
|
You can use also a "\\n" character for a multi-lines prompt.
|
||||||
|
.TP 14
|
||||||
|
.B PassPrompt <PasswordPrompt>
|
||||||
|
This is the prompt string for sysop password request. It's delimited by
|
||||||
|
double quotes. You can use also a "\\n" character for a multi-lines prompt.
|
||||||
|
.SH PARAMETER EXPANSION
|
||||||
|
.LP
|
||||||
|
The arguments passed to the real command by the Alias and ExtCmd
|
||||||
|
commands are subject to parameter expansion. If a word starts with a %,
|
||||||
|
it is expanded. The following formats are expanded:
|
||||||
|
.TP 14
|
||||||
|
.B %parameter
|
||||||
|
This is substituted with the value of
|
||||||
|
.B parameter
|
||||||
|
.
|
||||||
|
.TP 14
|
||||||
|
.B %{parameter}
|
||||||
|
The same as above.
|
||||||
|
.TP 14
|
||||||
|
.B %{parameter:default}
|
||||||
|
If
|
||||||
|
.B parameter
|
||||||
|
is defined this is susbtituted with the value of it. If not, the default
|
||||||
|
value is substituted. This currently applies only to positional parameters
|
||||||
|
0...9.
|
||||||
|
.LP
|
||||||
|
The following parameters are defined:
|
||||||
|
.LP
|
||||||
|
.TP 8
|
||||||
|
.B 0...9
|
||||||
|
The positional parameters.
|
||||||
|
.TP 8
|
||||||
|
.B U
|
||||||
|
The username (callsign) of the remote station in upper case without the SSID.
|
||||||
|
.TP 8
|
||||||
|
.B u
|
||||||
|
The username (callsign) of the remote station in lower case without the SSID.
|
||||||
|
.TP 8
|
||||||
|
.B S
|
||||||
|
The username (callsign) of the remote station in upper case with the SSID.
|
||||||
|
.TP 8
|
||||||
|
.B s
|
||||||
|
The username (callsign) of the remote station in lower case with the SSID.
|
||||||
|
.TP 8
|
||||||
|
.B P
|
||||||
|
The nodename (callsign) of the remote station (NET/ROM), the portname the
|
||||||
|
user is coming in via (AX.25) or the ip address of the remote host (TCP).
|
||||||
|
In upper case without the SSID.
|
||||||
|
.TP 8
|
||||||
|
.B p
|
||||||
|
The nodename (callsign) of the remote station (NET/ROM), the portname the
|
||||||
|
user is coming in via (AX.25) or the ip address of the remote host (TCP).
|
||||||
|
In lower case without the SSID.
|
||||||
|
.TP 8
|
||||||
|
.B R
|
||||||
|
The nodename (callsign) of the remote station (NET/ROM), the portname the
|
||||||
|
user is coming in via (AX.25) or the ip address of the remote host (TCP).
|
||||||
|
In upper case with the SSID.
|
||||||
|
.TP 8
|
||||||
|
.B r
|
||||||
|
The nodename (callsign) of the remote station (NET/ROM), the portname the
|
||||||
|
user is coming in via (AX.25) or the ip address of the remote host (TCP).
|
||||||
|
In lower case with the SSID.
|
||||||
|
.TP 8
|
||||||
|
.B t
|
||||||
|
The type of the user connection (ax25, netrom, rose, inet, host) in lower case.
|
||||||
|
.TP 8
|
||||||
|
.B T
|
||||||
|
The type of the user connection (ax25, netrom, rose, inet, host) in upper case.
|
||||||
|
.LP
|
||||||
|
Anything else after a % is substituted with a %.
|
||||||
|
.SH FILES
|
||||||
|
.LP
|
||||||
|
/usr/local/etc/ax25/uronode.conf
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
.BR uronode (8),
|
||||||
|
.BR uronode.perms (5),
|
||||||
|
.BR axports (5),
|
||||||
|
.BR ax25 (4).
|
||||||
|
|
@ -0,0 +1,117 @@
|
||||||
|
.TH URONODE.PERMS 5 "28 April 1998" Linux "Linux Programmer's Manual"
|
||||||
|
.SH NAME
|
||||||
|
uronode.perms \- URONode permissions file.
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.LP
|
||||||
|
.B URONode.perms
|
||||||
|
file is read at program startup with the knowledge of users username
|
||||||
|
(call), connection type (AX.25, NET/ROM, ROSE, TCP/IP), peers IP address
|
||||||
|
(for TCP/IP) and port name (for AX.25). The first entry matching this
|
||||||
|
information is taken and user is asked for password and given permissions
|
||||||
|
according to it.
|
||||||
|
.LP
|
||||||
|
The lines within
|
||||||
|
.B uronode.perms
|
||||||
|
must either be a comment line, which starts with a # in the first column, or
|
||||||
|
a permission entry in the following format, each field being delimited by
|
||||||
|
white space:
|
||||||
|
.sp
|
||||||
|
.RS
|
||||||
|
username type portname password permissions
|
||||||
|
.RE
|
||||||
|
.sp
|
||||||
|
The field descriptions are:
|
||||||
|
.sp
|
||||||
|
.TP 14
|
||||||
|
.B username
|
||||||
|
This is matched against users username (call) without SSID. An asterisk
|
||||||
|
(*) matches any username.
|
||||||
|
.TP 14
|
||||||
|
.B type
|
||||||
|
This is matched against the type of the connection to user.
|
||||||
|
Possible values for this field are:
|
||||||
|
.RS 14
|
||||||
|
.TP
|
||||||
|
.B *
|
||||||
|
matches any type of connection.
|
||||||
|
.TP
|
||||||
|
.B ax25
|
||||||
|
matches users coming in with AX.25 and FlexNet.
|
||||||
|
.TP
|
||||||
|
.B netrom
|
||||||
|
matches users coming in with NET/ROM.
|
||||||
|
.TP
|
||||||
|
.B rose
|
||||||
|
matches users coming in with ROSE.
|
||||||
|
.TP
|
||||||
|
.B local
|
||||||
|
matches TCP/IP connections where users host is in "local" network
|
||||||
|
as defined in uronode.conf(5).
|
||||||
|
.TP
|
||||||
|
.B ampr
|
||||||
|
matches TCP/IP connections where users host is in amprnet (44.0.0.0/8).
|
||||||
|
.TP
|
||||||
|
.B inet
|
||||||
|
matches TCP/IP connections where users host is neither in "local"
|
||||||
|
network nor in amprnet.
|
||||||
|
.TP
|
||||||
|
.B host
|
||||||
|
matches users starting URONode from
|
||||||
|
shell.
|
||||||
|
.RE
|
||||||
|
.TP 14
|
||||||
|
.B portname
|
||||||
|
If user is coming in with AX.25 this field is matched against the
|
||||||
|
local port name the user is coming in via. An asterisk (*) matches
|
||||||
|
any port name.
|
||||||
|
.TP 14
|
||||||
|
.B password
|
||||||
|
If the previous three fields match and this field is not a single
|
||||||
|
asterisk (*) the user is asked for a password. The password is
|
||||||
|
then matched against this field.
|
||||||
|
.TP 14
|
||||||
|
.B permissions
|
||||||
|
This field represents a a bitmask of operations the user is permitted
|
||||||
|
to do. It is a sum of the values listed here:
|
||||||
|
.RS 14
|
||||||
|
.TP
|
||||||
|
.B 1
|
||||||
|
permits logging in even if no other permissions are given.
|
||||||
|
.TP
|
||||||
|
.B 2
|
||||||
|
permits outgoing AX.25 and Flexnet connects.
|
||||||
|
.TP
|
||||||
|
.B 4
|
||||||
|
permits outgoing NET/ROM connects.
|
||||||
|
.TP
|
||||||
|
.B 8
|
||||||
|
permits telneting to hosts in the "local" network as defined in
|
||||||
|
uronode.conf(5).
|
||||||
|
.TP
|
||||||
|
.B 16
|
||||||
|
permits telneting to hosts in amprnet.
|
||||||
|
.TP
|
||||||
|
.B 32
|
||||||
|
permits telneting to hosts neither in the "local" network nor in amprnet.
|
||||||
|
.TP
|
||||||
|
.B 64
|
||||||
|
ANSI Color flag. Enable per interface to allow the user to have ANSI color
|
||||||
|
graphics on their terminal. A "*" for the interface will flag color ON for
|
||||||
|
all interfaces for that callsign. Suggested to leave OFF unless requested
|
||||||
|
by the end user... but looks kewl in a shell terminal.
|
||||||
|
.TP
|
||||||
|
.B 128
|
||||||
|
permits outgoing ROSE connects.
|
||||||
|
.TP
|
||||||
|
.B 256
|
||||||
|
The no-escape flag. Disables the escape mechanism for this user.
|
||||||
|
.TP
|
||||||
|
.RE
|
||||||
|
.SH FILES
|
||||||
|
.LP
|
||||||
|
/usr/local/etc/ax25/uronode.perms
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
.BR uronode (8),
|
||||||
|
.BR uronode.conf (5),
|
||||||
|
.BR axports (5),
|
||||||
|
.BR ax25 (4).
|
||||||
|
|
@ -1,5 +1,32 @@
|
||||||
|
Description: Remove CFLAG and LDFlags for hardening, remove installman
|
||||||
|
to stop installation of gzipped manpages, added directory install for
|
||||||
|
SBIN_DIR
|
||||||
|
Author: Dave Hibberd <d@vehibberd.com>
|
||||||
|
---
|
||||||
|
This patch header follows DEP-3: http://dep.debian.net/deps/dep3/
|
||||||
|
|
||||||
--- a/Makefile.in
|
--- a/Makefile.in
|
||||||
+++ b/Makefile.in
|
+++ b/Makefile.in
|
||||||
|
@@ -3,8 +3,8 @@
|
||||||
|
CC = gcc
|
||||||
|
LD = gcc
|
||||||
|
# CFLAGS = -O2 -g -s -Wstrict-prototypes
|
||||||
|
-CFLAGS = -O2 -g -Wno-unused-result -Wstrict-prototypes
|
||||||
|
-LDFLAGS =
|
||||||
|
+#CFLAGS = -O2 -g -Wno-unused-result -Wstrict-prototypes
|
||||||
|
+#LDFLAGS =
|
||||||
|
LIBS = -lax25 -lax25io
|
||||||
|
|
||||||
|
include Makefile.include
|
||||||
|
@@ -24,7 +24,7 @@
|
||||||
|
.c.o:
|
||||||
|
$(CC) $(CFLAGS) -c $<
|
||||||
|
|
||||||
|
-install: installbin installman installhelp installconf
|
||||||
|
+install: installbin installhelp installconf
|
||||||
|
install -m 755 -D -d $(VAR_DIR)
|
||||||
|
install -m 755 -D -d $(VAR_DIR)/node
|
||||||
|
install -m 644 -p etc/loggedin $(VAR_DIR)/node
|
||||||
@@ -33,6 +33,7 @@
|
@@ -33,6 +33,7 @@
|
||||||
install -m 644 -p etc/gateways $(VAR_DIR)/flex
|
install -m 644 -p etc/gateways $(VAR_DIR)/flex
|
||||||
|
|
||||||
|
|
@ -8,3 +35,21 @@
|
||||||
install -m 755 -s -p uronode $(SBIN_DIR)
|
install -m 755 -s -p uronode $(SBIN_DIR)
|
||||||
install -m 755 -s -p nodeusers $(SBIN_DIR)
|
install -m 755 -s -p nodeusers $(SBIN_DIR)
|
||||||
install -m 755 -s -p axdigi $(SBIN_DIR)
|
install -m 755 -s -p axdigi $(SBIN_DIR)
|
||||||
|
@@ -53,16 +54,7 @@
|
||||||
|
install -m 600 -p etc/uronode.routes $(ETC_DIR)
|
||||||
|
install -m 600 -p etc/flexd.conf $(ETC_DIR)
|
||||||
|
|
||||||
|
-installman:
|
||||||
|
- install -m 755 -D -d $(MAN_DIR)/man1 $(MAN_DIR)/man5 $(MAN_DIR)/man8
|
||||||
|
- install -m 644 -p man/nodeusers.1.gz $(MAN_DIR)/man1
|
||||||
|
- install -m 644 -p man/uronode.conf.5.gz $(MAN_DIR)/man5
|
||||||
|
- install -m 644 -p man/uronode.perms.5.gz $(MAN_DIR)/man5
|
||||||
|
- install -m 644 -p man/flexd.conf.5.gz $(MAN_DIR)/man5
|
||||||
|
- install -m 644 -p man/uronode.8.gz $(MAN_DIR)/man8
|
||||||
|
- install -m 644 -p man/axdigi.8.gz $(MAN_DIR)/man8
|
||||||
|
-
|
||||||
|
-upgrade: installman
|
||||||
|
+upgrade:
|
||||||
|
install -m 755 -p uronode $(SBIN_DIR)
|
||||||
|
install -m 755 -p nodeusers $(SBIN_DIR)
|
||||||
|
install -m 755 -p flexd $(SBIN_DIR)
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1 @@
|
||||||
|
debian/manpages/*
|
||||||
Loading…
Reference in New Issue