File: README

package info (click to toggle)
linpac 0.24-3
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 3,764 kB
  • ctags: 2,761
  • sloc: cpp: 17,368; sh: 10,621; ansic: 4,033; makefile: 186; perl: 101
file content (197 lines) | stat: -rw-r--r-- 6,464 bytes parent folder | download | duplicates (2)
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197

LinPac version 0.24 (stable release)
Copyright (c) 2015 by David Ranch (KI6ZHD) 

Linpac is a modular console-oriented packet radio terminal for Linux with a 
built-in messaging client.  Using Linux's native AX.25 network stack, it
can support eight concurrent connected sessions (QSOs) as well as send
UNPROTO packets (UI) to any preconfigured ax25 digi path.  Local messaging 
support is currently fairly simple yet Linpac is designed to relay all
messages to remote BBSes for full messaging if configured.  Linpac "stable"
currently supports an Ncurses-based CLI client but there is also an unstable 
Java-based client/server version with a GUI client that's partially 
operational but needs work.

If you encounter any problems when compiling or using LinPac please go to
http://linpac.sourceforge.net for support.



Current contributors:

  - David Ranch (KI6ZHD)
       Packet radio mail: KI6ZHD@N0ARY.#NCA.CA.USA.NOAM

  - Jerry Dunmire (KA6HLD) - Auto-tools
  - Steven Loomis (K6SPI)  - Misc patches


Many thanks to the original author of Linpac:
Radek Burget OK2JBG ( radkovo@centrum.cz )


QUICK INSTALATION FROM A RELEASE PACKAGE
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Release packages can be identified by the presence of the ./configure in
this directory. If the ./configure script is not present, then see the
'Hacking' instructions below.


  Optional: 
  ---------
  If you plan to use Linpac for recieving and sending your packet mail via a
  remote BBS system (not required), you must install the ax25mail-utils 
  package first before first running Linpac. This package can be found
  at http://ax25mail.sf.net


Before compilation of Linpac, you must have these other packages installed:

  NOTE: Though some distributions offer the AX25 libraries natively in 
        their own repositories, they are usually very old and lack several
        important fixes.  You can read more about these improvements here:

           https://code.google.com/p/linuxax25/wiki/Ax25AppsDiffs


   Dependencies:
   ~~~~~~~~~~~~
   Debian / Ubunutu package names:    libax25 ax25-apps libncurses5-dev
                 Optional install:    ax25-tools ax25-xtools ax25mail-utils

   Centos / Fedora package names:     libax25 ax25apps ncurses-libs
                 Optional install:    ax25tools ax25mail-utils


        I recommend all users install or build the AX.25 stack from 
        this alternative provider for now:

           https://code.google.com/p/linuxax25/source/browse/#svn%2Fdownloads


Once you have installed the above dependencies, please run:

              ./configure

NOTE:  If the "configure" prompt isn't present, you probably got the sources
       from Git. If so, run the following:

              autoreconf --install
              ./configure

       If autoreconf doesn't run, you need to install the Auto-tools:

          Deb-based: 
                         sudo apt-get install automake autoconf

          rpm-based
                         yum install automake autoconf


The default installation destination directory prefix is /usr/local/*.  If you 
want to change this, add the following configuure --prefix switch:

             ./configure --prefix=DIR

where DIR is the new destination directory prefix.
(LinPac installs into PREFIX/bin and PREFIX/share/linpac)

After this just type
    
             make

to compile the package.  At that point, you can install the application a few
ways:

            For Debian/Ubuntu folks:
            --
            Consider using the "checkinstall" tool instead of "make install".  
            This tool must be installed seperately but it will run the 
            equivelent of "make install" but instead, wrap everything into an 
            unofficial .deb file with proper packaging

or
            For rpm based folks:
            --
            Consider using the included contrib/packaging/rpm/linpac.spec
            file with the rpmbuild tool.  This tool must be installed seperately
            but takes care of creating a clean RPM package to install
or

            # The old classic way
            make install
            ldconfig
or
            make install-strip
            ldconfig


One of these options will install Linpac onto your system.  The "install-strip" 
command will also strip the debugging information from the program (the installation 
is then MUCH SMALLER) but harder to report issues to the developer.


ONCE INSTALLED
~~~~~~~~~~~~~~
Once Linpac is installed, you MUST configure the Linux AX.25 system first.
Linpac is only an application that uses a fully functional AX.25 stack.
Please review the various resources on the Internet on how to do this 
such as:

  - Official AX25 HOWTO (old, dated but still useful)
    http://tldp.org/HOWTO/AX25-HOWTO/

  - John Ackermann's pages: 
    http://www.febo.com/packet/linux-ax25/ax25-config.html

  - David Ranch's pages:
    http://www.trinityos.com/HAM/CentosDigitalModes/hampacketizing-centos.html#7.ax25initsetup



KNOWN PROBLEMS
~~~~~~~~~~~~~~
  
  The --enable-LINKSTATIC configuration option does not work.

  Please see the linpac-todo.txt file in this source package as well as see 
  http://linpac.sf.net for actual problems and their solution.


NOTES FOR HACKING with the Source code
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
A clean checkout from the GIT source repository is not ready to configure
and compile. You will need the GNU autotools
(https://en.wikipedia.org/wiki/GNU_build_system) to create the
./configure script and Makfile templates. Once the autotools are
installed the full build procedure is:

    autoreconf --install
    ./configure
    make
    make install

You can make a release package for distribution using:

    make dist

For debugging Linpac, it is useful to run Linpac in the place of compile 
without installing it. For this the command 'make noinstall' can be used. 
This will create the directory structure in the ./src directory. This is 
only available with the staticaly linked applications.


CONFIGURATION OPTIONS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Most of the configuration options are described in the INSTALL file.

[broken at the moment]
  There is one custom option for linpac; --enable-LINKSTATIC.

  The applicatons are linked using the shared library by default (the library
  liblinpac.so is installed in /usr/local/lib). You can link all the
  applications staticaly by running

            configure --enable-LINKSTATIC