File: README

package info (click to toggle)
fbb 7.07-2
  • links: PTS
  • area: main
  • in suites: stretch
  • size: 5,052 kB
  • ctags: 6,783
  • sloc: ansic: 87,810; sh: 2,324; makefile: 297
file content (227 lines) | stat: -rw-r--r-- 6,263 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
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227

These are the sources of xfbbd (daemon version for LINUX) and their utilities.

1/ Compiling xfbbd, xfbbC client and its utilities with 2.6 kernel from source:
-------------------------------------------------------------------------------
To compile and install xfbbd you need to run a session as root
for writing privilege reasons.

- cd into fbb-70?? directory

*** If you are building from SVN repository code, you may need to 
*** run "./autogen.sh" first, in order to create the ./configure script.

Enter the command "./configure" to run the configure script.

Optionally, run "./configure --help" to see the various configure
options you can set.

Enter the command "make" to build the source.

Be sure that an FBB daemon is not already running. Then, 

Enter the command "make install".

*** If you are installing for the first time, run "make installconf". 
*** This will install default configuration files.
*** DO NOT run "make installconf" if you are upgrading a working system, 
*** as your configuration files WILL BE overwritten with defaults. 

For the first installation start the BBS software using fbb script
with command:
	fbb
It will check validity of FBB files tree and create missing files including configuration files.

For next BBS start use fbb.sh script. It is in /usr/local/share/doc/fbb/
Make it executable (chmod 755 fbb.sh) and move it somewhere on your system to call 
it automatically on start, or use it manually "fbb.sh start". 

2/ Compiling the xfbbX X11 client from source:
----------------------------------------------
Building the xfbbX client requires the following libraries to be installed:
	libx11-dev (provides -lX11)
	libxt-dev (provides -lXt)
	libxext-dev (provides -lXext)
	libxpm-dev (provides -lXpm)
	lesstif2-dev or libmotif-dev (provides -lXm)

or, the equivalent packages/libraries for your OS.

If the above libraries are available, xfbbX_cl will be built and installed 
automatically (you won't see a warning when running ./configure).

xfbbX is a shell script which creates the resource file and runs xfbbX_cl.

3/ Fixes and evolutions :
-------------------------
Please, do not create new versions of code, this will make us impossible
to maintain and know what is the current version. Instead help us to develop
the code and fix the bugs. All fixes and evolutions will be welcome.

Please again, do not delete the copyright and author headers in the files.

If you didn't do it already, subscribe to the xfbb mailing list by sending a 
email to majordomo@f6fbb.org without title and with "subscribe xfbb" as the 
first line of text.

Then you will be able to send your fix, evolutions proposals and remarks to 
the mailing list.


4/ Running xfbbd :
------------------

Command line options of the fbb script :
----------------------------------------

-f : Software is run in foreground
-h : help information
-q : run silent
-l logfile : log debug info to logfile


Other options given to xfbbd :
------------------------------

-a : monitor all frames
-v : verbose
-i : only check init files
-n : no client (xfbbC, xfbbX or fbbW) interface
-s service : client service name (default none)
-p port_num : client port number (default 3286)


xfbbd exit values :
-------------------

        0 : Error (configuration...)
        1 : Sigterm received
        2 : re-run (no housekeeping)
        3 : housekeeping
        4 : Software stop
        5 : Segv or BusError
        6 : System Reboot asked


Sysop exit commands :
---------------------

        /A : Software stop
        ------------------
        Immediate software exit (value 4)

        /K : Housekeeping
        ---------------------------
        Delayed software exit (value 4)

        /L : Re-run
        ---------------------------
        Delayed software exit (value 2)

        /M : Re-run
        ---------------------------
        Immediate software exit (value 2)

        /R : Reboot
        ---------------------------
        Immediate software exit (value 6)


Scripts :
---------

By default, the script directories are in /usr/local/lib/fbb/script.

When an exit value is received from xfbbd, all executable commands
(scripts or programs) included in the directory are executed
in alphanumeric order.


Script directories (by value) :
-------------------------------

        0 : error_return
        1 : end_session
        2 : rerun
        3 : maintenance
        4 : stop_system
        5 : sig_segv
        6 : reset

5/ fbb folder tree :
--------------------

Special files :
- configuration : /usr/local/etc/ax25/fbb/fbb.conf
- mail import   : /usr/local/var/ax25/fbb/mail/mail.in

binaries :
----------
/usr/local/sbin

configuration tree :
--------------------
/usr/local/etc/ax25/fbb
                       \_ lang

utilities tree :
----------------
/usr/local/lib/fbb
                 |\_ filter
                 |
                 |\_ pg
                 |
                 |\_ script
                 |        |\_ error_return
                 |        |
                 |        |\_ end_session
                 |        |
                 |        |\_ rerun
                 |        |
                 |        |\_ maintenance
                 |        |
                 |        |\_ stop_system
                 |        |
                 |        |\_ sig_segv
                 |        |
                 |         \_ reset
                 |
                 |\_ server
                 |
                  \_ tool

data tree :
-----------
/usr/local/var/ax25/fbb
                      |\_ docs
                      |
                      |\_ log
                      |
                      |\_ oldmail
                      |
                      |\_ sat
                      |
                      |\_ wp
                      |
                      |\_ fbbdos
                      |      \_ yapp
                      |
                      |\_ mail
                      |      \_ mail[0-9]
                      |
                       \_ binmail
                         \_ mail[0-9]


6/ Good luck with "fbb"... 
--------------------------

   Jean-Paul ROUBELAT jpr@f6fbb.org
   6 rue George Sand
   31120 ROQUETTES - France

and since years 2000

 Bernard Pidoux
 f6bvp@free.fr