annotate Source-dirs @ 465:003e48f8ebe1

rvinterf/etmsync/fsnew.c: cast 0 to (char *) for execl sentinel I generally don't use NULL and use plain 0 instead, based on a "NULL considered harmful" discussion on the classiccmp mailing list many aeons ago (I couldn't find it, and I reason that it must have been 2005 or earlier), but a recent complaint by a packager sent me searching, and I found this: https://ewontfix.com/11/ While I don't give a @#$% about "modern" systems and code-nazi tools, I realized that passing a plain 0 as a pointer sentinel in execl is wrong because it will break on systems where pointers are longer than the plain int type. Again, I don't give a @#$% about the abomination of x86_64 and the like, but if anyone ever manages to port my code to something like a PDP-11 (16-bit int, 32-bit long and pointers), then passing a plain 0 as a function argument where a pointer is expected most definitely won't work: if the most natural stack slot and SP alignment unit is 16 bits, fitting an int, with longs and pointers taking up two such slots, then the call stack will be totally wrong with a plain 0 passed for a pointer. Casting the 0 to (char *) ought to be the most kosher solution for the most retro systems possible.
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 11 Feb 2019 00:00:19 +0000
parents 3ec8ef8b2d37
children 026df5681bd3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
434
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 ffstools This directory subtree was originally created to hold the source
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 for our TIFFS In Vitro Analyzer tool, but has since been
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 extended to contain various tools that perform static (or "in
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 vitro") transformations on various bits of data that go into
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 the flash file system on our FreeCalypso GSM devices or are
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 contained in other vendors' flash data structures.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 librftab A library for reading and writing RF parameter tables in our
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 FreeCalypso ASCII format - see doc/RF_tables.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 libserial All of our host programs that operate on serial ports (the way
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 in which we communicate with GSM device targets) go through
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 libserial, i.e., our serial port handling code has been factored
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 out into a common library.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 loadtools fc-loadtool, fc-iram, fc-xram and fc-compalram form the part of
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 FC host tools called loadtools, which used to be its own
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 package.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 fc-buzplay is also built in the loadtools suite because it uses
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 many of the same components.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 miscutil A few miscellaneous utilities are built here.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 ringtools Tools for working with ringtone melodies are built here.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 rvinterf Everything dealing with the RVTMUX interface to running GSM
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 firmwares and everything based on the rvinterf framework is
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 built under rvinterf.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 The tfc139 utility, which logically belongs with loadtools, is
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 built in the rvinterf subtree because it is built from mostly
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 the same source components as rvtdump and rvinterf.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 target-utils The source for loadagent and compalstage lives here, along with
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 a few extra target utilities that are of interest only to
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37 developers.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 toolchain Scripts and patches for building the gcc+binutils toolchain
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 targeting ARM7, the CPU core of the Calypso GSM/GPRS baseband
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 processor. You'll need to build and install this toolchain
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 first before you can build target-utils.
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 uptools The User Phone Tools suite is built here - see
3ec8ef8b2d37 top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45 doc/User-phone-tools.