old-www/HOWTO/AX25-HOWTO/x1374.html

428 lines
6.5 KiB
HTML

<HTML
><HEAD
><TITLE
>Configuring a ROSE port</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 a NET/ROM interface for TCP/IP"
HREF="x1343.html"><LINK
REL="NEXT"
TITLE="Making AX.25/NET/ROM/ROSE calls"
HREF="x1449.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="x1343.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="x1449.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="AEN1374"
>10. Configuring a ROSE port</A
></H1
><P
>The ROSE packet layer protocol is similar to layer three of the X.25
specification. The kernel based ROSE support is a <EM
>modified</EM
> version of the
<A
HREF="http://fpac.lmi.ecp.fr/f1oat/f1oat.html"
TARGET="_top"
>FPAC Rose implementation</A
>.</P
><P
>The ROSE packet layer protocol protocol relies on, and uses the AX.25 ports
you have created. The ROSE protocol rides on top of the AX.25 protocol.
To configure ROSE you must create a configuration file that describes the
ROSE ports you want. You can create multiple ROSE ports if you wish, the same
procedure applies for each.</P
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN1380"
>10.1. Configuring <TT
CLASS="LITERAL"
>/etc/ax25/rsports</TT
></A
></H2
><P
>The file where you configure your ROSE interfaces is the
<TT
CLASS="LITERAL"
>/etc/ax25/rsports</TT
> file. This file describes the ROSE port in much
the same way as the <TT
CLASS="LITERAL"
>/etc/ax25/axports</TT
> file describes the AX.25 ports.</P
><P
>This file is formatted as follows:</P
><P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
>name address description</PRE
></FONT
></TD
></TR
></TABLE
></P
><P
>Where:
<P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>name</DT
><DD
><P
>is the text name that you wish to refer to the port by.</P
></DD
><DT
>address</DT
><DD
><P
>is the 10 digit ROSE address you wish to assign to this port.</P
></DD
><DT
>description</DT
><DD
><P
>is a free text description of the port.</P
></DD
></DL
></DIV
></P
><P
>An example would look something like the following:</P
><P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
>rose 5050294760 Rose Port</PRE
></FONT
></TD
></TR
></TABLE
></P
><P
>Note that ROSE will use the default callsign/ssid configured on each
AX.25 port unless you specify otherwise.</P
><P
>To configure a separate callsign/ssid for ROSE to use on each port you
use the <EM
>rsparms</EM
> command as follows:</P
><P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
># /usr/sbin/rsprams -call VK2KTJ-10</PRE
></FONT
></TD
></TR
></TABLE
></P
><P
>This example would make Linux listen for and use the callsign/ssid
<TT
CLASS="LITERAL"
>VK2KTJ-10</TT
> on all of the configured AX.25 ports for ROSE calls.</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN1413"
>10.2. Creating the ROSE Network device</A
></H2
><P
>When you have created the <TT
CLASS="LITERAL"
>/etc/ax25/rsports</TT
> file
you may create the ROSE device in much the same way as you did for the
AX.25 devices. This time you use the <EM
>rsattach</EM
>
command. The <EM
>rsattach</EM
> command creates network
devices named `<TT
CLASS="LITERAL"
>rose[0-5]</TT
>'. The first time you use
the <EM
>rsattach</EM
> command it create the
`<TT
CLASS="LITERAL"
>rose0</TT
>' device, the second time it creates the
`<TT
CLASS="LITERAL"
>rose1</TT
>' device etc. For example:</P
><P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
># rsattach rose</PRE
></FONT
></TD
></TR
></TABLE
></P
><P
>This command would start the ROSE device (<TT
CLASS="LITERAL"
>rose0</TT
>) configured with the
details specified in the <TT
CLASS="LITERAL"
>/etc/ax25/rsports</TT
> file for the entry
named `<TT
CLASS="LITERAL"
>rose</TT
>'.</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN1429"
>10.3. Configuring ROSE Routing</A
></H2
><P
>The ROSE protocol currently supports only static routing. The <EM
>rsparms</EM
>
utility allows you to configure your ROSE routing table under Linux.</P
><P
>For example:</P
><P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
># rsparms -nodes add 5050295502 radio vk2xlz</PRE
></FONT
></TD
></TR
></TABLE
></P
><P
>would add a route to ROSE node <TT
CLASS="LITERAL"
>5050295502</TT
> via an
AX.25 port named `<TT
CLASS="LITERAL"
>radio</TT
>' in your
<TT
CLASS="LITERAL"
>/etc/ax25/axports</TT
> file to a neighbour with the
callsign <TT
CLASS="LITERAL"
>VK2XLZ</TT
>.</P
><P
>You may specify a route with a mask to capture a number of ROSE destinations
into a single routing entry. The syntax looks like:</P
><P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
># rsparms -nodes add 5050295502/4 radio vk2xlz</PRE
></FONT
></TD
></TR
></TABLE
></P
><P
>which would be identical to the previous example except that it would match
any destination address that matched the first four digits supplied, in this
case any address commencing with the digits <TT
CLASS="LITERAL"
>5050</TT
>. An alternate form
for this command is:</P
><P
><TABLE
BORDER="1"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><FONT
COLOR="#000000"
><PRE
CLASS="SCREEN"
># rsparms -nodes add 5050/4 radio vk2xlz</PRE
></FONT
></TD
></TR
></TABLE
></P
><P
>which is probably the less ambiguous form.</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="x1343.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="x1449.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Configuring a NET/ROM interface for TCP/IP</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Making AX.25/NET/ROM/ROSE calls</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>