forked from MidnightCommander/mc
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.QNX
318 lines (213 loc) · 9.7 KB
/
README.QNX
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
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
Midnight Commander for QNX (not QNX Neutrino)
---------------------------------------------
1. Compiling
2. Running 'mc' under QNX
3. List of modifications on mc-4.1.33
4. TODO
5. Contact information
1. Compiling
------------
1.1 Make utility
----------------
Use 'gmake'. (This is the default 'make' under QNX 4.23+). [The old 'qmake'
cannot handle the makefiles in the mc-source.]
1.2 Configuring
---------------
If you don't have an installed TCP/IP development kit, you have to 'hide'
the library file 'socket3r.lib' (can be installed by e.g. Watcom C 10.6)
in /usr/lib or /usr/watcom/10.6/usr/lib, because the existence of this file
will confuse 'configure': it will erroneously assume you have the complete
TCP/IP development kit (with headers) and will enable compiling of the
network-related VFS code (not only tarfs).
[A patch would be required in the configure-script to check the existence
of the TCP/IP-related headers also...]
Use '--disable-nls' option, if you don't have the binary utilities of
GNU 'gettext' package (e.g. 'msgfmt'). ['--with-included-gettext' doesn't
really work in 4.1.33, there are configuration/compiling problems...]
1.3 Compiler
------------
It is advised to use Watcom C 10.6+ to compile the source, because older
compilers (e.g. 9.52) do not support some convenient/required features.
[e.g. 'ar'-compatible 'wlib',...]
1.4 "No prototype found for '<function>'" warnings
--------------------------------------------------
It is advised to use high warning level (e.g. 'CFLAGS="-w4" ./configure'),
when compiling the source, because Watcom C uses a special parameter passing
convention for functions with fixed number of arguments only. So if the
compiler doesn't see the correct prototype of a function with variable
number of arguments (like printf()), it will produce a warning about the
missing prototype, but generates function call code according to the special
parameter passing convention, not the required CDECL convention (it is used
by default for functions with variable number of arguments). So the calling
convention of the function call code and the function code itself will not
match! So you MUST provide the correct prototype for function with variable
number of arguments! (Or you can force using the stack-based calling
convention as a default, if you have the stack-call-conv version of all of the
required libraries ('<name>3s.lib')...[Watcom C 10.6 required!])
[The latest release version (4.1.33/qnx) is checked against these types of
missing prototypes...]
1.5 Tested configuration
------------------------
QNX 4.24
Watcom C 10.6 (release version, no newer beta patches)
Photon 1.12
no TCP/IP development kit (-> VFS: tarfs only!)
mc-4.1.33, mc-4.1.34
2. Running 'mc' under QNX
-------------------------
Using 'qnx*' terminals:
You cannot use your keyboard correctly, if you disable the "Full 8 bits
input" feature in the 'Options|Display bits...' dialog.
On 'qnx*' terminals 'mc' will run in black and white mode by default,
because these types of terminals use non-ANSI-compatible color sequences.
Accessing remote nodes via the native QNX-network:
[The problem exists under the older versions of 'mc' only...]
If directory panels cannot handle '//<node-id>' prefix in directory names,
use directory links in order to access remote nodes on the native QNX
network:
mkdir /net
ln -sf //1/ /net/1
...
Extension and menu files:
Default 'tar' uses 'stderr' (and not 'stdout' as its 'normal' output with
'-t' option.
Default 'tar' is not a GNU 'tar', so does not understand '-z' option.
Special key-mappings:
Restrictions of the META-? as Alt-? functionality:
[META-? as ESC-? will always work!!!]
Alt-TAB -> Ctrl-TAB (Alt-TAB reserved in Photon [1.12+])
Alt-ENTER -> Ctrl-ENTER ('qnx*' terminals only)
Alt-<uppercase letter>: doesn't work
'qansi*' terminals:
Problem [QNX 4.23+ only]: screen corruption (strange line-drawing character
set handling) on 'qansi*' terminals, if linked with mc/Slang/terminfo
terminal management. (Older versions of QNX and Slang/termcap not affected.)
This problem is solved, see the comments in slang/sldisply.c about
SLTT_TRANSP_ACS_PATCH and QNX_QANSI_SLANG_COMPAT_ACS!
other terminals:
I have tested 'mc' under QNX on 'qnx*' and 'qansi*' terminals only.
toggle panels on/off (CTRL-o):
Currently not supported, but could be implemented later...
3. List of modifications on mc-4.1.33/mc-4.1.34
-----------------------------------------------
edit/
syntax.c: (4.1.33 only, fixed in 4.1.34)
line 100,191: WCC 10.6 doesn't like "<label>: }" construct ("no statement
after the label"), modified to "<label>: /*nop*/; }".
lib/
mc.menu:
'Z' on 'tar.Z' and 'tar.z' files: '%f' -> '$1'.
mc.ext.in.qnx.diff:
QNX: modified 'mc.ext.in'. [tar -t: output to stderr,...]
(No automatic install implemented: patch must be applied before
running 'configure' [->mc.ext.in.qnx.diff!]; this patch can be not
only QNX-specific...)
Makefile.in:
'mc.ext.in.qnx.diff' added to DISTLIB.
slang/
sldisply.c:
SLTT_TRANSP_ACS_PATCH dependent code:
The problem: some terminals (e.g. QNX/qansi*) map the whole upper half of
the ASCII table to the lower half, when alt-char-set is activated with
the smacs/as string-sequence. This means, that if 0 <= ch < 128 written
to the terminal, it will be translated to (ch+128) automatically by the
terminal: so not only the line-drawing characters can be written, when
the alt-char-set is activated. It implicitly means, that space, NL, CR,
etc. characters (exactly: anything besides the "standard" line drawing
characters) cannot be written directly to the terminal, when the
alt-char-set is activated, because writing these characters doesn't cause
an implicit/temporary switching-back to the standard char-set!
The original code in SLang assumes that space, NL, CR, etc. can be
printed when alt-char-set is activated. If SLTT_TRANSP_ACS_PATCH is
defined, the modified code will not use this assumption.
[Remark: the patch-code is not the most exact solution, but works...]
QNX_QANSI_SLANG_COMPAT_ACS_PATCH dependent code:
A more OS/terminal-specific solution for the problem mentioned above
(->SLTT_TRANSP_ACS_PATCH).
If QNX_QANSI_SLANG_COMPAT_ACS is defined, the default smacs/sa, rmacs/ae,
acsc/ac [and sgr/sa, if it would be used!] command sequences will be
replaced internally with the "old style" (pre-QNX 4.23) sequences in case
of QNX/qansi terminals. Using these optional command sequences the terminal
remains compatible with the original SLang code (without using the
workaround-code enabled by defining SLTT_TRANSP_ACS_PATCH).
Remark:
Currently SLTT_TRANSP_ACS_PATCH is not auto-configured by 'configure'.
(Must be manually defined...)
There is some (QNX-specific) auto-configuration hand-coded in the source:
#ifdef SLTT_TRANSP_ACS_PATCH
# if defined(__QNX__) && defined(QNX_QANSI_SLANG_COMPAT_ACS)
# undef SLTT_TRANSP_ACS_PATCH
# endif
#else
# if defined(__QNX__) && !defined(QNX_QANSI_SLANG_COMPAT_ACS)
# define QNX_QANSI_SLANG_COMPAT_ACS 1
# endif
#endif
slutty.c:
"newtty.c_iflag &= ~(ECHO | INLCR | ICRNL);"
ECHO(0x08) is a c_lflag bit, it means PARMRK(0x08) in c_iflag. (!?!)
src/
file.c:
'do_reget' can be extern if (USE_VFS && USE_NETCODE), not if (USE_VFS).
find.c:
search_content():
variable 'i' "must be" 'int', not 'char'. ["i == -1": (buggy?) WCC 10.6
doesn't convert automatically (int)(-1) to (char)(-1) (GCC does), so
"comparison result always 0" warning produced. It is cleaner to define
'i' as 'int', than cast '-1' to 'char', because 'read()' returns 'int'.]
key.c:
init_key():
Call load_xtra_key_defines() and clear 'use_8th_bit_as_meta' by default
under QNX, if a 'qnx*' terminal detected. (A saved config file (mc.ini)
can override it later...)
key.h:
Declare load_xtra_key_defines().
keyxdef.c:
Provides a method to define some platform-specific additional key
mappings. (e.g. QNX terminals can handle most of META-? combinations as
ALT-?...)
(Currently not listed in doc/FILES...)
layout.c:
TIOCGWINSZ must be available (<sys/ioctl.h> included), because window-
resizing code doesn't work, if not defined.
main.c:
print_usage(): reserved name in the QNX run-time library!
print_usage() -> print_mc_usage()
mouse.c:
QNX: ncurses 1.9.8a ported to QNX doesn't provide the 'SP' pointer as a
global symbol in the library, so the keyok() emulation currently cannot
be used under QNX (4.24 & Watcom C 10.6 release version).
slint.c:
QNX: 'qansi*' terminals added to the color_terminals[] list.
subshell.c:
utilunix.c:
QNX: include <unix.h> to get prototype for exec*()!!!
[See README.QNX/Section 1.4!]
Makefile.in:
'keyxdef' module added to SRCS and OBJS.
vfs/
Makefile.in:
'install' target: 'mcserv' not installed, if net-code not enabled
by 'configure'.
<mc-src-root>/
README.QNX:
QNX-specific notes...
configure (line 3369):
configure.in (line 88):
(mc-4.1.34 only)
'test x$CCOPTS = x;' => 'test "x$CCOPTS" = x;'
Makefile.in:
README.QNX added to DISTMAIN.
4. TODO
-------
Because of limited time and resources now I can define a 'wish list' only:
(maybe somebody in the QNX community can help...)
subshell support with panel switch on/off ?
mouse under Photon (with qnxm, qansi-m terminals) ?
...
5. Contact information
----------------------
Please report QNX-specific bugs and comments via e-mail to: [email protected]
-------------
Tamasi Gyorgy
-------------