Copyright (c) Hyperion Entertainment and contributors.
Difference between revisions of "SDK Developer Tools"
(Removed references to the "pump mode" and SSH, since they don't work on Amiga version.) |
(Added 5 examples) |
||
(310 intermediate revisions by the same user not shown) | |||
Line 2: | Line 2: | ||
The Software Development Kit (SDK) contains a suite of software tools to aid developers in making software for AmigaOS. |
The Software Development Kit (SDK) contains a suite of software tools to aid developers in making software for AmigaOS. |
||
+ | |||
+ | == Tags == |
||
+ | |||
+ | <span style="color: red;">Incomplete description.</span> |
||
+ | |||
+ | {| |
||
+ | | style="padding-left: 12px; padding-right: 12px; padding-top: 1px; padding-bottom: 1px;" | <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Archiving</span> || An archiving tool |
||
+ | |- |
||
+ | | style="padding-left: 12px; padding-right: 12px; padding-top: 1px; padding-bottom: 1px;" | <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Building</span> || A building tool |
||
+ | |- |
||
+ | | style="padding-left: 12px; padding-right: 12px; padding-top: 1px; padding-bottom: 1px;" | <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Code Generation</span> || A source code generator tool |
||
+ | |- |
||
+ | | style="padding-left: 12px; padding-right: 12px; padding-top: 1px; padding-bottom: 1px;" | <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Conversion</span> || A conversion tool |
||
+ | |- |
||
+ | | style="padding-left: 12px; padding-right: 12px; padding-top: 1px; padding-bottom: 1px;" | <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Debugging</span> || A debugging tool |
||
+ | |- |
||
+ | | style="padding-left: 12px; padding-right: 12px; padding-top: 1px; padding-bottom: 1px;" | <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Documenting</span> || A documenting tool |
||
+ | |- |
||
+ | | style="padding-left: 12px; padding-right: 12px; padding-top: 1px; padding-bottom: 1px;" | <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Localization</span> || A localization tool |
||
+ | |- |
||
+ | | style="padding-left: 12px; padding-right: 12px; padding-top: 1px; padding-bottom: 1px;" | <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Optimizing</span> || An optimizing tool |
||
+ | |- |
||
+ | | style="padding-left: 12px; padding-right: 12px; padding-top: 1px; padding-bottom: 1px;" | <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Testing</span> || A testing tool |
||
+ | |- |
||
+ | | style="padding-left: 12px; padding-right: 12px; padding-top: 1px; padding-bottom: 1px;" | <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Versioning</span> || A versioning tool |
||
+ | |} |
||
+ | |||
+ | == Format == |
||
+ | |||
+ | The following lists the characters that indicate the type of argument shown in format listings. Do not use these characters as part of the command. |
||
+ | |||
+ | {| class="wikitable" |
||
+ | | < > || Angle brackets indicate where additional information, such as a file name, must be included. This argument is required if it is not surrounded by square brackets. (For example, [<filename>]; see below.) |
||
+ | |- |
||
+ | | [ ] || Square brackets enclose optional arguments and keywords. Although not required, these arguments and keywords are accepted by the command. |
||
+ | |- |
||
+ | | { } || Braces enclose items that can be given once or repeated any number of times. For example, {<args>} indicates that several items can be given for this argument. |
||
+ | |- |
||
+ | | <nowiki>|</nowiki> || Vertical bars separate lists of options from which you can choose only one. For example, <nowiki>[OPT R|S|RS]</nowiki> indicates a choice of the R option, the S option, or both options. |
||
+ | |- |
||
+ | | <n> || A numeric value is expected by the argument. |
||
+ | |- |
||
+ | | KEYWORD || An upper case keyword indicate that the argument's keyword is required if you include that argument. |
||
+ | |- |
||
+ | | ... || An ellipsis (...) after a string argument indicates that the string must be the final argument on the command line. Including a comment is not allowed. The remainder of the command line is taken as the desired string. Quotation marks are not needed around the string, even if it contains spaces. If you enter quotation marks, they are part of the string. If you specify the keyword, you can put leading and trailing spaces in the string. |
||
+ | |- |
||
+ | | command line indentation || On command lines that are long enough to wrap to the next line, this manual shows the wrapped lines as indented for documentation purposes only. In practice, the wrapped lines align with the first character of the Shell prompt. |
||
+ | |} |
||
= AutoDoc = |
= AutoDoc = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | |||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Documenting</span> |
||
− | AutoDoc extracts and sorts autodocs from the given files and prints them in the standard output. |
+ | AutoDoc extracts and sorts [[Autodoc_Style_Guide|autodocs]] from the given files and prints them in the standard output. |
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
Line 17: | Line 69: | ||
; Template |
; Template |
||
− | : |
+ | : -t <number> -i -o -a -s -C -l <length> -w -c -f -r -F file -I {infile} |
; Location |
; Location |
||
Line 24: | Line 76: | ||
The options are: |
The options are: |
||
{| class="wikitable" |
{| class="wikitable" |
||
+ | ! style="text-align:left;"| Option |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
| {<infile>} || List of files to be processed. |
| {<infile>} || List of files to be processed. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -t<number> || Turn tabulators to given number of spaces. |
| -t<number> || Turn tabulators to given number of spaces. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -i || Process only INTERNAL autodocs. |
| -i || Process only INTERNAL autodocs. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -o || Process only OBSOLETE autodocs. |
| -o || Process only OBSOLETE autodocs. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -a || Do not process autodocs starting with an asterisk. |
| -a || Do not process autodocs starting with an asterisk. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -s || Process autodocs starting with a semicolon. |
| -s || Process autodocs starting with a semicolon. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -C || Process autodocs starting with "/*". This is the default setting. |
| -C || Process autodocs starting with "/*". This is the default setting. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -l<number> || Set the line length for the output. The default is 78. |
| -l<number> || Set the line length for the output. The default is 78. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -w || Turn off word wrapping. |
| -w || Turn off word wrapping. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -c || Do not convert "\*" to "/*" or "*\" to "*/". |
| -c || Do not convert "\*" to "/*" or "*\" to "*/". |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -f || Do not add form feeds between the autodoc entries. |
| -f || Do not add form feeds between the autodoc entries. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -r || Generate Troff source output. |
| -r || Generate Troff source output. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -F<file> || Use <file> as a temporary file. The default temporary file is "tmpfile". |
| -F<file> || Use <file> as a temporary file. The default temporary file is "tmpfile". |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| -I || Do not print "Table of Contents" before entries. If omitted, "Table of Contents" will be printed after the entries. |
| -I || Do not print "Table of Contents" before entries. If omitted, "Table of Contents" will be printed after the entries. |
||
|} |
|} |
||
Line 62: | Line 117: | ||
= BuildLanguageCT = |
= BuildLanguageCT = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | |||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Code Generation</span> <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Localization</span> |
||
This tool generates a catalog translation file (CT file) from the current system language driver. |
This tool generates a catalog translation file (CT file) from the current system language driver. |
||
A new language.catalog can be created with a [[SDK_Developer_Tools#CatComp|CatComp]] tool using the generated CT file and a language catalog descriptor file (located in "SYS:Locale-Source/language.cd"). |
A new language.catalog can be created with a [[SDK_Developer_Tools#CatComp|CatComp]] tool using the generated CT file and a language catalog descriptor file (located in "SYS:Locale-Source/language.cd"). |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
Line 81: | Line 140: | ||
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | ; See also |
||
+ | * [[SDK_Developer_Tools#CatComp|CatComp]] |
||
+ | |||
; Example 1 |
; Example 1 |
||
Line 95: | Line 158: | ||
= BuildMapTable = |
= BuildMapTable = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | |||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Localization</span> |
||
BuildMapTable converts Charset-To-Unicode mapping tables in text form (e.g. available at http://www.unicode.org/Public/MAPPINGS/) to mapping tables in binary form usable by diskfont.library. |
BuildMapTable converts Charset-To-Unicode mapping tables in text form (e.g. available at http://www.unicode.org/Public/MAPPINGS/) to mapping tables in binary form usable by diskfont.library. |
||
Line 108: | Line 174: | ||
; Example |
; Example |
||
<code>0xA4 0x20AC # EURO SIGN</code> |
<code>0xA4 0x20AC # EURO SIGN</code> |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
Line 151: | Line 218: | ||
= BumpRev = |
= BumpRev = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | |||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Code Generation</span> <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Versioning</span> |
||
BumpRev updates version and revision information and makes this available for program code to use it. It generates header file for '''C''' and '''Assembly''' language programs to use. The typical application is to "bump" (i.e. increment) the revision number of a program, library, device, etc. after it has been changed and before it is released. |
BumpRev updates version and revision information and makes this available for program code to use it. It generates header file for '''C''' and '''Assembly''' language programs to use. The typical application is to "bump" (i.e. increment) the revision number of a program, library, device, etc. after it has been changed and before it is released. |
||
Line 165: | Line 235: | ||
Practice '''a.''' has a lot going for it, and it was the preferred default at Commodore when AmigaOS 2.x/3.x were created. |
Practice '''a.''' has a lot going for it, and it was the preferred default at Commodore when AmigaOS 2.x/3.x were created. |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
Line 177: | Line 248: | ||
; Template |
; Template |
||
− | : |
+ | : -q -v <version> -r <revision> -n <name> -b <base name> -d <depend list file> |
− | + | : -e <exclude suffix> -i <include suffix> -D -L <version> <base name> <depend list file> |
|
; Location |
; Location |
||
Line 185: | Line 256: | ||
The options are: |
The options are: |
||
{| class="wikitable" |
{| class="wikitable" |
||
+ | ! style="text-align:left;"| Option |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
| -q || Activate "quiet" operation, i.e. will not print any warning or progress messages, but will print error message. |
| -q || Activate "quiet" operation, i.e. will not print any warning or progress messages, but will print error message. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
− | |- |
||
| -v <version> || Set the version number to use. This must be a number greater than 0. Note that version numbers greater than 255 are unsafe to use for some applications since a "struct Resident" only reserves an unsigned 8-bit integer for storing a version number in it. |
| -v <version> || Set the version number to use. This must be a number greater than 0. Note that version numbers greater than 255 are unsafe to use for some applications since a "struct Resident" only reserves an unsigned 8-bit integer for storing a version number in it. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
− | |- |
||
| -r <revision> || Set the revision number to use rather than let BumpRev read and increment it instead. This must be a number greater than 0. |
| -r <revision> || Set the revision number to use rather than let BumpRev read and increment it instead. This must be a number greater than 0. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
− | |- |
||
| -n <name> || Set the name of the program, library, device, etc. If it is not the same as the base name (see below). This can be useful for software built on systems which do not use a case-insensitive file system |
| -n <name> || Set the name of the program, library, device, etc. If it is not the same as the base name (see below). This can be useful for software built on systems which do not use a case-insensitive file system |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
− | |- |
||
| -b <base name> || Set the base file name all the work and header file names are generated from. This also becomes the name that is written to the files unless you override this with the '''-n''' option (see above). |
| -b <base name> || Set the base file name all the work and header file names are generated from. This also becomes the name that is written to the files unless you override this with the '''-n''' option (see above). |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
− | |- |
||
| -d <depend list file> || A file which contains a list of file names whose modification times should be compared against the modification time of the file which contains the revision number. If any of these files has been modified after the revision number file has a new revision will be created; otherwise BumpRev will exit immediately. There must be one file name per line. Note that if you give "-" as the file name, BumpRev will try to read the file name list from standard input. |
| -d <depend list file> || A file which contains a list of file names whose modification times should be compared against the modification time of the file which contains the revision number. If any of these files has been modified after the revision number file has a new revision will be created; otherwise BumpRev will exit immediately. There must be one file name per line. Note that if you give "-" as the file name, BumpRev will try to read the file name list from standard input. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
− | |- |
||
| -e <exclude suffix> || By default BumpRev generates three header files: one for use with '''C''' and two for use with '''Assembly'''. language The '''C''' header file name ends with ".h" and the two '''Assembly''' language file names end with ".i" and ".s", respectively. You can tell BumpRev not to create all of these files with the '''-e''' option. |
| -e <exclude suffix> || By default BumpRev generates three header files: one for use with '''C''' and two for use with '''Assembly'''. language The '''C''' header file name ends with ".h" and the two '''Assembly''' language file names end with ".i" and ".s", respectively. You can tell BumpRev not to create all of these files with the '''-e''' option. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
− | |- |
||
| -i <include suffix> || This controls which header files should be created, with the default being the ".h", ".i", and ".s" files. The difference between the '''-i''' option and '''-e''' option is that with '''-i''' you say exactly what header files you want, and not what you do not want. |
| -i <include suffix> || This controls which header files should be created, with the default being the ".h", ".i", and ".s" files. The difference between the '''-i''' option and '''-e''' option is that with '''-i''' you say exactly what header files you want, and not what you do not want. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
− | |- |
||
| -D || Add a '''DEVNAME''' definition to the output files. |
| -D || Add a '''DEVNAME''' definition to the output files. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
− | |- |
||
| -L || Add a '''LIBNAME''' definition to the output files. |
| -L || Add a '''LIBNAME''' definition to the output files. |
||
|} |
|} |
||
Line 255: | Line 329: | ||
= CatComp = |
= CatComp = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | |||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Localization</span> |
||
CatComp is a program to handle the creation and maintenance of the message catalogs used by locale.library. Message catalogs are IFF files read by locale.library that contain all the text strings used by an application. By providing several of these catalog files, an application can use locale.library and transparently adapt itself to the user's preferred language. |
CatComp is a program to handle the creation and maintenance of the message catalogs used by locale.library. Message catalogs are IFF files read by locale.library that contain all the text strings used by an application. By providing several of these catalog files, an application can use locale.library and transparently adapt itself to the user's preferred language. |
||
Line 283: | Line 360: | ||
To learn more about CatComp's input and output files, consult CatComp documentation located in the Software Development Kit: '''SDK:Documentation/Tools/Locale/CatComp.doc'''. |
To learn more about CatComp's input and output files, consult CatComp documentation located in the Software Development Kit: '''SDK:Documentation/Tools/Locale/CatComp.doc'''. |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
Line 384: | Line 462: | ||
= ChangeRegs = |
= ChangeRegs = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | |||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Code Generation</span> <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Conversion</span> |
||
<span style="color: red;">Missing description.</span> |
<span style="color: red;">Missing description.</span> |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
Line 419: | Line 501: | ||
= DistCC = |
= DistCC = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | |||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Building</span> |
||
− | DistCC is a program to distribute builds of C or C++ code across several machines on a network. It does not require all machines to share a filesystem, have synchronized clocks, or to have the same libraries or header files installed. They can even have different processors or operating systems |
+ | DistCC is a program to distribute builds of C or C++ code across several machines on a network. It does not require all machines to share a filesystem, have synchronized clocks, or to have the same libraries or header files installed. They can even have different processors or operating systems if cross-compilers are installed. |
− | DistCC is not itself a compiler, but rather a front-end to the GNU C/C++ compiler ( |
+ | DistCC is not itself a compiler, but rather a front-end to the GNU C/C++ compiler ([[SDK_Developer_Tools#GCC|GCC]]), or another compiler of your choice. All the regular GCC options and features work as normal. |
− | For each job, DistCC sends the complete preprocessed source code and compiler arguments across the network from the client to a compilation server. Compilation is driven by a client machine, which is typically the developer's workstation. The DistCC client runs on this machine, as does Make, the preprocessor |
+ | For each job, DistCC sends the complete preprocessed source code and compiler arguments across the network from the client to a [[SDK_Developer_Tools#DistCCD|compilation server]]. Compilation is driven by a client machine, which is typically the developer's workstation. The DistCC client runs on this machine, as does [[SDK_Developer_Tools#Make|Make]], the preprocessor, the linker, and other stages of the build process. Any number of volunteer machines act as compilation servers and help the client to build the program by running the [[SDK_Developer_Tools#DistCCD|DistCCD]] daemon, C compiler and assembler as required. |
− | DistCC runs across TCP sockets (on port 3632 by default). For TCP connections the volunteers must run the |
+ | DistCC runs across TCP sockets (on port 3632 by default). For TCP connections the volunteers must run the [[SDK_Developer_Tools#DistCCD|DistCCD]] daemon directly. |
− | DistCC is intended to be used with GNU Make's '''-j''' option, which runs several compiler processes concurrently. DistCC spreads the jobs across both local and remote CPUs. Because DistCC is able to distribute most of the work across the network, a higher concurrency level can be used than for local builds. As a rule of thumb, the '''-j''' value should be set to about twice the total number of available server CPUs but subject to client limitations. This setting allows for maximal interleaving of tasks being blocked waiting for disk or network IO. |
+ | DistCC is intended to be used with [[SDK_Developer_Tools#GMake|GNU Make]]'s '''-j''' option, which runs several compiler processes concurrently. DistCC spreads the jobs across both local and remote CPUs. Because DistCC is able to distribute most of the work across the network, a higher concurrency level can be used than for local builds. As a rule of thumb, the '''-j''' value should be set to about twice the total number of available server CPUs but subject to client limitations. This setting allows for maximal interleaving of tasks being blocked waiting for disk or network IO. |
It is strongly recommended that you install the same compiler version on all machines participating in a build. Incompatible compilers may cause mysterious compile or link failures. |
It is strongly recommended that you install the same compiler version on all machines participating in a build. Incompatible compilers may cause mysterious compile or link failures. |
||
Line 434: | Line 519: | ||
; Environment Variables |
; Environment Variables |
||
+ | DistCC uses the following environment variables: |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Variable |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | DISTCC_DIR || Path to the host list and locks files. |
||
+ | |- style="vertical-align: top;" |
||
+ | | DISTCC_HOSTS || Name of the host list file. The default name is "hosts". |
||
+ | |- style="vertical-align: top;" |
||
+ | | DISTCC_LOG || Name of the log file. When set, DistCC writes its output to the log. |
||
+ | |- style="vertical-align: top;" |
||
+ | | DISTCC_VERBOSE || Setting this to 1 enables debug messages. |
||
+ | |} |
||
; Server Specification |
; Server Specification |
||
− | A list of servers |
+ | A list of servers will be taken from a file pointed by an environment variable '''$DISTCC_HOSTS''' or '''$DISTCC_DIR/hosts'''. In the file each host can be given in any of these forms: |
{| class="wikitable" |
{| class="wikitable" |
||
+ | ! style="text-align:left;"| Host Address / Command |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
| localhost || Run in place. |
| localhost || Run in place. |
||
+ | |- style="vertical-align: top;" |
||
− | |- |
||
− | | <host> || TCP connection to specified host's port 3632. |
+ | | <host> || TCP connection to a specified host's port 3632. |
+ | |- style="vertical-align: top;" |
||
− | |- |
||
− | | <host>:<port> || TCP connection to specified host's port number <port>. |
+ | | <host>:<port> || TCP connection to a specified host's port number <port>. |
+ | |- style="vertical-align: top;" |
||
− | |- |
||
| --randomize || Randomize the server list before execution. |
| --randomize || Randomize the server list before execution. |
||
|} |
|} |
||
+ | <div style="clear: both"></div> |
||
− | |||
== Tool Types == |
== Tool Types == |
||
Line 458: | Line 559: | ||
; Format |
; Format |
||
− | : DISTCC [--help] [--version] [--show-hosts] [-j] [<compiler> <compiler options>] |
+ | : DISTCC [--help] [--version] [--show-hosts] [-j] [<compiler>] [<compiler options>] |
; Template |
; Template |
||
− | : |
+ | : --help --version --show-hosts -j <compiler> <compiler options> |
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | ; Tutorials |
||
+ | * [https://www.solie.ca/articles/distcc/distcc.html Distributed Compile on AmigaOS] |
||
+ | |||
+ | ; See also |
||
+ | * [[SDK_Developer_Tools#DistCCD|DistCCD]] |
||
+ | * [[SDK_Developer_Tools#GCC|GCC]] |
||
+ | * [[SDK_Developer_Tools#Make_and_GMake|Make]] |
||
+ | |||
The options are: |
The options are: |
||
{| class="wikitable" |
{| class="wikitable" |
||
+ | ! style="text-align:left;"| Option |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
| --help || Explain DistCC usage and exit. |
| --help || Explain DistCC usage and exit. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
− | |- |
||
| --version || Show DistCC version and exit. |
| --version || Show DistCC version and exit. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
− | |- |
||
| --show-hosts || Show host list and exit. |
| --show-hosts || Show host list and exit. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
− | |- |
||
| -j || Calculate the concurrency level from the host list. |
| -j || Calculate the concurrency level from the host list. |
||
|- |
|- |
||
| <compiler> || Compiler to use. Defaults to '''cc'''. |
| <compiler> || Compiler to use. Defaults to '''cc'''. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
− | |- |
||
| <compiler options> || Compiler options. As a minimum, you should supply a list of source files to be compiled. |
| <compiler options> || Compiler options. As a minimum, you should supply a list of source files to be compiled. |
||
|} |
|} |
||
Line 487: | Line 600: | ||
= DistCCD = |
= DistCCD = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Building</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | DistCCD is the server for the [[SDK_Developer_Tools#DistCC|DistCC]] distributed compiler. It accepts and runs compilation jobs for network clients. DistCCD will listen for network connections and fork several child processes to serve them. |
||
+ | |||
+ | ; Environment Variables |
||
+ | |||
+ | DistCCD uses the following environment variables: |
||
+ | |||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Variable |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | DISTCC_CMDLIST || If the environment variable DISTCC_CMDLIST is set, load a list of supported commands from the file named by DISTCC_CMDLIST, and refuse to serve any command whose last DISTCC_CMDLIST_MATCHWORDS last words do not match those of a command in that list. |
||
+ | |- style="vertical-align: top;" |
||
+ | | DISTCC_CMDLIST_NUMWORDS || The number of words, from the end of the command, to match. The default is 1. |
||
+ | |- style="vertical-align: top;" |
||
+ | | DISTCCD_PATH || When starting distccd, if this value is set it will be used unaltered for the command-execution path. The code that normally tries to remove masquerade directories from the path is skipped. |
||
+ | |- style="vertical-align: top;" |
||
+ | | DISTCC_SAVE_TEMPS || If set to 1, temporary files are not deleted after use. |
||
+ | |- style="vertical-align: top;" |
||
+ | | DISTCC_TCP_DEFER_ACCEPT || Turn on the TCP_DEFER_ACCEPT socket option. Defaults to on. |
||
+ | |- style="vertical-align: top;" |
||
+ | | TMPDIR || Directory for temporary files such as preprocessor output. |
||
+ | |} |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
+ | |||
+ | ; Format |
||
+ | : DISTCCD [--help] [--version] [-P=--pid-file <file>] [-N=--nice <level>] [--user <user>] [-j=--jobs <limit>] [--job-lifetime <seconds>] |
||
+ | :: [-p=--port <port>] [--listen <address>] -a=--allow <ip/bits> [--stats] [--stats-port <port>] |
||
+ | :: [--log-level <level>] [--verbose] [--no-detach] [--log-file <file>] [--log-stderr] [--wizard] |
||
+ | :: [--inetd] [--daemon] |
||
+ | |||
+ | ; Template |
||
+ | : --help --version -P=--pid-file <file> -N=--nice <level> --user <user> -j=--jobs <limit> --job-lifetime <seconds> |
||
+ | : -p=--port <port> --listen <address> -a=--allow <ip/bits> --stats --stats-port <port> |
||
+ | : --log-level <level> --verbose --no-detach --log-file <file> --log-stderr --wizard |
||
+ | : --inetd --daemon |
||
+ | |||
+ | ; Location |
||
+ | : SDK:C |
||
+ | |||
+ | ; Tutorials |
||
+ | * [https://www.solie.ca/articles/distcc/distcc.html Distributed Compile on AmigaOS] |
||
+ | |||
+ | ; See also |
||
+ | * [[SDK_Developer_Tools#DistCC|DistCC]] |
||
+ | |||
+ | |||
+ | The options are: |
||
+ | |||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left; white-space: nowrap; width: 180px;" | Option |
||
+ | ! style="text-align:left; white-space: nowrap; width: 120px;" | Type |
||
+ | ! style="text-align:left;" | Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | --help || General || Display usage information and exit. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --version || General || Show version and exit. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -P <file> or<br>--pid-file <file> || General || Save DistCCD process id to file <file>. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -N <niceness> or<br>--nice <level> || General || Makes the DistCCD more nice about giving up the CPU to other tasks on the machine. <niceness> is an increment to the current priority of the process. The range of priorities depends on the operating system but is typically 0 to 20. By default the niceness is increased by 5. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --user <user> || General || Change user to <user>. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -j <limit> or<br>--jobs <limit> || General || Sets a limit on the number of jobs that can be accepted at any time. By default this is set to two greater than the number of CPUs on the machine, to allow for some processes being blocked on network IO. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --job-lifetime <seconds> || General || Kills a DistCCD job if it runs for more than <seconds> seconds. This prevents denial of service from clients that don't properly disconnect and compilers that fail to terminate. By default this is turned off. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -p <port> or<br>--port <port> || Networking || Set the TCP port to listen on, rather than the default of 3632. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --listen <address> || Networking || Instructs DistCCD to listen on the IP address <address>. This can be useful for access control on dual-homed hosts. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -a <ipaddr>[/<mask>] or<br>--allow <ip/bits> || Networking || Instructs DistCCD to accept connections from the IP address <ipaddr>. A CIDR mask length can be supplied optionally after a trailing slash, e.g. 192.168.0.0/24, in which case addresses that match in the most significant <mask> bits will be allowed. This is a mandatory parameter. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --stats || Networking || Turn on the statistics HTTP server. By default it is off. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --stats-port <port> || Networking || Set the TCP port to listen on for HTTP requests, rather than the default of 3633. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --log-level <level> || Debugging || Set the minimum severity of error that will be included in the log file. Useful if you only want to see error messages rather than an entry for each connection. <level> can be '''critical''', '''error''', '''warning''', '''notice''', '''info''', or '''debug'''. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --verbose || Debugging || Include debug messages in log. Equivalent to '''--log-level=debug'''. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --no-detach || Debugging || Do not detach from the shell that started DistCCD. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --log-file <file> || Debugging || Send messages to file <file>. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --log-stderr || Debugging || Send log messages to stderr. This is mainly intended for use in debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --wizard || Debugging || Turn on all options appropriate for starting DistCCD under GNU debugger GDB. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --inetd || Operation Mode || Serve a client connected to stdin/stdout. <span style="color: red;">Note: this option has been disabled.</span> |
||
+ | |- style="vertical-align: top;" |
||
+ | | --daemon || Operation Mode || Run DistCCD in the background. |
||
+ | |} |
||
+ | |||
+ | ; Example |
||
+ | Start the server, allow connections from an IP address 192.168.1.100, and suppress all other messages except error messages. |
||
+ | 1> DistCCD --allow 192.168.1.100 --log-level=error |
||
+ | Pressing <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">Ctrl</kbd> + <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">C</kbd> stops the server. |
||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | DistCCD has no ARexx interface. |
||
= DistCCMon-Amiga = |
= DistCCMon-Amiga = |
||
+ | [[File:Icon-DistCCMon-Amiga.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Building</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | Displays the statuses of the current distributed compilation jobs graphically. |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : DISTCCMON-AMIGA |
||
− | : |
||
; Template |
; Template |
||
− | : |
+ | : (none) |
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | ; Tutorials |
||
+ | * [https://www.solie.ca/articles/distcc/distcc.html Distributed Compile on AmigaOS] |
||
+ | |||
+ | ; See Also |
||
+ | * [[SDK_Developer_Tools#DistCC|DistCC]] |
||
+ | * [[SDK_Developer_Tools#DistCCD|DistCCD]] |
||
+ | * [[SDK_Developer_Tools#DistCCMon-Text|DistCCMon-Text]] |
||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | DistCCMon-Amiga has no ARexx interface. |
||
= DistCCMon-Text = |
= DistCCMon-Text = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Building</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | Displays the statuses of the current distributed compilation jobs. |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : DISTCCMON-TEXT [<delay>] |
||
− | : |
||
; Template |
; Template |
||
− | : |
+ | : <delay> |
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | ; Tutorials |
||
+ | * [https://www.solie.ca/articles/distcc/distcc.html Distributed Compile on AmigaOS] |
||
+ | |||
+ | ; See Also |
||
+ | * [[SDK_Developer_Tools#DistCC|DistCC]] |
||
+ | * [[SDK_Developer_Tools#DistCCD|DistCCD]] |
||
+ | * [[SDK_Developer_Tools#DistCCMon-Amiga|DistCCMon-Amiga]] |
||
+ | |||
+ | |||
+ | When run without parameters, DistCCMon-Text lists the current jobs and exits. If you want to continuously monitor the compilation jobs, supply a job polling delay. For example, to list the jobs in every 3 seconds type |
||
+ | 1> DistCCMon-Text 3 |
||
+ | When you press Enter, DistCCMon-Text keeps listing the jobs until you interrupt it by pressing <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">Ctrl</kbd> + <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">C</kbd>. |
||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | DistCCMon-Text has no ARexx interface. |
||
= Expunge = |
= Expunge = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Debugging</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | Expunge is meant as a software developer tool to force shared libraries and devices to expunge themselves. The ramlib process is responsible for expunging libraries when the corresponding disk file has changed so there should be little need for this command in practice. The caching of system libraries and devices is normal and users should not be using this command. |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : EXPUNGE [{<library or device>}] [PATTERN <pattern>] [ALL] |
||
− | : |
||
; Template |
; Template |
||
+ | : NAME/M,PAT=PATTERN/K,ALL/S |
||
− | : |
||
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | Expunge with no arguments displays the list of devices and libraries along with their open count and flags. This is useful to find out the names of the objects to expunge. |
||
+ | |||
+ | Expunge will attempt to expunge the named shared libraries and/or devices. Since it is not possible to determine whether an expunge succeeds or fails Expunge will always state an object was expunged if it was found. |
||
+ | |||
+ | If PATTERN is specified only libraries and devices matching this pattern will be attempted to be expunged. This pattern may be an arbitrary DOS style pattern. |
||
+ | |||
+ | If the ALL switch is present Expunge will attempt to expunge all the shared libraries and devices with a usage count of zero. Any names specified will be ignored in this case. |
||
+ | |||
+ | If Expunge succeeded, the return code will be set to 0. If Expunge cannot find one or more specified names, it will continue and the return code will be 5. If Expunge fails completely, the return code will be 20. The secondary return code will be set appropriately. |
||
+ | |||
+ | ; Example 1 |
||
+ | Display the current device and library lists. |
||
+ | 1> Expunge |
||
+ | |||
+ | ; Example 2 |
||
+ | Expunge keyboard.device and graphics.library. Since the use count of these objects is greater than 0 nothing will happen but the command will still succeed. This is because there is no return code on the Expunge vector. |
||
+ | 1> Expunge keyboard.device graphics.library |
||
+ | |||
+ | ; Example 3 |
||
+ | Expunge all the devices and libraries it can find. |
||
+ | 1> Expunge ALL |
||
+ | |||
+ | ; Example 4 |
||
+ | Expunge all the unused catalogs and replace the obsolete Avail FLUSH technique. |
||
+ | 1> Expunge locale.library |
||
+ | |||
+ | ; Example 5 |
||
+ | Expunge all libraries whose name is starting with "amiga" (i.e. amigaguide.library or amigaguide.datatype). |
||
+ | 1> Expunge PATTERN amiga#? |
||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | Expunge has no ARexx interface |
||
= FDTrans = |
= FDTrans = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Code Generation</span> <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Conversion</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | FDTrans is a small utility for legacy SFD files. It offers two functions: |
||
+ | <div style="clear: both"></div> |
||
+ | # Convert an SFD file into an XML file for processing with the [[SDK_Developer_Tools#IDLTool|IDLTool]] |
||
+ | # Generate '''68k-to-PPC''' or '''PPC-to-68k''' cross call stubs. These are required to use a 68k Library from PPC code (automatically; implicit emulator calling works too but needs special attention) and to make a PPC library callable for (legacy) 68k programs. |
||
+ | |||
+ | FDTrans requires an SFD file as input. If you only have an FD file, you need to revert it to an SFD file using a tool like FD2Pragma. |
||
+ | |||
+ | {{Note|text=SFD file is a file which contains lines describing a library's entry points.}} |
||
+ | |||
+ | Note that for some SFD files it might be required to do some manual correction. Most notably, there is great commotion about the way that vararg functions are specified. The following format is used throughout because it is the most commonly used format: |
||
+ | |||
+ | <syntaxhighlight lang="c"> |
||
+ | VOID someFunc(ULONG someparam, ULONG Tag1, ...) (D0,A0) |
||
+ | </syntaxhighlight> |
||
+ | |||
+ | Although this prototype doesn't really make sense (vararg functions are not supposed to list the first vararg argument), this is the way that FDTrans expects the functions in the SFD file. If you have a function like |
||
+ | |||
+ | <syntaxhighlight lang="c"> |
||
+ | VOID printf(char *format, ...) (A0,A1) |
||
+ | </syntaxhighlight> |
||
+ | |||
+ | you need to manually add a dummy argument like |
||
+ | |||
+ | : VOID printf(char *format, ULONG dummy, ...) (A0,A1) |
||
+ | |||
+ | For more information on FDTrans, see the developer documentation on migrating old programs and libraries. |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : FDTRANS <sfd file> [-o=--output <outfile>] [-i=--struct <structname>] [-l=--library <libname>] |
||
− | : |
||
+ | :: [-x=--xml] [-s=--stubs] [-c=--c68k] [-cold] [-a=--all] [-6=--68k] [-4=--inline4] [-v=--verbose] |
||
; Template |
; Template |
||
+ | : <sfd file> -o=--output <outfile> -i=--struct <structname> -l=--library <libname> -x=--xml |
||
− | : |
||
+ | : -s=--stubs -c=--c68k -cold -a=--all -6=--68k -4=--inline4 -v=--verbose |
||
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | ; Tutorials |
||
+ | * [[How_to_Build_Stubs_for_68k_Libraries|How to Build Stubs for 68k Libraries]] |
||
+ | |||
+ | ; See Also |
||
+ | * [[SDK_Developer_Tools#IDLTool|IDLTool]] |
||
+ | |||
+ | The options are: |
||
+ | |||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Option |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | <sfd file> || An SFD file to process. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | -o <outfile> or<br>--output <outfile> || Use <outfile> as base for output files. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | -i <structname> or<br>--struct <structname> || Use <structname> as interface name. Guess name by default. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | -l <libname> or<br>--library <libname> || Use <libname> for OpenLibrary. Guess name by default. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | -s=--stubs || Generate the PPC-to-M68k cross-call stubs in C. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | -c=--c68k || Generate the M68k-to-PPC cross-call stubs in C. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | -cold || Generate the M68k-to-PPC cross-call stubs in C but without TRAPTYPENR. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | -a=--all || Generate the PPC-to-M68k and M68k-to-PPC cross-call stubs in C. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | -6=--68k || Generate M68k-to-PPC cross-call stubs in Assembler. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | -4=--inline4 || Generate special inline4 for using M68k libraries without a PPC interface (interface pointer can be NULL). |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | -v=--verbose || Be verbose. |
||
+ | |} |
||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | FDTrans has no ARexx interface. |
||
= FSTest = |
= FSTest = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Debugging</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | FSTest is a tool that checks for problems with a mounted file system on your computer. When executed without parameters, FSTest displays a complete list of the available tests: |
||
+ | <div style="clear: both"></div> |
||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Test Number |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | 1 || Add a notification. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 2 || Change the current mode of a lock. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 3 || Change the file mode. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 4 || Change the current file position. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 5 || Change the size of a file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 6 || Close an open file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 7 || Create a directory. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 8 || Create a hard link. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 9 || Create a soft link. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 10 || Delete a file, directory, or symbolic link. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 11 || Get information on a device. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 12 || Duplicate an existing lock. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 13 || Get a lock on an open file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 14 || Reserved for a ExamineDir() test. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 15 || Examine a file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 16 || Examine a locked file system object. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 17 || Reserved for FileSystemAttr() test. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 18 || Reserved for Flush() test. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 19 || Reserved for Format() test. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 20 || Reserved for GetFilePosition() test. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 21 || Obtain the size of a file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 22 || Inhibit access to a filesystem. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 23 || Lock a directory or a file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 24 || Lock a record (a portion of a file). |
||
+ | |- style="vertical-align: top;" |
||
+ | | 25 || Open a file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 26 || Open a file you have a lock on. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 27 || Obtain the parent directory for a directory or file lock. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 28 || Get a shared lock on the parent directory of a file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 29 || Read data from a file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 30 || Read the target object string for a filesystem soft link. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 31 || Change the volume name. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 32 || Remove notify. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 33 || Rename a file, directory, or symbolic link. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 34 || Reserved for SameFile() test. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 35 || Reserved for SameLock() test. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 36 || Reserved for Serialize() test. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 37 || Change a comment string on a filesystem object. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 38 || Set the modification date for a file or directory. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 39 || Set group for a file or directory. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 40 || Set owner for a file or directory. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 41 || Set protection for a file or directory. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 42 || Unlock a file or directory. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 43 || Unlock a locked record. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 44 || Reserved for VolumeInfoData() test. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 45 || Write data to a file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | 46 || Set a write protection status of a volume. |
||
+ | |} |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : FSTEST <device> [NOINFOMESSAGES] [NOWARNMESSAGES] [NOROOTMESSAGES] [ABORTONERR] |
||
− | : |
||
+ | :: [FIRSTTESTNUMBER <test number>] [LASTTESTNUMBER <test number>] [TESTNUMBER <test number>] |
||
; Template |
; Template |
||
+ | : DEVICE/A,NOINFOMESSAGES=NI/S,NOWARNMESSAGES=NW/S,NOROOTMESSAGES=NR/S, |
||
− | : |
||
+ | : ABORTONERR=AOE/S,FIRSTTESTNUMBER=FTN/K/N,LASTTESTNUMBER=LTN/K/N,TESTNUMBER=TN/K/N |
||
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | The options are: |
||
+ | |||
+ | {| class="wikitable" |
||
+ | | DEVICE || Device to test. |
||
+ | |- |
||
+ | | NOINFOMESSAGES or<br>NI || Do not show additional information on tests. |
||
+ | |- |
||
+ | | NOWARNMESSAGES or<br>NW || Do not show warnings. |
||
+ | |- |
||
+ | | NOROOTMESSAGES or<br>NR || <span style="color: red;">Missing description.</span> |
||
+ | |- |
||
+ | | ABORTONERR or<br>AOE || Stop the execution of the test batch on first error. |
||
+ | |- |
||
+ | | FIRSTTESTNUMBER or<br>FTN || First test to perform. The valid test number is between 1 and 45. |
||
+ | |- |
||
+ | | LASTTESTNUMBER or<br>LTN || Last test to perform. The valid test number is between 1 and 45. |
||
+ | |- |
||
+ | | TESTNUMBER or<br>TN || Perform a single test. The valid test number is between 1 and 45. |
||
+ | |} |
||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | FSTest has no ARexx interface. |
||
= FSVPTool = |
= FSVPTool = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Code Generation</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | FSVPTool generates all the basic stub files required for filesystems to communicate with the version 53 (or newer) DOS library FileSystem Vector-Port interface. |
||
+ | |||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : FSVPTOOL |
||
− | : |
||
; Template |
; Template |
||
− | : |
+ | : (none) |
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | ; Example |
||
+ | Generate a skeleton vector-port filesystem C source files. |
||
+ | 1.RAM Disk:> FSVPTool |
||
+ | Finished, vector port interface files can be found in; RAM:FSVP_Files |
||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | FSVPTool has no ARexx interface. |
||
+ | |||
+ | = GCC = |
||
+ | [[File:LibDrawerIcon.png|left|80px|top]] |
||
+ | |||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Archiving</span> <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Building</span> <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Debugging</span> <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Optimizing</span> <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Testing</span> |
||
+ | |||
+ | The '''SDK:gcc/bin''' directory contains essential tools from the '''GNU Compiler Collection''' and the '''GNU Binutils Binary Tools Collection'''. The command line tools included from the collections are: |
||
+ | <div style="clear: both"></div> |
||
+ | |||
+ | * '''addr2line''' – Converts addresses to filenames and line numbers. |
||
+ | * '''ar''' – A utility for creating and modifying archives, and extracting from archives. |
||
+ | * '''as''' – The GNU assembler. |
||
+ | * '''c++''' – The GNU C++ compiler. |
||
+ | * '''c++filt''' – Decodes mangled (low-level) function names into human readable form. |
||
+ | * '''cpp''' – The GNU C/C++ preprocessor. |
||
+ | * '''g++''' – The GNU C++ compiler, '''c++''' alias. |
||
+ | * '''gcc''' – The GNU C compiler. |
||
+ | * '''gccbug''' – A utility for filing a bug report. |
||
+ | * '''gcov''' – The GNU test coverage program. |
||
+ | * '''gprof''' – The GNU profiler. |
||
+ | * '''ld''' – The GNU linker. |
||
+ | * '''nm''' – Lists symbols from object files. |
||
+ | * '''objcopy''' – Copies and translates object files. |
||
+ | * '''objdump''' – Displays information about object files. |
||
+ | * '''ranlib''' – Generates an index to the contents of an archive and stores it in the archive. |
||
+ | * '''readelf''' – Displays information about any ELF format object file. |
||
+ | * '''size''' – Lists the section sizes of an object or archive file. |
||
+ | * '''strings''' – Lists printable strings from files. |
||
+ | * '''strip''' – Discards symbols. |
||
+ | |||
+ | The full documentation of the listed tools can be found from the [http://gcc.gnu.org/ GCC] and [https://www.gnu.org/software/binutils/ GNU] web sites. |
||
= GDB = |
= GDB = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Debugging</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | GDB is a debugging tool which purpose is to help developers to locate programming errors from their C/C++ programs. With GDB the developer can run and halt their program at will, to monitor and modify the values of the program's internal variables, and even call functions independently of the program's normal behavior. |
||
− | == Tool Types == |
||
+ | In order to be able to debug a program, it has to contain a debugging symbol table. The symbol table maps the machine language instructions to the variables, functions, and lines appearing in the program's source code. The debugging table should be embedded in the program at compilation. For example, when using a [[SDK_Developer_Tools#GCC|GCC]] compiler, option '''-g''' generates and embeds the debug information needed. |
||
− | == Shell Usage == |
||
+ | ; GDB Commands |
||
− | ; Format |
||
− | : |
||
+ | Break and Watch |
||
− | ; Template |
||
+ | {| class="wikitable" |
||
− | : |
||
+ | ! style="text-align:left;"| Command |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | awatch || Set a watchpoint for an expression. |
||
+ | |- style="vertical-align: top;" |
||
+ | | break || Set breakpoint at specified line or function. |
||
+ | |- style="vertical-align: top;" |
||
+ | | catch || Set catchpoints to catch events. |
||
+ | |- style="vertical-align: top;" |
||
+ | | clear || Clear breakpoint at specified line or function. |
||
+ | |- style="vertical-align: top;" |
||
+ | | commands || Set commands to be executed when a breakpoint is hit. |
||
+ | |- style="vertical-align: top;" |
||
+ | | condition || Specify breakpoint to break only if a condition is true. |
||
+ | |- style="vertical-align: top;" |
||
+ | | delete || Delete some breakpoints or auto-display expressions. |
||
+ | |- style="vertical-align: top;" |
||
+ | | disable || Disable some breakpoints. |
||
+ | |- style="vertical-align: top;" |
||
+ | | enable || Enable some breakpoints. |
||
+ | |- style="vertical-align: top;" |
||
+ | | hbreak || Set a hardware assisted breakpoint. |
||
+ | |- style="vertical-align: top;" |
||
+ | | ignore || Set ignore-count of a breakpoint. |
||
+ | |- style="vertical-align: top;" |
||
+ | | rbreak || Set a breakpoint for all functions matching a regular expression. |
||
+ | |- style="vertical-align: top;" |
||
+ | | rwatch || Set a read watchpoint for an expression. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tbreak || Set a temporary breakpoint. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tcatch || Set temporary catchpoints to catch events. |
||
+ | |- style="vertical-align: top;" |
||
+ | | thbreak || Set a temporary hardware assisted breakpoint. |
||
+ | |- style="vertical-align: top;" |
||
+ | | watch || Set a watchpoint for an expression. |
||
+ | |} |
||
+ | Examine Data |
||
− | ; Location |
||
+ | {| class="wikitable" |
||
− | : SDK:C |
||
+ | ! style="text-align:left;"| Command |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | append || Append code or data to a file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | call || Call a function in the program. |
||
+ | |- style="vertical-align: top;" |
||
+ | | delete display || Cancel some expressions to be displayed when the program stops. |
||
+ | |- style="vertical-align: top;" |
||
+ | | delete mem || Delete a memory region. |
||
+ | |- style="vertical-align: top;" |
||
+ | | disable display || Disable some expressions to be displayed when the program stops. |
||
+ | |- style="vertical-align: top;" |
||
+ | | disable mem || Disable a memory region. |
||
+ | |- style="vertical-align: top;" |
||
+ | | disassemble || Disassemble a specified memory section. |
||
+ | |- style="vertical-align: top;" |
||
+ | | display || Print value of an expression each time the program stops. |
||
+ | |- style="vertical-align: top;" |
||
+ | | dump || Dump code or data to a file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | enable display || Enable some expressions to be displayed when the program stops. |
||
+ | |- style="vertical-align: top;" |
||
+ | | enable mem || Enable a memory region. |
||
+ | |- style="vertical-align: top;" |
||
+ | | inspect || Alias to '''print'''. |
||
+ | |- style="vertical-align: top;" |
||
+ | | mem || Define attributes for a memory region. |
||
+ | |- style="vertical-align: top;" |
||
+ | | output || Like '''print''' but do not put value in the value history and do not print newline. |
||
+ | |- style="vertical-align: top;" |
||
+ | | print || Print expression's value. |
||
+ | |- style="vertical-align: top;" |
||
+ | | print-object || Ask an Objective-C to print itself. |
||
+ | |- style="vertical-align: top;" |
||
+ | | printf || Print a formatted string. |
||
+ | |- style="vertical-align: top;" |
||
+ | | ptype || Print definition of a type. |
||
+ | |- style="vertical-align: top;" |
||
+ | | restore || Restore the contents of a file to a memory. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set || Evaluate an expression and assign the result to a variable. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set variable || Evaluate an expression and assign the result to a variable. |
||
+ | |- style="vertical-align: top;" |
||
+ | | undisplay || Cancel some expressions to be displayed when program stops. |
||
+ | |- style="vertical-align: top;" |
||
+ | | whatis || Print data type of an expression. |
||
+ | |- style="vertical-align: top;" |
||
+ | | x || Examine memory. |
||
+ | |} |
||
+ | Examine Files |
||
− | == ARexx Interface == |
||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Command |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | add-shared-symbol-files || Load the symbols from shared object's in the dynamic linker's link map. |
||
+ | |- style="vertical-align: top;" |
||
+ | | add-symbol-file || Add a symbol file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | cd || Change the working directory. |
||
+ | |- style="vertical-align: top;" |
||
+ | | core-file || Select a core dump file for examining the memory and registers. |
||
+ | |- style="vertical-align: top;" |
||
+ | | directory || Add new directory to the beginning of the search path for source files. |
||
+ | |- style="vertical-align: top;" |
||
+ | | edit || Edit file or function. |
||
+ | |- style="vertical-align: top;" |
||
+ | | exec-file || Select program file for getting the contents of a pure memory. |
||
+ | |- style="vertical-align: top;" |
||
+ | | file || Select program file to be debugged. |
||
+ | |- style="vertical-align: top;" |
||
+ | | forward-search || Search for regular expression from the last line listed. |
||
+ | |- style="vertical-align: top;" |
||
+ | | list || List a function or a line. |
||
+ | |- style="vertical-align: top;" |
||
+ | | load || Dynamically load a file into the running program. |
||
+ | |- style="vertical-align: top;" |
||
+ | | path || Add new directory to the beginning of the search path for object files. |
||
+ | |- style="vertical-align: top;" |
||
+ | | pwd || Print the working directory. |
||
+ | |- style="vertical-align: top;" |
||
+ | | reverse-search || Search backward for regular expression from the last line listed. |
||
+ | |- style="vertical-align: top;" |
||
+ | | search || Search regular expression from the last line listed. |
||
+ | |- style="vertical-align: top;" |
||
+ | | section || Change the base address of a section of a file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set extension-language || Set mapping between file name extension and source language. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set gnutarget || Set the current BFD target. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show gnutarget || Show the current BFD target. |
||
+ | |- style="vertical-align: top;" |
||
+ | | symbol-file || Load a symbol table from an executable file. |
||
+ | |} |
||
+ | Maintenance |
||
− | = GMake = |
||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Command |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | flushregs || Force GDB to flush its register cache (maintainer command). |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance || Commands for use by GDB maintainers. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance agent || Translate an expression into remote agent bytecode. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance check-symtabs || Check consistency of psymtabs and symtabs. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance cplus || C++ maintenance commands. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance cplus first_component || Print the first class/namespace component of NAME. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance cplus namespace || Print the list of possible C++ namespaces. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance demangle || Demangle a C++/ObjC mangled name. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance deprecate || Deprecate a command. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance dump-me || Get fatal error; make debugger dump its core. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance info || Commands for showing internal info about the program being debugged. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance info breakpoints || Status of all breakpoints. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance info psymtabs || List the partial symbol tables for all object files. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance info sections || List the BFD sections of the exec and core files. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance info symtabs || List the full symbol tables for all object files. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance internal-error || Give GDB an internal error. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance internal-warning || Give GDB an internal warning. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance packet || Send an arbitrary packet to a remote target. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print || Maintenance command for printing GDB internal state. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print architecture || Print the internal architecture configuration. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print cooked-registers || Print the internal register configuration including cooked values. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print dummy-frames || Print the contents of the internal dummy-frame stack. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print msymbols || Print dump of current minimal symbol definitions. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print objfiles || Print dump of current object file definitions. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print psymbols || Print dump of current partial symbol definitions. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print raw-registers || Print the internal register configuration including raw values. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print reggroups || Print the internal register group names. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print register-groups || Print the internal register configuration including each register's group. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print registers || Print the internal register configuration. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print statistics || Print statistics about internal gdb state. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print symbols || Print dump of current symbol definitions. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance print type || Print a type chain for a given symbol. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance set || Set GDB internal variables used by the GDB maintainer. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance set dwarf2 || Set DWARF 2 specific variables. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance set profile || Set internal profiling. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance show || Show GDB internal variables used by the GDB maintainer. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance show dwarf2 || Show DWARF 2 specific variables. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance show profile || Show internal profiling. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance space || Set the display of space usage. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance time || Set the display of time usage. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance translate-address || Translate a section name and address to a symbol. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance undeprecate || Undeprecate a command. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set archdebug || Set architecture debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set backtrace || Set backtrace specific variables. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set breakpoint || Breakpoint specific settings. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set debug arch || Set architecture debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set debug event || Set event debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set debug expression || Set expression debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set debug frame || Set frame debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set debug observer || Set observer debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set debug serial || Set serial debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set debug target || Set target debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set debugvarobj || Set varobj debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set eventdebug || Set event debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote || Remote protocol specific variables. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set serial || Set default serial/parallel port configuration. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set watchdog || Set watchdog timer. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show archdebug || Show architecture debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show backtrace || Show backtrace specific variables. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show breakpoint || Breakpoint specific settings. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show debug arch || Show architecture debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show debug event || Show event debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show debug expression || Show expression debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show debug frame || Show frame debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show debug observer || Show observer debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show debug serial || Show serial debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show debug target || Show target debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show debugvarobj || Show varobj debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show eventdebug || Show event debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote || Show the remote protocol specific variables. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show serial || Show the default serial/parallel port configuration. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show watchdog || Show a watchdog timer. |
||
+ | |} |
||
+ | Obscure Features |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Command |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | compare-sections || Compare section data on target to the exec file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | complete || List the completions for the rest of the line as a command. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance set dwarf2 max-cache-age || Set the upper bound on the age of cached dwarf2 compilation units. |
||
+ | |- style="vertical-align: top;" |
||
+ | | maintenance show dwarf2 max-cache-age || Show the upper bound on the age of cached dwarf2 compilation units. |
||
+ | |- style="vertical-align: top;" |
||
+ | | monitor || Send a command to the remote monitor (remote targets only). |
||
+ | |- style="vertical-align: top;" |
||
+ | | remote <command> || Send a command to the remote monitor. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set annotate || Set annotation_level. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set backtrace limit || Set an upper bound on the number of backtrace levels. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set backtrace past-main || Set whether backtraces should continue past "main". |
||
+ | |- style="vertical-align: top;" |
||
+ | | set coerce-float-to-double || Set coercion of floats to doubles when calling functions. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set cp-abi || Set the ABI used for inspecting C++ objects. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set download-write-size || Set the write size used when downloading a program. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote P-packet || Set use of remote protocol '''P''' (set-register) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote X-packet || Set use of remote protocol '''X''' (binary-download) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote Z-packet || Set use of remote protocol '''Z''' packets. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote access-watchpoint-packet || Set use of remote protocol '''Z4''' (access-watchpoint) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote binary-download-packet || Set use of remote protocol '''X''' (binary-download) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote fetch-register-packet || Set use of remote protocol '''p''' (fetch-register) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote hardware-breakpoint-packet || Set use of remote protocol '''Z1''' (hardware-breakpoint) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote p-packet || Set use of remote protocol '''p''' (fetch-register) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote read-aux-vector-packet || Set use of remote protocol '''qPart_auxv''' (read-aux-vector) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote read-watchpoint-packet || Set use of remote protocol '''Z3''' (read-watchpoint) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote set-register-packet || Set use of remote protocol '''P''' (set-register) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote software-breakpoint-packet || Set use of remote protocol '''Z0''' (software-breakpoint) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote symbol-lookup-packet || Set use of remote protocol '''qSymbol''' (symbol-lookup) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote verbose-resume-packet || Set use of remote protocol '''vCont''' (verbose-resume) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remote write-watchpoint-packet || Set use of remote protocol '''Z2''' (write-watchpoint) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remoteaddresssize || Set the maximum size of the address (in bits) in a memory packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show annotate || Show annotation_level. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show backtrace limit || Show the upper bound on the number of backtrace levels. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show backtrace past-main || Show whether backtraces should continue past "main". |
||
+ | |- style="vertical-align: top;" |
||
+ | | show coerce-float-to-double || Show coercion of floats to doubles when calling functions. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show cp-abi || Show the ABI used for inspecting C++ objects. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show download-write-size || Show the write size used when downloading a program. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote P-packet || Show current use of remote protocol '''P''' (set-register) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote X-packet || Show current use of remote protocol '''X''' (binary-download) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote Z-packet || Show use of remote protocol '''Z''' packets. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote access-watchpoint-packet || Show current use of remote protocol '''Z4''' (access-watchpoint) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote binary-download-packet || Show current use of remote protocol '''X''' (binary-download) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote fetch-register-packet || Show current use of remote protocol '''p''' (fetch-register) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote hardware-breakpoint-packet || Show current use of remote protocol '''Z1''' (hardware-breakpoint) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote p-packet || Show current use of remote protocol `p' (fetch-register) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote read-aux-vector-packet || Show current use of remote protocol '''qPart_auxv''' (read-aux-vector) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote read-watchpoint-packet || Show current use of remote protocol '''Z3''' (read-watchpoint) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote set-register-packet || Show current use of remote protocol '''P''' (set-register) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote software-breakpoint-packet || Show current use of remote protocol '''Z0''' (software-breakpoint) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote symbol-lookup-packet || Show current use of remote protocol '''qSymbol''' (symbol-lookup) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote verbose-resume-packet || Show current use of remote protocol '''vCont''' (verbose-resume) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remote write-watchpoint-packet || Show current use of remote protocol '''Z2''' (write-watchpoint) packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remoteaddresssize || Show the maximum size of the address (in bits) in a memory packet. |
||
+ | |- style="vertical-align: top;" |
||
+ | | stop || There is no '''stop''' command. |
||
+ | |} |
||
+ | |||
+ | Running the Program |
||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Command |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | advance || Continue the program up to the given location (same form as args for break command). |
||
+ | |- style="vertical-align: top;" |
||
+ | | attach || Attach to a process or file outside of GDB. |
||
+ | |- style="vertical-align: top;" |
||
+ | | continue || Continue program being debugged. |
||
+ | |- style="vertical-align: top;" |
||
+ | | detach || Detach a process or file previously attached. |
||
+ | |- style="vertical-align: top;" |
||
+ | | disconnect || Disconnect from a target. |
||
+ | |- style="vertical-align: top;" |
||
+ | | finish || Execute until selected stack frame returns. |
||
+ | |- style="vertical-align: top;" |
||
+ | | handle || Specify how to handle a signal. |
||
+ | |- style="vertical-align: top;" |
||
+ | | info handle || What debugger does when program gets various signals. |
||
+ | |- style="vertical-align: top;" |
||
+ | | interrupt || Interrupt the execution of the debugged program. |
||
+ | |- style="vertical-align: top;" |
||
+ | | jump || Continue program being debugged at specified line or address. |
||
+ | |- style="vertical-align: top;" |
||
+ | | kill || Kill execution of program being debugged. |
||
+ | |- style="vertical-align: top;" |
||
+ | | next || Step program. |
||
+ | |- style="vertical-align: top;" |
||
+ | | nexti || Step one instruction. |
||
+ | |- style="vertical-align: top;" |
||
+ | | run || Start debugged program. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set args || Set argument list to give program being debugged when it is started. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set environment || Set environment variable value to give the program. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set follow-fork-mode || Set debugger response to a program call of fork or vfork. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set scheduler-locking || Set mode for locking scheduler during execution. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set step-mode || Set mode of the step operation. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show args || Show argument list to give program being debugged when it is started. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show follow-fork-mode || Show debugger response to a program call of fork or vfork. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show scheduler-locking || Show mode for locking scheduler during execution. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show step-mode || Show mode of the step operation. |
||
+ | |- style="vertical-align: top;" |
||
+ | | signal || Continue program giving it signal specified by the argument. |
||
+ | |- style="vertical-align: top;" |
||
+ | | start || Run the debugged program until the beginning of the main procedure. |
||
+ | |- style="vertical-align: top;" |
||
+ | | step || Step program until it reaches a different source line. |
||
+ | |- style="vertical-align: top;" |
||
+ | | stepi || Step one instruction exactly. |
||
+ | |- style="vertical-align: top;" |
||
+ | | target || Connect to a target machine or process. |
||
+ | |- style="vertical-align: top;" |
||
+ | | thread || Use this command to switch between threads. |
||
+ | |- style="vertical-align: top;" |
||
+ | | thread apply || Apply a command to a list of threads. |
||
+ | |- style="vertical-align: top;" |
||
+ | | apply all || Apply a command to all threads. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tty || Set terminal for future runs of program being debugged. |
||
+ | |- style="vertical-align: top;" |
||
+ | | unset environment || Cancel environment variable VAR for the program. |
||
+ | |- style="vertical-align: top;" |
||
+ | | until || Execute until the program reaches a source line greater than the current. |
||
+ | |} |
||
+ | |||
+ | Examine Stack |
||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Command |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | backtrace || Print backtrace of all stack frames. |
||
+ | |- style="vertical-align: top;" |
||
+ | | bt || Alias to '''backtrace'''. |
||
+ | |- style="vertical-align: top;" |
||
+ | | down || Select and print stack frame called by this one. |
||
+ | |- style="vertical-align: top;" |
||
+ | | frame || Select and print a stack frame. |
||
+ | |- style="vertical-align: top;" |
||
+ | | return || Make selected stack frame return to its caller. |
||
+ | |- style="vertical-align: top;" |
||
+ | | select-frame || Slect a stack frame without printing anything. |
||
+ | |- style="vertical-align: top;" |
||
+ | | up || Select and print a stack frame that called this one. |
||
+ | |} |
||
+ | |||
+ | Status Inquiries |
||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Command |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | info || Generic command for showing things about the program being debugged. |
||
+ | |- style="vertical-align: top;" |
||
+ | | info powerpc || Verious PowerPC info specific commands. |
||
+ | |- style="vertical-align: top;" |
||
+ | | macro || Prefix for commands dealing with C preprocessor macros. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show || Generic command for showing things about the debugger. |
||
+ | |} |
||
+ | |||
+ | Support Facilities |
||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Command |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | apropos || Search for commands matching a REGEXP. |
||
+ | |- style="vertical-align: top;" |
||
+ | | define || Define a new command name. |
||
+ | |- style="vertical-align: top;" |
||
+ | | document || Document a user-defined command. |
||
+ | |- style="vertical-align: top;" |
||
+ | | dont-repeat || Don't repeat this command. |
||
+ | |- style="vertical-align: top;" |
||
+ | | down-silently || Same as the '''down''' command. |
||
+ | |- style="vertical-align: top;" |
||
+ | | echo || Print a constant string. |
||
+ | |- style="vertical-align: top;" |
||
+ | | help || Print list of commands. |
||
+ | |- style="vertical-align: top;" |
||
+ | | if || Execute nested commands once IF the conditional expression is non zero. |
||
+ | |- style="vertical-align: top;" |
||
+ | | interpreter-exec || Execute a command in an interpreter. |
||
+ | |- style="vertical-align: top;" |
||
+ | | make || Run the '''Make''' program using the rest of the line as arguments |
||
+ | |- style="vertical-align: top;" |
||
+ | | overlay || Commands for debugging overlays. |
||
+ | |- style="vertical-align: top;" |
||
+ | | overlay auto || Enable automatic overlay debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | overlay list-overlays || List mappings of overlay sections. |
||
+ | |- style="vertical-align: top;" |
||
+ | | overlay load-target || Read the overlay mapping state from the target. |
||
+ | |- style="vertical-align: top;" |
||
+ | | overlay manual || Enable overlay debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | overlay map-overlay || Assert that an overlay section is mapped. |
||
+ | |- style="vertical-align: top;" |
||
+ | | overlay off || Disable overlay debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | overlay unmap-overlay || Assert that an overlay section is unmapped. |
||
+ | |- style="vertical-align: top;" |
||
+ | | quit || Exit GDB. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set architecture || Set architecture of target. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set can-use-hw-watchpoints || Set debugger's willingness to use watchpoint hardware. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set case-sensitive || Set case sensitivity in name search. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set charset || Set the host and target character sets. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set check range || Set range checking. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set check type || Set type checking. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set complaints || Set max number of complaints about incorrect symbols. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set confirm || Set whether to confirm potentially dangerous operations. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set debug-file-directory || Set the directory where separate debug symbols are searched for. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set demangle-style || Set the current C++ demangling style. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set editing || Set editing of command lines as they are typed. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set endian || Set endianness of target. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set exec-done-display || Set notification of completion for asynchronous execution commands. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set height || Set number of lines gdb thinks are in a page. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set history || Generic command for setting command history parameters. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set host-charset || Set the host character set. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set input-radix || Set default input radix for entering numbers. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set language || Set the current source language. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set listsize || Set number of source lines gdb will list by default. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set logging || Set logging options. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set logging file || Set the current logfile. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set logging off || Disable logging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set logging on || Enable logging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set logging overwrite || Set whether logging overwrites or appends to the log file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set logging redirect || Set the logging output mode. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set opaque-type-resolution || Set resolution of opaque struct/class/union types (if set before loading symbols). |
||
+ | |- style="vertical-align: top;" |
||
+ | | set osabi || Set OS ABI of target. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set output-radix || Set default output radix for printing of values. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set overload-resolution || Set overload resolution in evaluating C++ functions. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set pagination || Set state of pagination. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set print address || Set printing of addresses. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set print array || Set prettyprinting of arrays. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set print asm-demangle || Set demangling of C++/ObjC names in disassembly listings. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set print demangle || Set demangling of encoded C++/ObjC names when displaying symbols. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set print object || Set printing of object's derived type based on vtable info. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set print pascal_static-members || Set printing of pascal static members. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set print pretty || Set prettyprinting of structures. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set print sevenbit-strings || Set printing of 8-bit characters in strings as \nnn. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set print static-members || Set printing of C++ static members. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set print union || Set printing of unions interior to structures. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set print vtbl || Set printing of C++ virtual function tables. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set prompt || Set GDB's prompt. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set radix || Set default input and output number radices. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set remotecache || Set cache use for remote targets. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set stop-on-solib-events || Set stopping for shared library events. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set symbol-reloading || Set dynamic symbol table reloading multiple times in one run. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set target-charset || Set the target character set. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set trust-readonly-sections || Set mode for reading from readonly sections. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set verbose || Set verbosity. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set width || Set number of characters gdb thinks are in a line. |
||
+ | |- style="vertical-align: top;" |
||
+ | | set write || Set writing into executable and core files. |
||
+ | |- style="vertical-align: top;" |
||
+ | | shell || Execute the rest of the line as a shell command. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show architecture || Show the current target architecture. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show can-use-hw-watchpoints || Show debugger's willingness to use watchpoint hardware. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show case-sensitive || Show case sensitivity in name search. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show charset || Show the host and target character sets. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show check range || Show range checking. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show check type || Show type checking. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show complaints || Show max number of complaints about incorrect symbols. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show confirm || Show whether to confirm potentially dangerous operations. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show debug-file-directory || Show the directory where separate debug symbols are searched for. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show demangle-style || Show the current C++ demangling style. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show editing || Show editing of command lines as they are typed. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show endian || Show the current byte-order. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show exec-done-display || Show notification of completion for asynchronous execution commands. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show height || Show number of lines gdb thinks are in a page. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show history || Generic command for showing command history parameters. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show host-charset || Show the host character set. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show input-radix || Show default input radix for entering numbers. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show language || Show the current source language. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show listsize || Show number of source lines gdb will list by default. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show logging || Show logging options. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show logging file || Show the current logfile. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show logging overwrite || Show whether logging overwrites or appends to the log file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show logging redirect || Show the logging output mode. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show opaque-type-resolution || Show resolution of opaque struct/class/union types (if set before loading symbols). |
||
+ | |- style="vertical-align: top;" |
||
+ | | show osabi || Show OS/ABI of target. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show output-radix || Show default output radix for printing of values. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show overload-resolution || Show overload resolution in evaluating C++ functions. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show pagination || Show state of pagination. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show print address || Show printing of addresses. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show print array || Show prettyprinting of arrays. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show print asm-demangle || Show demangling of C++/ObjC names in disassembly listings. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show print demangle || Show demangling of encoded C++/ObjC names when displaying symbols. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show print object || Show printing of object's derived type based on vtable info. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show print pascal_static-members || Show printing of pascal static members. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show print pretty || Show prettyprinting of structures. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show print sevenbit-strings || Show printing of 8-bit characters in strings as \nnn. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show print static-members || Show printing of C++ static members. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show print union || Show printing of unions interior to structures. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show print vtbl || Show printing of C++ virtual function tables. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show prompt || Show gdb's prompt. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show radix || Show the default input and output number radices. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show remotecache || Show cache use for remote targets. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show stop-on-solib-events || Show stopping for shared library events. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show symbol-reloading || Show dynamic symbol table reloading multiple times in one run. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show target-charset || Show the target character set. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show trust-readonly-sections || Show mode for reading from readonly sections. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show verbose || Show verbosity. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show width || Show number of characters gdb thinks are in a line. |
||
+ | |- style="vertical-align: top;" |
||
+ | | show write || Show writing into executable and core files. |
||
+ | |- style="vertical-align: top;" |
||
+ | | source || Read commands from a file named FILE. |
||
+ | |- style="vertical-align: top;" |
||
+ | | up-silently || Same as the '''up''' command. |
||
+ | |- style="vertical-align: top;" |
||
+ | | while || Execute nested commands WHILE the conditional expression is non zero. |
||
+ | |} |
||
+ | |||
+ | Tracing |
||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Command |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | actions || Specify the actions to be taken at a tracepoint. |
||
+ | |- style="vertical-align: top;" |
||
+ | | collect || Specify one or more data items to be collected at a tracepoint. |
||
+ | |- style="vertical-align: top;" |
||
+ | | delete tracepoints || Delete specified tracepoints. |
||
+ | |- style="vertical-align: top;" |
||
+ | | disable tracepoints || Disable specified tracepoints. |
||
+ | |- style="vertical-align: top;" |
||
+ | | enable tracepoints || Enable specified tracepoints. |
||
+ | |- style="vertical-align: top;" |
||
+ | | end || Ends a list of commands or actions. |
||
+ | |- style="vertical-align: top;" |
||
+ | | passcount || Set the passcount for a tracepoint. |
||
+ | |- style="vertical-align: top;" |
||
+ | | save-tracepoints || Save current tracepoint definitions as a script. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tdump || Print everything collected at the current tracepoint. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tfind || Select a trace frame. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tfind end || Synonym for '''none'''. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tfind line || Select a trace frame by source line. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tfind none || De-select any trace frame and resume 'live' debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tfind outside || Select a trace frame whose PC is outside the given range. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tfind pc || Select a trace frame by PC. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tfind range || Select a trace frame whose PC is in the given range. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tfind start || Select the first trace frame in the trace buffer. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tfind tracepoint || Select a trace frame by tracepoint number. |
||
+ | |- style="vertical-align: top;" |
||
+ | | trace || Set a tracepoint at a specified line or function or address. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tstart || Start trace data collection. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tstatus || Display the status of the current trace data collection. |
||
+ | |- style="vertical-align: top;" |
||
+ | | tstop || Stop trace data collection. |
||
+ | |- style="vertical-align: top;" |
||
+ | | while-stepping || Specify single-stepping behavior at a tracepoint. |
||
+ | |} |
||
+ | |||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : <span style="color: red;">Missing description.</span> |
||
− | : |
||
; Template |
; Template |
||
+ | : <span style="color: red;">Missing description.</span> |
||
− | : |
||
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | ; Tutorials |
||
+ | * [[GDB_for_Beginners|GDB for Beginners]] |
||
+ | |||
+ | The options are: |
||
+ | |||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Option |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | --args || . |
||
+ | |- style="vertical-align: top;" |
||
+ | | --async || . |
||
+ | |- style="vertical-align: top;" |
||
+ | | --noasync || . |
||
+ | |- style="vertical-align: top;" |
||
+ | | -b <baudrate> || Set serial port baud rate for remote debugging. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --batch || . |
||
+ | |- style="vertical-align: top;" |
||
+ | | --cd <directory> || Change current directory to <directory>. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --command <file> || Execute GDB commands from file <file>. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --core <corefile> || . |
||
+ | |- style="vertical-align: top;" |
||
+ | | --pid <pid> || . |
||
+ | |- style="vertical-align: top;" |
||
+ | | --dbx || DBX compatibility mode. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --directory <directory> || Add directory <directory> to the path to search for source files. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --epoch || Output information for epoch emacs-GDB interface. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --exec <exefile> || Debug file <exefile>. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --fullname || Output information for emacs-GDB interface. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --help || Display this message and exit. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --interpreter <interpreter> || Use the specified interpreter/user interface. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --mapped || Use mapped symbol files. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --nw || Do not use a window interface. See option '''-w'''. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --nx || Do not read ".gdbinit" file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --quiet || Do not print version number on startup. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --readnow || Read the whole symbol table file on first access. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --se <file> || Use file <file> as a symbol table file and as an executable file. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --symbols <symfile> || Read a symbol table from file <symfile>. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --tty <tty> || . |
||
+ | |- style="vertical-align: top;" |
||
+ | | --version || Print GDB version and exit. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -w || Use a window interface. See option '''--nw'''. |
||
+ | |- style="vertical-align: top;" |
||
+ | | --write || . |
||
+ | |- style="vertical-align: top;" |
||
+ | | --xdb || . |
||
+ | |} |
||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | GDB has no ARexx interface. |
||
= GUnZip = |
= GUnZip = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Archiving</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | GUnZip decompresses files created by gzip, zip, compress, compress -H or pack. The detection of the input format is automatic. |
||
+ | |||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : GUNZIP [-c=--stdout] [-d=--decompress] [-f=--force] [-h=--help] [-l=--list] |
||
− | : |
||
+ | : [-L=--license] [-n=--no-name] [-N=--name] [-r=--recursive] [-S=--suffix <suffix>] |
||
+ | : [-t=--test] [-v=--verbose] [-V=--version] [-1=--fast] [-9=--best] {<file>} |
||
; Template |
; Template |
||
+ | : -c=--stdout -d=--decompress -f=--force -h=--help -l=--list -L=--license |
||
− | : |
||
+ | : -n=--no-name -N=--name -r=--recursive -S=--suffix <suffix> -t=--test |
||
+ | : -v=--verbose -V=--version -1=--fast -9=--best <file> |
||
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | The options are: |
||
+ | |||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Option |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | -c or --stdout || Write output on standard output; keep original files unchanged. If there are several input files, the output consists of a sequence of independently compressed members. To obtain better compression, concatenate all input files before compressing them. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -d or --decompress || Decompress |
||
+ | |- style="vertical-align: top;" |
||
+ | | -f or --force || Force overwrite of output file and compress links. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -h or --help || Display a help screen and quit. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -l or --list || List compressed file contents. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -L or --license || Display the gzip license and exit. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -n or --no-name || When compressing, do not save the original file name and timestamp by default. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -N or --name || When compressing, always save the original file name and time stamp; this is the default. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -r or --recursive || Travel the directory structure recursively. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -S or --suffix || When compressing, use the given suffix instead of .gz. Any non-empty suffix can be given, but suffixes other than .z and .gz should be avoided to avoid confusion when files are transferred to other systems. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -t or --test || Check the compressed file integrity. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -v or --verbose || Display the name and percentage reduction for each file compressed or decompressed. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -V or --version || Display the version number. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -1 or --fast || Compress faster. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -9=--best || Compress better. |
||
+ | |} |
||
+ | |||
+ | ; See also |
||
+ | * [[SDK_Developer_Tools#GZip|GZip]] |
||
+ | |||
+ | ; Example 1 |
||
+ | Decompress file myfile.gz to the current directory: |
||
+ | 1> gunzip myfile.gz |
||
+ | |||
+ | ; Example 2 |
||
+ | Decompress files myfile.gz, yourfile.gz, and theirfile.gz to the current directory: |
||
+ | 1> gunzip myfile.gz yourfile.gz theirfile.gz |
||
+ | |||
+ | ; Example 3 |
||
+ | List the contents of a myfile.gz archive: |
||
+ | 1> gunzip -l myfile.gz |
||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | GUnZip has no ARexx interface. |
||
= GZip = |
= GZip = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Archiving</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | Compress or decompress files. |
||
+ | |||
+ | GZIP reduces the size of the named files using Lempel-Ziv coding (LZ77). Whenever possible, each file is replaced by one with the extension .gz, while keeping the same file flags and modification times. If no files are specified, the standard input is compressed to the standard output. |
||
+ | |||
+ | Compressed files can be restored to their original form using GZIP's option -d. |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : GZIP [-c=--stdout] [-d=--decompress] [-f=--force] [-h=--help] [-l=--list] |
||
− | : |
||
+ | : [-L=--license] [-n=--no-name] [-N=--name] [-q=--quiet] [-r=--recursive] |
||
+ | : [-S <suffix>=--suffix <suffix>] [-t=--test] [-v=--verbose] [-V=--version] |
||
+ | : [-1=--fast] [-9=--best] [<file>] |
||
; Template |
; Template |
||
+ | : -c=--stdout -d=--decompress -f=--force -h=--help -l=--list |
||
− | : |
||
+ | : -L=--license -n=--no-name -N=--name -q=--quiet -r=--recursive |
||
+ | : -S <suffix>=--suffix <suffix> -t=--test -v=--verbose -V=--version |
||
+ | : -1=--fast -9=--best {<file>} |
||
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | The options are: |
||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Option |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | -c or<br>--stdout || Write output on standard output; keep original files unchanged. If there are several input files, the output consists of a sequence of independently compressed members. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -d or<br>--decompress || Decompress |
||
+ | |- style="vertical-align: top;" |
||
+ | | -f or<br>--force || Force compression or decompression. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -h or<br>--help || Display a help and quit. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -l or<br>--list || For each compressed file, list the following fields: |
||
+ | '''Compressed size:''' size of the compressed file<br> |
||
+ | '''Uncompressed size:''' size of the uncompressed file<br> |
||
+ | '''Ratio:''' compression ratio (0.0% if unknown)<br> |
||
+ | '''Uncompressed_name:''' name of the uncompressed file<br> |
||
+ | |- style="vertical-align: top;" |
||
+ | | -L or<br>--license || Display the GZIP license and quit.. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -n or<br>--no-name || When compressing, do not save the original file name and timestamp by default. (The original name is always saved if the name had to be truncated.) When decompressing, do not restore the original file name if present (remove only the GZIP suffix from the compressed file name) and do not restore the original timestamp if present (copy it from the compressed file). This option is the default when decompressing. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -N or<br>--name || When compressing, always save the original file name and timestamp; this is the default. When decompressing, restore the original file name and timestamp if present. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -q or<br>--quiet || Suppress all warnings. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -r or<br>--recursive || Travel the directory structure recursively. If any of the file names specified on the command line are directories, GZIP will descend into the directory and compress or decompress (option -d) all the files it finds there. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -S <suffix> or<br>--suffix <suffix> || When compressing, use suffix <suffix> instead of .gz. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -t or<br>--test || Test. Check the compressed file integrity. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -v or<br>--verbose || Verbose. Display the name and percentage reduction for each file compressed or decompressed. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -V or<br>--version || Version. Display the version number and compilation options then quit. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -1 or<br>--fast || Compress faster. |
||
+ | |- style="vertical-align: top;" |
||
+ | | -9 or<br>--best || Compress better. |
||
+ | |- style="vertical-align: top;" |
||
+ | | {<file>} || List of files to be processed. If not given, use standard input. |
||
+ | |} |
||
+ | |||
+ | ; See also |
||
+ | * [[SDK_Developer_Tools#GUnZip|GUnZip]] |
||
+ | |||
+ | ; Example 1 |
||
+ | Compress file ''myfile'' and create file ''myfile.gz''. The original file ''myfile'' will be deleted. |
||
+ | 1> gzip myfile |
||
+ | |||
+ | ; Example 2 |
||
+ | Compress file ''myfile'' to file ''myfile.gz'' and keep the original file ''myfile'': |
||
+ | 1> gzip >myfile.gz -c myfile |
||
+ | |||
+ | ; Example 3 |
||
+ | List compressed file ''myfile.gz'' contents: |
||
+ | 1> gzip -l myfile.gz |
||
+ | compressed uncompr. ratio uncompressed_name |
||
+ | 40 13 -15.3% myfile |
||
+ | |||
+ | ; Example 4 |
||
+ | Decompress compressed file ''myfile.gz''. The original file ''myfile'' will be restored and the compressed file ''myfile.gz'' will be deleted. |
||
+ | 1> gzip -d myfile.gz |
||
+ | |||
+ | ; Example 5 |
||
+ | Decompress file ''myfile.gz'' to file ''myfile'' and keep the ''myfile.gz'' file: |
||
+ | 1> gzip >myfile -c myfile.gz |
||
+ | |||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | GZIP has no ARexx interface. |
||
= IDLTool = |
= IDLTool = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Code Generation</span> <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Conversion</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | IDLTool is a tool that generates a C source code for a bare-bones skeleton library. It reads an XML file, that contains a library description, and outputs the source code files. It can also convert an XML library description file to SFD files. |
||
+ | |||
+ | <span style="color: red;">Incomplete description.</span> |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : <span style="color: red;">Missing description.</span> |
||
− | : |
||
; Template |
; Template |
||
+ | : <span style="color: red;">Missing description.</span> |
||
− | : |
||
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | ; See Also |
||
+ | * [[SDK_Developer_Tools#FDTrans|FDTrans]] |
||
+ | |||
+ | ; Tutorials |
||
+ | * [[How_to_create_an_AmigaOS_4_library|How to create an AmigaOS 4 library]] |
||
== ARexx Interface == |
== ARexx Interface == |
||
= ListDynDep = |
= ListDynDep = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | List shared object dependencies. |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | <span style="color: red;">Incomplete description.</span> |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
Line 725: | Line 2,297: | ||
= Localize = |
= Localize = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Localization</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | Localize is a tool for localizing an application. |
||
+ | |||
+ | <span style="color: red;">Incomplete description.</span> |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
Line 743: | Line 2,321: | ||
== ARexx Interface == |
== ARexx Interface == |
||
− | = Make = |
+ | = Make and GMake = |
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Building</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | Make is a tool that controls the generation of executables and other non source files of a program from the program's source files. |
||
+ | |||
+ | Make uses a file called makefile for instructions on how to build your program. Makefile lists each of the non source files and how to compute them from the project's source files, i.e. which shell commands to call. When you write a program, you should write a makefile for it, so that it is possible to use Make to build and install the program. |
||
+ | |||
+ | Make uses [[AmigaOS_Manual:_AmigaDOS|Amiga Shell]] to execute the shell commands. If you are working on cross-platform projects or porting applications from other platforms, that can be a problem because of the different shell command set and different file path format. For better compatibility, AmigaOS SDK contains a POSIX compliance Make: GMake. GMake is essentially the same tool as Make, except that GMake uses a [https://www.gnu.org/software/bash/ GNU Bash] compatible [[SDK_Developer_Tools#SH|ABC Shell]] to execute commands whereas Make uses Amiga Shell. GMake is ideal for cross-platform projects and porting applications from other platforms since it is Linux/Unix compatible. If you have an Amiga-specific project, use Make instead. |
||
+ | |||
+ | For a complete Make manual, visit the [https://www.gnu.org/software/make/manual/ GNU website]. |
||
+ | |||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : MAKE [-b=-m] [-B=--always-make] [-C=--directory <directory>] [-d] [--debug <flags>] |
||
− | : |
||
+ | :: [-e=--environment-overrides] [-f=--file=--makefile <file>] |
||
+ | :: [-h=--help] [-i=--ignore-errors] [-I=--include-dir <directory>] |
||
+ | :: [-j=--jobs <jobs>] [-k=--keep-going] [-l=--load-average=--max-load <load>] |
||
+ | :: [-L=--check-symlink-times] [-n=--just-print=--dry-run=--recon] |
||
+ | :: [-o=--old-file=--assume-old <file>] [-p=--print-data-base] [-q=--question] |
||
+ | :: [-r=--no-builtin-rules] [-R=--no-builtin-variables] [-s=--silent=--quiet] |
||
+ | :: [-S=--no-keep-going=--stop] [-t=--touch] [-v=--version] [-w=--print-directory] |
||
+ | :: [--no-print-directory] [-W=--what-if=--new-file=--assume-new <file>] |
||
+ | :: [--warn-undefined-variables] |
||
+ | |||
+ | : GMAKE [-b=-m] [-B=--always-make] [-C=--directory <directory>] [-d] [--debug <flags>] |
||
+ | :: [-e=--environment-overrides] [-f=--file=--makefile <file>] |
||
+ | :: [-h=--help] [-i=--ignore-errors] [-I=--include-dir <directory>] |
||
+ | :: [-j=--jobs [<jobs>]] [-k=--keep-going] [-l=--load-average=--max-load <load>] |
||
+ | :: [-L=--check-symlink-times] [-n=--just-print=--dry-run=--recon] |
||
+ | :: [-o=--old-file=--assume-old <file>] [-p=--print-data-base] [-q=--question] |
||
+ | :: [-r=--no-builtin-rules] [-R=--no-builtin-variables] [-s=--silent=--quiet] |
||
+ | :: [-S=--no-keep-going=--stop] [-t=--touch] [-v=--version] [-w=--print-directory] |
||
+ | :: [--no-print-directory] [-W=--what-if=--new-file=--assume-new <file>] |
||
+ | :: [--warn-undefined-variables] |
||
; Template |
; Template |
||
+ | : -b=-m -B=--always-make -C=--directory <directory> -d --debug <flags> |
||
− | : |
||
+ | : -e=--environment-overrides -f=--file=--makefile <file> |
||
+ | : -h=--help -i=--ignore-errors -I=--include-dir <directory> |
||
+ | : -j=--jobs [<jobs>] -k=--keep-going -l=--load-average=--max-load <load> |
||
+ | : -L=--check-symlink-times -n=--just-print=--dry-run=--recon |
||
+ | : -o=--old-file=--assume-old <file> -p=--print-data-base -q=--question |
||
+ | : -r=--no-builtin-rules -R=--no-builtin-variables -s=--silent=--quiet |
||
+ | : -S=--no-keep-going=--stop -t=--touch -v=--version -w=--print-directory |
||
+ | : --no-print-directory -W=--what-if=--new-file=--assume-new <file> |
||
+ | : --warn-undefined-variables |
||
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | ; See Also |
||
+ | * [[SDK_Developer_Tools#DistCC|DistCC]] |
||
+ | * [[SDK_Developer_Tools#SH|ABC Shell]] |
||
+ | |||
+ | The options are: |
||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Option |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | -b or<br>-m || Not used. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -B or<br>--always-make || Consider all targets out-of-date. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -C <directory> or<br>--directory <directory> || Change current working directory to <directory> before reading the makefiles. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -d || Print debugging information in addition to normal processing. The debugging information says which files are being considered for remaking, which file-times are being compared and with what results, which files actually need to be remade, which implicit rules are considered and which are applied—everything interesting about how Make decides what to do. The '''-d''' option is equivalent to '''--debug=a''' (see below). |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | --debug <flags> || Print debugging information in addition to normal processing. Various levels and types of output can be chosen. With no arguments, print the “basic” level of debugging. Possible arguments are below; only the first character is considered, and values must be comma- or space-separated. |
||
+ | |||
+ | {| class="wikitable" |
||
+ | ! style="text-align:left;"| Option |
||
+ | ! style="text-align:left;"| Description |
||
+ | |- style="vertical-align: top;" |
||
+ | | a (all) || All types of debugging output are enabled. This is equivalent to using '''-d'''. |
||
+ | |- style="vertical-align: top;" |
||
+ | | b (basic) || Basic debugging prints each target that was found to be out-of-date, and whether the build was successful or not. |
||
+ | |- style="vertical-align: top;" |
||
+ | | v (verbose) || A level above '''basic'''; includes messages about which makefiles were parsed, prerequisites that did not need to be rebuilt, etc. This option also enables '''basic''' messages. |
||
+ | |- style="vertical-align: top;" |
||
+ | | i (implicit) || Prints messages describing the implicit rule searches for each target. This option also enables '''basic''' messages. |
||
+ | |- style="vertical-align: top;" |
||
+ | | j (jobs) || Prints messages giving details on the invocation of specific sub-commands. |
||
+ | |- style="vertical-align: top;" |
||
+ | | m (makefile) || By default, the above messages are not enabled while trying to remake the makefiles. This option enables messages while rebuilding makefiles, too. Note that the '''all''' option does enable this option. This option also enables '''basic''' messages. |
||
+ | |- style="vertical-align: top;" |
||
+ | | n (none) || Disable all debugging currently enabled. If additional debugging flags are encountered after this they will still take effect. |
||
+ | |} |
||
+ | |||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -e or<br>--environment-overrides || Give variables taken from the environment precedence over variables from makefiles. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -f <file> or<br>--file <file> or<br>--makefile <file> || Read file <file> as a makefile. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -h or<br>--help || Print this message and exit. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -i or<br>--ignore-errors || Ignore command errors. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -I <directory> or<br>--include-dir <directory> || Search directory <directory> for included makefiles. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -j [<jobs>] or<br>--jobs [<jobs>] || Specifies the number of jobs to run simultaneously. With no argument, make runs as many recipes simultaneously as possible. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -k or<br>--keep-going || Continue as much as possible after an error. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -l [<load>] or<br>--load-average [<load>] or<br>--max-load <load> || Do not start multiple jobs unless load is below <load>. With no argument, removes a previous load limit. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -L or<br>--check-symlink-times || This option causes Make to consider the timestamps on any symbolic links in addition to the timestamp on the file referenced by those links. When this option is provided, the most recent timestamp among the file and the symbolic links is taken as the modification time for this target file. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -n or<br>--just-print or<br>--dry-run or<br>--recon || Do not actually run any commands - just print them. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -o <file> or<br>--old-file <file> or<br>--assume-old <file> || Consider file <file> to be very old and do not remake it. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -p or<br>--print-data-base || Print Make's internal database. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -q or<br>--question || "Question mode". Do not run any jobs, or print anything; just return an exit status that is zero if the specified targets are already up to date, one if any remaking is required, or two if an error is encountered. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -r or<br>--no-builtin-rules || Disable the built-in implicit rules. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -R or<br>--no-builtin-variables || Disable the built-in variable settings. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -s or<br>--silent or<br>--quiet || Silent operation. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -S or<br>--no-keep-going or<br>--stop || Cancel the effect of the '''-k''' option. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -t or<br>--touch || Touch files (mark them up to date without really changing them) instead of running their recipes. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -v or<br>--version || Print Make's version number end exit. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -w or<br>--print-directory || Print a message containing the working directory both before and after executing the makefile. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | --no-print-directory || Do not print current directory, even it was enabled (option '''-w'''). |
||
+ | |- style="vertical-align: top; white-space: nowrap;" | style="vertical-align: top;" |
||
+ | | -W <file> or<br>--what-if <file> or<br>--new-file <file> or<br>--assume-new <file> || Pretend that the target file <file> has just been modified. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | --warn-undefined-variables || Issue a warning message whenever Make sees a reference to an undefined variable. |
||
+ | |} |
||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | Make has no ARexx interface. |
||
= MakeAudioMode = |
= MakeAudioMode = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | MakeAudioMode creates audio mode files for AHI. |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | <span style="color: red;">Incomplete description.</span> |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
Line 782: | Line 2,494: | ||
= ModList = |
= ModList = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Debugging</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | ModList lists the currently installed resident modules. |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : MODLIST [SORT] [DEV] |
||
− | : |
||
; Template |
; Template |
||
+ | : SORT/S,DEV/S |
||
− | : |
||
; Location |
; Location |
||
: SDK:C |
: SDK:C |
||
+ | |||
+ | The options are: |
||
+ | |||
+ | {| class="wikitable" |
||
+ | | SORT || List modules sorted alphabetically by their IDs. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | DEV || List modules in the following order: |
||
+ | # RTF_SINGLETASK modules |
||
+ | # RTF_COLDSTART modules |
||
+ | # RTF_AFTERDOS modules |
||
+ | # The rest of the modules |
||
+ | |} |
||
+ | |||
+ | ModList displays the following information on each module: |
||
+ | * Priority |
||
+ | * Memory location |
||
+ | * Version |
||
+ | * ID |
||
+ | * ROM residency |
||
+ | * Module type |
||
+ | * Nativity |
||
+ | * Initialization |
||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | ModList has no ARexx interface. |
||
= SH = |
= SH = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | Amiga Bourne Compatible Shell (ABC Shell). |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | <div style="clear: both"></div> |
||
+ | |||
+ | ; Built-in Commands |
||
+ | |||
+ | {| class="wikitable" |
||
+ | ! Command !! Description |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | . (dot) || Reads a specified file and then executes the commands. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | : (colon) || Expands only arguments. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | break || Exits from the enclosing for, while, until, or select loop, if one exists. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | builtin || Run a shell builtin, passing it '''args''', and return its exit status. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | continue || Resumes the next iteration of the enclosing for, while, until, or select loop. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | eval || Reads the arguments as input to the shell and executes the resulting command or commands. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | exec || Executes the command specified by the '''Argument''' parameter, instead of this shell, without creating a new process. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | exit || Exits the shell whose exit status is specified by the '''n''' parameter. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | return || Causes a shell to return to the invoking script. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | set || Unless options or arguments are specified, writes the names and values of all shell variables in the collation sequence of the current locale. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | shift || Renames positional parameters. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | times || Prints the accumulated user and system times for both the shell and the processes run from the shell. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | trap || Runs a specified command when the shell receives a specified signal or signals. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | wait || |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | read || Reads a line from the standard input and parses it. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | test || Evaluate a conditional expression '''expr''' and return a status of 0 (true) or 1 (false). |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | umask || Set the shell process’s file creation mask to '''mode'''. |
||
+ | |- style="vertical-align: top; white-space: nowrap;" |
||
+ | | unset || Unsets the values and attributes of the specified parameters. |
||
+ | |} |
||
+ | |||
+ | <span style="color: red;">Incomplete description.</span> |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
Line 818: | Line 2,609: | ||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | SH has no ARexx interface. |
||
= TAR = |
= TAR = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Archiving</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | TAR saves many files together into a single tape or disk archive, and can restore individual files from the archive. |
||
+ | |||
+ | <span style="color: red;">Incomplete description.</span> |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
Line 839: | Line 2,638: | ||
= USBSnoop = |
= USBSnoop = |
||
+ | [[File:LibToolIcon.png|left|80px|top]] |
||
+ | '''Tags:''' <span title="Tag" style="display: inline-block; line-height: 1; padding: 7px 10px 7px 10px; border-radius: 6px; outline: 0; margin-left: 1px; margin-right: 1px; margin-top: 7px; margin-bottom: 9px; background: #ff9437; color: #ffffff;">#Debugging</span> |
||
− | <span style="color: red;">Missing description.</span> |
||
+ | |||
+ | USBSnoop is a tool for spying and debugging USB drivers. |
||
+ | |||
+ | <span style="color: red;">Incomplete description.</span> |
||
+ | <div style="clear: both"></div> |
||
+ | |||
+ | [[File:SDKDeveloperToolsFigUSBSnoop.png|frame|left|USBSnoop Window]] |
||
+ | <div style="clear: both"></div> |
||
== Tool Types == |
== Tool Types == |
||
+ | |||
+ | (none) |
||
== Shell Usage == |
== Shell Usage == |
||
; Format |
; Format |
||
+ | : USBSNOOP [ACTIVATE] |
||
− | : |
||
; Template |
; Template |
||
+ | : ACTIVATE/S |
||
− | : |
||
; Location |
; Location |
||
Line 856: | Line 2,666: | ||
== ARexx Interface == |
== ARexx Interface == |
||
+ | |||
+ | USBSnoop has no ARexx interface. |
Latest revision as of 20:39, 30 January 2021
Contents
- 1 Introduction
- 2 AutoDoc
- 3 BuildLanguageCT
- 4 BuildMapTable
- 5 BumpRev
- 6 CatComp
- 7 ChangeRegs
- 8 DistCC
- 9 DistCCD
- 10 DistCCMon-Amiga
- 11 DistCCMon-Text
- 12 Expunge
- 13 FDTrans
- 14 FSTest
- 15 FSVPTool
- 16 GCC
- 17 GDB
- 18 GUnZip
- 19 GZip
- 20 IDLTool
- 21 ListDynDep
- 22 Localize
- 23 Make and GMake
- 24 MakeAudioMode
- 25 ModList
- 26 SH
- 27 TAR
- 28 USBSnoop
Introduction
The Software Development Kit (SDK) contains a suite of software tools to aid developers in making software for AmigaOS.
Tags
Incomplete description.
#Archiving | An archiving tool |
#Building | A building tool |
#Code Generation | A source code generator tool |
#Conversion | A conversion tool |
#Debugging | A debugging tool |
#Documenting | A documenting tool |
#Localization | A localization tool |
#Optimizing | An optimizing tool |
#Testing | A testing tool |
#Versioning | A versioning tool |
Format
The following lists the characters that indicate the type of argument shown in format listings. Do not use these characters as part of the command.
< > | Angle brackets indicate where additional information, such as a file name, must be included. This argument is required if it is not surrounded by square brackets. (For example, [<filename>]; see below.) |
[ ] | Square brackets enclose optional arguments and keywords. Although not required, these arguments and keywords are accepted by the command. |
{ } | Braces enclose items that can be given once or repeated any number of times. For example, {<args>} indicates that several items can be given for this argument. |
| | Vertical bars separate lists of options from which you can choose only one. For example, [OPT R|S|RS] indicates a choice of the R option, the S option, or both options. |
<n> | A numeric value is expected by the argument. |
KEYWORD | An upper case keyword indicate that the argument's keyword is required if you include that argument. |
... | An ellipsis (...) after a string argument indicates that the string must be the final argument on the command line. Including a comment is not allowed. The remainder of the command line is taken as the desired string. Quotation marks are not needed around the string, even if it contains spaces. If you enter quotation marks, they are part of the string. If you specify the keyword, you can put leading and trailing spaces in the string. |
command line indentation | On command lines that are long enough to wrap to the next line, this manual shows the wrapped lines as indented for documentation purposes only. In practice, the wrapped lines align with the first character of the Shell prompt. |
AutoDoc
Tags: #Documenting
AutoDoc extracts and sorts autodocs from the given files and prints them in the standard output.
Tool Types
(none)
Shell Usage
- Format
- AUTODOC [-t <number>] [-i] [-o] [-a] [-s] [-C] [-l <length>] [-w] [-c] [-f] [-r] [-F <file>] [-I] {<infile>}
- Template
- -t <number> -i -o -a -s -C -l <length> -w -c -f -r -F file -I {infile}
- Location
- SDK:C
The options are:
Option | Description |
---|---|
{<infile>} | List of files to be processed. |
-t<number> | Turn tabulators to given number of spaces. |
-i | Process only INTERNAL autodocs. |
-o | Process only OBSOLETE autodocs. |
-a | Do not process autodocs starting with an asterisk. |
-s | Process autodocs starting with a semicolon. |
-C | Process autodocs starting with "/*". This is the default setting. |
-l<number> | Set the line length for the output. The default is 78. |
-w | Turn off word wrapping. |
-c | Do not convert "\*" to "/*" or "*\" to "*/". |
-f | Do not add form feeds between the autodoc entries. |
-r | Generate Troff source output. |
-F<file> | Use <file> as a temporary file. The default temporary file is "tmpfile". |
-I | Do not print "Table of Contents" before entries. If omitted, "Table of Contents" will be printed after the entries. |
- Example
Extract autodocs from files "main.c" and "functions.h" and redirect AutoDoc's output to file "MyDocs.doc".
1> autodoc -a -C main.c functions.h >MyDocs.doc
ARexx Interface
AutoDoc has no ARexx interface.
BuildLanguageCT
Tags: #Code Generation #Localization
This tool generates a catalog translation file (CT file) from the current system language driver.
A new language.catalog can be created with a CatComp tool using the generated CT file and a language catalog descriptor file (located in "SYS:Locale-Source/language.cd").
Tool Types
(none)
Shell Usage
- Format
- BUILDLANGUAGECT
- Template
- (none)
- Location
- SDK:C
- See also
- Example 1
List the current language driver strings.
1> BuildLanguageCT
- Example 2
Create a "language.ct" file with the built-in strings of the current system language driver.
1> BuildLanguageCT >language.ct
ARexx Interface
BuildLanguageCT has no ARexx interface.
BuildMapTable
Tags: #Localization
BuildMapTable converts Charset-To-Unicode mapping tables in text form (e.g. available at http://www.unicode.org/Public/MAPPINGS/) to mapping tables in binary form usable by diskfont.library.
BuildMapTable can either display a text form of the parsed table or create a binary mapping table in the "L:Charsets/" directory. Currently only 8-bit character set mapping tables are supported.
If "L:Charsets/character-sets" or "L:Charsets/custom-character-sets" contains a MIME name for an 8-bit character set where no mapping table in "L:Charsets/" does not exist, and you have a mapping table in text form, use BuildMapTable to create the binary mapping table and reboot (diskfont.library searches tables only once) to be able to use the new character set (e.g. in fonts or catalog files).
The expected format of text mapping tables is as follows:
- Anything from a '#' character to the end of a line is considered a comment.
- A valid line does contain the index on the left and the Unicode point at the right side, in either hexadecimal (starting with 0x or 0X) or octal (starting with 0) or decimal form, separated by empty space.
- Example
0xA4 0x20AC # EURO SIGN
Tool Types
(none)
Shell Usage
- Format
- BUILDMAPTABLE <ASCII mapping table> [CHARSET]
- Template
- UNICODEMAPTABLE/A,CHARSET/K
- Location
- SDK:C
The parameters are:
UNICODEMAPTABLE | A character set mapping table file. |
CHARSET | A MIME character set name or alias. |
The UNICODEMAPTABLE parameter specifies a character set mapping table file to be read and the CHARSET parameter the binary mapping table file to be written.
The MIME character set name obtained from diskfont.library will be used as file name of the binary character set mapping table which will be stored in "L:Charsets/". If the CHARSET parameter is omitted, no file will be written, instead the resulting mapping table is displayed in text form.
- Example 1
Parse a text file "CP1258.TXT" and display a list of entries with the index on the left and the Unicode codepoint at the right side.
1> BuildMapTable CP1258.TXT
Note: unmapped entries (with Unicode codepoint 0) are not displayed.
- Example 2
Parse a text file "8859-1.TXT" and create a file "L:Charsets/ISO-8859-1" (latin1 is an alias for ISO-8859-1).
1> BuildMapTable 8859-1.TXT CHARSET LATIN1
ARexx Interface
BuildMapTable has no ARexx interface.
BumpRev
Tags: #Code Generation #Versioning
BumpRev updates version and revision information and makes this available for program code to use it. It generates header file for C and Assembly language programs to use. The typical application is to "bump" (i.e. increment) the revision number of a program, library, device, etc. after it has been changed and before it is released.
There are two common practices to use BumpRev:
- Update the revision number whenever the software is rebuilt
- Update the revision number only when a new release is created
The advantage of a. is that you can integrate it into your built process, and you won't ever forget to bump a revision number when something has changed. The disadvantage is that revision numbers can increase very quickly (do not worry: you have 65535 revisions to spare).
The advantage of b. is that it saves revision numbers (which can become scarce), but the disadvantage is that you might forget to bump a revision number before you rebuilt a new release.
Practice a. has a lot going for it, and it was the preferred default at Commodore when AmigaOS 2.x/3.x were created.
Tool Types
(none)
Shell Usage
- Format
- BUMPREV [-q] [-v <version>] [-r <revision>] [-n <name>] [-b <base name>] [-d <depend list file>]
- [-e <exclude suffix>] [-i <include suffix>] [-D] [-L] [<version> <base name> [<depend list file>]]
- Template
- -q -v <version> -r <revision> -n <name> -b <base name> -d <depend list file>
- -e <exclude suffix> -i <include suffix> -D -L <version> <base name> <depend list file>
- Location
- SDK:C
The options are:
Option | Description |
---|---|
-q | Activate "quiet" operation, i.e. will not print any warning or progress messages, but will print error message. |
-v <version> | Set the version number to use. This must be a number greater than 0. Note that version numbers greater than 255 are unsafe to use for some applications since a "struct Resident" only reserves an unsigned 8-bit integer for storing a version number in it. |
-r <revision> | Set the revision number to use rather than let BumpRev read and increment it instead. This must be a number greater than 0. |
-n <name> | Set the name of the program, library, device, etc. If it is not the same as the base name (see below). This can be useful for software built on systems which do not use a case-insensitive file system |
-b <base name> | Set the base file name all the work and header file names are generated from. This also becomes the name that is written to the files unless you override this with the -n option (see above). |
-d <depend list file> | A file which contains a list of file names whose modification times should be compared against the modification time of the file which contains the revision number. If any of these files has been modified after the revision number file has a new revision will be created; otherwise BumpRev will exit immediately. There must be one file name per line. Note that if you give "-" as the file name, BumpRev will try to read the file name list from standard input. |
-e <exclude suffix> | By default BumpRev generates three header files: one for use with C and two for use with Assembly. language The C header file name ends with ".h" and the two Assembly language file names end with ".i" and ".s", respectively. You can tell BumpRev not to create all of these files with the -e option. |
-i <include suffix> | This controls which header files should be created, with the default being the ".h", ".i", and ".s" files. The difference between the -i option and -e option is that with -i you say exactly what header files you want, and not what you do not want. |
-D | Add a DEVNAME definition to the output files. |
-L | Add a LIBNAME definition to the output files. |
You can specify the base name, the version number and the dependencies file name both using options and as regular parameters. But you do not need to specify both. For example, the following commands are equivalent:
BumpRev -b foo 1 BumpRev 1 foo BumpRev -v 1 foo BumpRev -v 1 -b foo
The following commands are equivalent, too:
BumpRev 1 bar dependencies_file BumpRev -b bar 1 dependencies_file BumpRev -v 1 -d dependencies_file bar BumpRev -v 1 -b bar dependencies_file
- Example 1
Create or update a revision file "foo_rev.rev" unless it already exists, and create three more header files: "foo_rev.h", "foo_rev.1", and "foo_rev.s".
1> BumpRev 1 foo BumpRev: Creating new file "foo_rev.rev" BumpRev: Bumped "foo" to version 1.1.
If you invoke BumpRev with the same parameters again, the revision file will be updated, incrementing the revision number. The three header files will be updated, too.
1> BumpRev 1 foo BumpRev: Bumped "foo" to version 1.2.
- Example 2
The name you give BumpRev goes into the names of the header files, and it also becomes the name printed in each string. This can be overridden with the -n option.
1> BumpRev -n Bar 1 bar BumpRev: Creating new file "bar_rev.rev". BumpRev: Bumped "Bar" to version 1.1.
The resulting files still use the same base name, but the names printed in the files are different.
bar_rev.h
#define VERSION 1 #define REVISION 1 #define DATE "15.6.2020" #define VERS "Bar 1.1" #define VSTRING "Bar 1.1 (15.6.2020)\r\n" #define VERSTAG "\0$VER: Bar 1.1 (15.6.2020)"
- Example 3
BumpRev defaults to create three header files, but at times there may be only one you need. To create just the C language header file, you would use the -e option like this:
1> BumpRev -e si 1 baz
This would create only "baz_rev.h" and omit "baz_rev.i" and "baz_rev.s".
ARexx Interface
BumpRev has no ARexx interface.
CatComp
Tags: #Localization
CatComp is a program to handle the creation and maintenance of the message catalogs used by locale.library. Message catalogs are IFF files read by locale.library that contain all the text strings used by an application. By providing several of these catalog files, an application can use locale.library and transparently adapt itself to the user's preferred language.
CatComp reads and processes two kinds of input files, and produces five types of output files.
- CatComp Input Files
The first kind of file read by CatComp is a catalog description file. That file describes all the strings used by an application. There is one such file per localized application. In this file, you assign numbers to all the application strings as well as specify their minimum and maximum lengths.
The second kind of file read by CatComp is a catalog translation file. That file contains all strings from the application translated to one language. There is one catalog translation file per language supported by a localized application.
- CatComp Output Files
CatComp can produce several different kinds of output files. The first is an IFF catalog. These are regular IFF files. There is one catalog produced for every catalog text file successfully processed. Catalogs are read directly by locale.library whenever the OpenCatalog() call is made.
The second type of file output by CatComp is an empty translation file. This is useful when starting a translation. It lets CatComp convert a catalog description file into a ready to fill-in translation file.
The third type of file output by CatComp is a new translation file based on an old one. This is useful when re-starting a translation after a catalog description file was modified, because the new and the modified strings will be stored in the the new catalog translation file.
The fourth and fifth type of files output by CatComp are C and Assembly language programming source files. These are used by application writers to convert catalog description files into source files that can be directly used in their applications.
The sixth and seventh type of files output by CatComp are Modula-2 language definition and implementation source files, which are used by programmers in much the same way C and Assembly files are used.
Finally, the last type of file output by CatComp is an AmigaDOS load file. These load files are used by application writers to include a set of strings directly inside an application. This is normally used to encode the default strings that an application uses when there are no external catalogs available.
- File Formats
To learn more about CatComp's input and output files, consult CatComp documentation located in the Software Development Kit: SDK:Documentation/Tools/Locale/CatComp.doc.
Tool Types
(none)
Shell Usage
- Format
- CATCOMP <descriptor> [<cd file>] [CATALOG=<catalog file>] [CTFILE=<ct file>] [CFILE=<c source file>]
- [SYMBOLS={<symbol>}] [VERBOSITY=<verbosity level>] [NOOPTIM] [NONUMBERS] [NOSTRINGS] [NOARRAY]
- [NOBLOCK] [NOCODE] [SORT] [COMMENTS]
- Template
- DESCRIPTOR/A,TRANSLATION,CATALOG/K,CTFILE/K,CFILE/K,SYMBOLS/M/K,VB=VERBOSITY/N/K,NOOPTIM/S,
- NONUMBERS/S,NOSTRINGS/S,NOARRAY/S,NOBLOCK/S,NOCODE/S,SORT/S,COMMENTS/S
- Location
- SDK:C
The options are:
DESCRIPTOR | Specifies the name of a catalog descriptor file. Typically, the file extension for catalog descriptor files is ".cd". | ||||||||||||
TRANSLATION | Specifies the name of a catalog translation file. Typically, the file extension for catalog translation files is ".ct". | ||||||||||||
CATALOG | Specifies the name of the IFF catalog file to produce. When this option is specified, a translation file must have been given in the previous argument. | ||||||||||||
CTFILE | Specifies the name of the catalog translation file to produce. This option only requires a catalog descriptor file be provided, then the catalog translation file will be blank. When you also specified a source translation file, the version string, language, codeset, and strings of the source translation file will be copied to the new translation file. | ||||||||||||
CFILE | Specifies the name of the C language source file header to produce. This option only requires a catalog descriptor file be provided, there is no need for a translation file. | ||||||||||||
SYMBOLS | Specifies any number of symbols that are used for determining which section of the available strings get included within generated C, Assembly, and object files. The valid symbols are:
| ||||||||||||
VB or VERBOSITY |
Specifies the amount of information CatComp should output while doing some processing. The lower this number, the less CatComp will output messages.
| ||||||||||||
NOOPTIM | When generating a catalog file, CatComp normally skips strings that are identical in the catalog descriptor file and in the catalog translation file and does not include them in the generated catalog file. This option disables this optimization. | ||||||||||||
NONUMBERS | This option is only useful when generate C or Assembly language header files. It prevents the generation of the CATCOMP_NUMBERS section within the header file. | ||||||||||||
NOSTRINGS | This option is only useful when generate C or Assembly language header files. It prevents the generation of the CATCOMP_STRINGS section within the header file. | ||||||||||||
NOARRAY | This option is only useful when generate C or Assembly language header files. It prevents the generation of the CATCOMP_ARRAY section within the header file. | ||||||||||||
NOBLOCK | This option is only useful when generate C or Assembly language header files. It prevents the generation of the CATCOMP_BLOCK section within the header file. | ||||||||||||
NOCODE | This option is only useful when generate C or Assembly language header files. It prevents the generation of the CATCOMP_CODE section within the header file. | ||||||||||||
SORT | When specified, all strings will be sorted by ID before they are written to header/assembler/object/catalog files. Catalog translation files will, however, get written in the same order in which the strings showed up in the catalog descriptor file. | ||||||||||||
COMMENTS | When both this switch and CTFILE were spesified, the comment lines from the catalog description file will be copied into the new catalog translation file. |
- Example 1
Test if "app.cd" is a valid catalog descriptor file.
1> CatComp app.cd
- Example 2
Generate a blank translation file called "app.ct".
1> CatComp app.cd CTFILE app.ct
- Example 3
Create a catalog file "app.catalog".
1> CatComp app.cd app.ct CATALOG app.catalog
ARexx Interface
CatComp has no ARexx interface.
ChangeRegs
Tags: #Code Generation #Conversion
Missing description.
Tool Types
(none)
Shell Usage
- Format
- CHANGEREGS <source file> <destination> [HEADER] [NEWSUFFIX=<file extension>]
- Template
- SRC=SOURCE/A,DEST=DESTPATH,HEADER/S,NS=NEWSUFFIX/K
- Location
- SDK:C
The parameters are:
SRC or SOURCE |
C source code file to be processed. |
DEST or DESTPATH |
Path to directory where the processed source code will be saved. |
HEADER | Add register definitions for SAS/C and GNU/C at the beginning of the source code. |
NS or NEWSUFFIX |
Save the processed source code with a new file extension. |
ARexx Interface
ChangeRegs has no ARexx interface.
DistCC
Tags: #Building
DistCC is a program to distribute builds of C or C++ code across several machines on a network. It does not require all machines to share a filesystem, have synchronized clocks, or to have the same libraries or header files installed. They can even have different processors or operating systems if cross-compilers are installed.
DistCC is not itself a compiler, but rather a front-end to the GNU C/C++ compiler (GCC), or another compiler of your choice. All the regular GCC options and features work as normal.
For each job, DistCC sends the complete preprocessed source code and compiler arguments across the network from the client to a compilation server. Compilation is driven by a client machine, which is typically the developer's workstation. The DistCC client runs on this machine, as does Make, the preprocessor, the linker, and other stages of the build process. Any number of volunteer machines act as compilation servers and help the client to build the program by running the DistCCD daemon, C compiler and assembler as required.
DistCC runs across TCP sockets (on port 3632 by default). For TCP connections the volunteers must run the DistCCD daemon directly.
DistCC is intended to be used with GNU Make's -j option, which runs several compiler processes concurrently. DistCC spreads the jobs across both local and remote CPUs. Because DistCC is able to distribute most of the work across the network, a higher concurrency level can be used than for local builds. As a rule of thumb, the -j value should be set to about twice the total number of available server CPUs but subject to client limitations. This setting allows for maximal interleaving of tasks being blocked waiting for disk or network IO.
It is strongly recommended that you install the same compiler version on all machines participating in a build. Incompatible compilers may cause mysterious compile or link failures.
- Environment Variables
DistCC uses the following environment variables:
Variable | Description |
---|---|
DISTCC_DIR | Path to the host list and locks files. |
DISTCC_HOSTS | Name of the host list file. The default name is "hosts". |
DISTCC_LOG | Name of the log file. When set, DistCC writes its output to the log. |
DISTCC_VERBOSE | Setting this to 1 enables debug messages. |
- Server Specification
A list of servers will be taken from a file pointed by an environment variable $DISTCC_HOSTS or $DISTCC_DIR/hosts. In the file each host can be given in any of these forms:
Host Address / Command | Description |
---|---|
localhost | Run in place. |
<host> | TCP connection to a specified host's port 3632. |
<host>:<port> | TCP connection to a specified host's port number <port>. |
--randomize | Randomize the server list before execution. |
Tool Types
(none)
Shell Usage
- Format
- DISTCC [--help] [--version] [--show-hosts] [-j] [<compiler>] [<compiler options>]
- Template
- --help --version --show-hosts -j <compiler> <compiler options>
- Location
- SDK:C
- Tutorials
- See also
The options are:
Option | Description |
---|---|
--help | Explain DistCC usage and exit. |
--version | Show DistCC version and exit. |
--show-hosts | Show host list and exit. |
-j | Calculate the concurrency level from the host list. |
<compiler> | Compiler to use. Defaults to cc. |
<compiler options> | Compiler options. As a minimum, you should supply a list of source files to be compiled. |
ARexx Interface
DistCC has no ARexx interface.
DistCCD
Tags: #Building
DistCCD is the server for the DistCC distributed compiler. It accepts and runs compilation jobs for network clients. DistCCD will listen for network connections and fork several child processes to serve them.
- Environment Variables
DistCCD uses the following environment variables:
Variable | Description |
---|---|
DISTCC_CMDLIST | If the environment variable DISTCC_CMDLIST is set, load a list of supported commands from the file named by DISTCC_CMDLIST, and refuse to serve any command whose last DISTCC_CMDLIST_MATCHWORDS last words do not match those of a command in that list. |
DISTCC_CMDLIST_NUMWORDS | The number of words, from the end of the command, to match. The default is 1. |
DISTCCD_PATH | When starting distccd, if this value is set it will be used unaltered for the command-execution path. The code that normally tries to remove masquerade directories from the path is skipped. |
DISTCC_SAVE_TEMPS | If set to 1, temporary files are not deleted after use. |
DISTCC_TCP_DEFER_ACCEPT | Turn on the TCP_DEFER_ACCEPT socket option. Defaults to on. |
TMPDIR | Directory for temporary files such as preprocessor output. |
Tool Types
(none)
Shell Usage
- Format
- DISTCCD [--help] [--version] [-P=--pid-file <file>] [-N=--nice <level>] [--user <user>] [-j=--jobs <limit>] [--job-lifetime <seconds>]
- [-p=--port <port>] [--listen <address>] -a=--allow <ip/bits> [--stats] [--stats-port <port>]
- [--log-level <level>] [--verbose] [--no-detach] [--log-file <file>] [--log-stderr] [--wizard]
- [--inetd] [--daemon]
- Template
- --help --version -P=--pid-file <file> -N=--nice <level> --user <user> -j=--jobs <limit> --job-lifetime <seconds>
- -p=--port <port> --listen <address> -a=--allow <ip/bits> --stats --stats-port <port>
- --log-level <level> --verbose --no-detach --log-file <file> --log-stderr --wizard
- --inetd --daemon
- Location
- SDK:C
- Tutorials
- See also
The options are:
Option | Type | Description |
---|---|---|
--help | General | Display usage information and exit. |
--version | General | Show version and exit. |
-P <file> or --pid-file <file> |
General | Save DistCCD process id to file <file>. |
-N <niceness> or --nice <level> |
General | Makes the DistCCD more nice about giving up the CPU to other tasks on the machine. <niceness> is an increment to the current priority of the process. The range of priorities depends on the operating system but is typically 0 to 20. By default the niceness is increased by 5. |
--user <user> | General | Change user to <user>. |
-j <limit> or --jobs <limit> |
General | Sets a limit on the number of jobs that can be accepted at any time. By default this is set to two greater than the number of CPUs on the machine, to allow for some processes being blocked on network IO. |
--job-lifetime <seconds> | General | Kills a DistCCD job if it runs for more than <seconds> seconds. This prevents denial of service from clients that don't properly disconnect and compilers that fail to terminate. By default this is turned off. |
-p <port> or --port <port> |
Networking | Set the TCP port to listen on, rather than the default of 3632. |
--listen <address> | Networking | Instructs DistCCD to listen on the IP address <address>. This can be useful for access control on dual-homed hosts. |
-a <ipaddr>[/<mask>] or --allow <ip/bits> |
Networking | Instructs DistCCD to accept connections from the IP address <ipaddr>. A CIDR mask length can be supplied optionally after a trailing slash, e.g. 192.168.0.0/24, in which case addresses that match in the most significant <mask> bits will be allowed. This is a mandatory parameter. |
--stats | Networking | Turn on the statistics HTTP server. By default it is off. |
--stats-port <port> | Networking | Set the TCP port to listen on for HTTP requests, rather than the default of 3633. |
--log-level <level> | Debugging | Set the minimum severity of error that will be included in the log file. Useful if you only want to see error messages rather than an entry for each connection. <level> can be critical, error, warning, notice, info, or debug. |
--verbose | Debugging | Include debug messages in log. Equivalent to --log-level=debug. |
--no-detach | Debugging | Do not detach from the shell that started DistCCD. |
--log-file <file> | Debugging | Send messages to file <file>. |
--log-stderr | Debugging | Send log messages to stderr. This is mainly intended for use in debugging. |
--wizard | Debugging | Turn on all options appropriate for starting DistCCD under GNU debugger GDB. |
--inetd | Operation Mode | Serve a client connected to stdin/stdout. Note: this option has been disabled. |
--daemon | Operation Mode | Run DistCCD in the background. |
- Example
Start the server, allow connections from an IP address 192.168.1.100, and suppress all other messages except error messages.
1> DistCCD --allow 192.168.1.100 --log-level=error
Pressing Ctrl + C stops the server.
ARexx Interface
DistCCD has no ARexx interface.
DistCCMon-Amiga
Tags: #Building
Displays the statuses of the current distributed compilation jobs graphically.
Tool Types
(none)
Shell Usage
- Format
- DISTCCMON-AMIGA
- Template
- (none)
- Location
- SDK:C
- Tutorials
- See Also
ARexx Interface
DistCCMon-Amiga has no ARexx interface.
DistCCMon-Text
Tags: #Building
Displays the statuses of the current distributed compilation jobs.
Tool Types
(none)
Shell Usage
- Format
- DISTCCMON-TEXT [<delay>]
- Template
- <delay>
- Location
- SDK:C
- Tutorials
- See Also
When run without parameters, DistCCMon-Text lists the current jobs and exits. If you want to continuously monitor the compilation jobs, supply a job polling delay. For example, to list the jobs in every 3 seconds type
1> DistCCMon-Text 3
When you press Enter, DistCCMon-Text keeps listing the jobs until you interrupt it by pressing Ctrl + C.
ARexx Interface
DistCCMon-Text has no ARexx interface.
Expunge
Tags: #Debugging
Expunge is meant as a software developer tool to force shared libraries and devices to expunge themselves. The ramlib process is responsible for expunging libraries when the corresponding disk file has changed so there should be little need for this command in practice. The caching of system libraries and devices is normal and users should not be using this command.
Tool Types
(none)
Shell Usage
- Format
- EXPUNGE [{<library or device>}] [PATTERN <pattern>] [ALL]
- Template
- NAME/M,PAT=PATTERN/K,ALL/S
- Location
- SDK:C
Expunge with no arguments displays the list of devices and libraries along with their open count and flags. This is useful to find out the names of the objects to expunge.
Expunge will attempt to expunge the named shared libraries and/or devices. Since it is not possible to determine whether an expunge succeeds or fails Expunge will always state an object was expunged if it was found.
If PATTERN is specified only libraries and devices matching this pattern will be attempted to be expunged. This pattern may be an arbitrary DOS style pattern.
If the ALL switch is present Expunge will attempt to expunge all the shared libraries and devices with a usage count of zero. Any names specified will be ignored in this case.
If Expunge succeeded, the return code will be set to 0. If Expunge cannot find one or more specified names, it will continue and the return code will be 5. If Expunge fails completely, the return code will be 20. The secondary return code will be set appropriately.
- Example 1
Display the current device and library lists.
1> Expunge
- Example 2
Expunge keyboard.device and graphics.library. Since the use count of these objects is greater than 0 nothing will happen but the command will still succeed. This is because there is no return code on the Expunge vector.
1> Expunge keyboard.device graphics.library
- Example 3
Expunge all the devices and libraries it can find.
1> Expunge ALL
- Example 4
Expunge all the unused catalogs and replace the obsolete Avail FLUSH technique.
1> Expunge locale.library
- Example 5
Expunge all libraries whose name is starting with "amiga" (i.e. amigaguide.library or amigaguide.datatype).
1> Expunge PATTERN amiga#?
ARexx Interface
Expunge has no ARexx interface
FDTrans
Tags: #Code Generation #Conversion
FDTrans is a small utility for legacy SFD files. It offers two functions:
- Convert an SFD file into an XML file for processing with the IDLTool
- Generate 68k-to-PPC or PPC-to-68k cross call stubs. These are required to use a 68k Library from PPC code (automatically; implicit emulator calling works too but needs special attention) and to make a PPC library callable for (legacy) 68k programs.
FDTrans requires an SFD file as input. If you only have an FD file, you need to revert it to an SFD file using a tool like FD2Pragma.
Note |
---|
SFD file is a file which contains lines describing a library's entry points. |
Note that for some SFD files it might be required to do some manual correction. Most notably, there is great commotion about the way that vararg functions are specified. The following format is used throughout because it is the most commonly used format:
VOID someFunc(ULONG someparam, ULONG Tag1, ...) (D0,A0)
Although this prototype doesn't really make sense (vararg functions are not supposed to list the first vararg argument), this is the way that FDTrans expects the functions in the SFD file. If you have a function like
VOID printf(char *format, ...) (A0,A1)
you need to manually add a dummy argument like
- VOID printf(char *format, ULONG dummy, ...) (A0,A1)
For more information on FDTrans, see the developer documentation on migrating old programs and libraries.
Tool Types
(none)
Shell Usage
- Format
- FDTRANS <sfd file> [-o=--output <outfile>] [-i=--struct <structname>] [-l=--library <libname>]
- [-x=--xml] [-s=--stubs] [-c=--c68k] [-cold] [-a=--all] [-6=--68k] [-4=--inline4] [-v=--verbose]
- Template
- <sfd file> -o=--output <outfile> -i=--struct <structname> -l=--library <libname> -x=--xml
- -s=--stubs -c=--c68k -cold -a=--all -6=--68k -4=--inline4 -v=--verbose
- Location
- SDK:C
- Tutorials
- See Also
The options are:
Option | Description |
---|---|
<sfd file> | An SFD file to process. |
-o <outfile> or --output <outfile> |
Use <outfile> as base for output files. |
-i <structname> or --struct <structname> |
Use <structname> as interface name. Guess name by default. |
-l <libname> or --library <libname> |
Use <libname> for OpenLibrary. Guess name by default. |
-s=--stubs | Generate the PPC-to-M68k cross-call stubs in C. |
-c=--c68k | Generate the M68k-to-PPC cross-call stubs in C. |
-cold | Generate the M68k-to-PPC cross-call stubs in C but without TRAPTYPENR. |
-a=--all | Generate the PPC-to-M68k and M68k-to-PPC cross-call stubs in C. |
-6=--68k | Generate M68k-to-PPC cross-call stubs in Assembler. |
-4=--inline4 | Generate special inline4 for using M68k libraries without a PPC interface (interface pointer can be NULL). |
-v=--verbose | Be verbose. |
ARexx Interface
FDTrans has no ARexx interface.
FSTest
Tags: #Debugging
FSTest is a tool that checks for problems with a mounted file system on your computer. When executed without parameters, FSTest displays a complete list of the available tests:
Test Number | Description |
---|---|
1 | Add a notification. |
2 | Change the current mode of a lock. |
3 | Change the file mode. |
4 | Change the current file position. |
5 | Change the size of a file. |
6 | Close an open file. |
7 | Create a directory. |
8 | Create a hard link. |
9 | Create a soft link. |
10 | Delete a file, directory, or symbolic link. |
11 | Get information on a device. |
12 | Duplicate an existing lock. |
13 | Get a lock on an open file. |
14 | Reserved for a ExamineDir() test. |
15 | Examine a file. |
16 | Examine a locked file system object. |
17 | Reserved for FileSystemAttr() test. |
18 | Reserved for Flush() test. |
19 | Reserved for Format() test. |
20 | Reserved for GetFilePosition() test. |
21 | Obtain the size of a file. |
22 | Inhibit access to a filesystem. |
23 | Lock a directory or a file. |
24 | Lock a record (a portion of a file). |
25 | Open a file. |
26 | Open a file you have a lock on. |
27 | Obtain the parent directory for a directory or file lock. |
28 | Get a shared lock on the parent directory of a file. |
29 | Read data from a file. |
30 | Read the target object string for a filesystem soft link. |
31 | Change the volume name. |
32 | Remove notify. |
33 | Rename a file, directory, or symbolic link. |
34 | Reserved for SameFile() test. |
35 | Reserved for SameLock() test. |
36 | Reserved for Serialize() test. |
37 | Change a comment string on a filesystem object. |
38 | Set the modification date for a file or directory. |
39 | Set group for a file or directory. |
40 | Set owner for a file or directory. |
41 | Set protection for a file or directory. |
42 | Unlock a file or directory. |
43 | Unlock a locked record. |
44 | Reserved for VolumeInfoData() test. |
45 | Write data to a file. |
46 | Set a write protection status of a volume. |
Tool Types
(none)
Shell Usage
- Format
- FSTEST <device> [NOINFOMESSAGES] [NOWARNMESSAGES] [NOROOTMESSAGES] [ABORTONERR]
- [FIRSTTESTNUMBER <test number>] [LASTTESTNUMBER <test number>] [TESTNUMBER <test number>]
- Template
- DEVICE/A,NOINFOMESSAGES=NI/S,NOWARNMESSAGES=NW/S,NOROOTMESSAGES=NR/S,
- ABORTONERR=AOE/S,FIRSTTESTNUMBER=FTN/K/N,LASTTESTNUMBER=LTN/K/N,TESTNUMBER=TN/K/N
- Location
- SDK:C
The options are:
DEVICE | Device to test. |
NOINFOMESSAGES or NI |
Do not show additional information on tests. |
NOWARNMESSAGES or NW |
Do not show warnings. |
NOROOTMESSAGES or NR |
Missing description. |
ABORTONERR or AOE |
Stop the execution of the test batch on first error. |
FIRSTTESTNUMBER or FTN |
First test to perform. The valid test number is between 1 and 45. |
LASTTESTNUMBER or LTN |
Last test to perform. The valid test number is between 1 and 45. |
TESTNUMBER or TN |
Perform a single test. The valid test number is between 1 and 45. |
ARexx Interface
FSTest has no ARexx interface.
FSVPTool
Tags: #Code Generation
FSVPTool generates all the basic stub files required for filesystems to communicate with the version 53 (or newer) DOS library FileSystem Vector-Port interface.
Tool Types
(none)
Shell Usage
- Format
- FSVPTOOL
- Template
- (none)
- Location
- SDK:C
- Example
Generate a skeleton vector-port filesystem C source files.
1.RAM Disk:> FSVPTool Finished, vector port interface files can be found in; RAM:FSVP_Files
ARexx Interface
FSVPTool has no ARexx interface.
GCC
Tags: #Archiving #Building #Debugging #Optimizing #Testing
The SDK:gcc/bin directory contains essential tools from the GNU Compiler Collection and the GNU Binutils Binary Tools Collection. The command line tools included from the collections are:
- addr2line – Converts addresses to filenames and line numbers.
- ar – A utility for creating and modifying archives, and extracting from archives.
- as – The GNU assembler.
- c++ – The GNU C++ compiler.
- c++filt – Decodes mangled (low-level) function names into human readable form.
- cpp – The GNU C/C++ preprocessor.
- g++ – The GNU C++ compiler, c++ alias.
- gcc – The GNU C compiler.
- gccbug – A utility for filing a bug report.
- gcov – The GNU test coverage program.
- gprof – The GNU profiler.
- ld – The GNU linker.
- nm – Lists symbols from object files.
- objcopy – Copies and translates object files.
- objdump – Displays information about object files.
- ranlib – Generates an index to the contents of an archive and stores it in the archive.
- readelf – Displays information about any ELF format object file.
- size – Lists the section sizes of an object or archive file.
- strings – Lists printable strings from files.
- strip – Discards symbols.
The full documentation of the listed tools can be found from the GCC and GNU web sites.
GDB
Tags: #Debugging
GDB is a debugging tool which purpose is to help developers to locate programming errors from their C/C++ programs. With GDB the developer can run and halt their program at will, to monitor and modify the values of the program's internal variables, and even call functions independently of the program's normal behavior.
In order to be able to debug a program, it has to contain a debugging symbol table. The symbol table maps the machine language instructions to the variables, functions, and lines appearing in the program's source code. The debugging table should be embedded in the program at compilation. For example, when using a GCC compiler, option -g generates and embeds the debug information needed.
- GDB Commands
Break and Watch
Command | Description |
---|---|
awatch | Set a watchpoint for an expression. |
break | Set breakpoint at specified line or function. |
catch | Set catchpoints to catch events. |
clear | Clear breakpoint at specified line or function. |
commands | Set commands to be executed when a breakpoint is hit. |
condition | Specify breakpoint to break only if a condition is true. |
delete | Delete some breakpoints or auto-display expressions. |
disable | Disable some breakpoints. |
enable | Enable some breakpoints. |
hbreak | Set a hardware assisted breakpoint. |
ignore | Set ignore-count of a breakpoint. |
rbreak | Set a breakpoint for all functions matching a regular expression. |
rwatch | Set a read watchpoint for an expression. |
tbreak | Set a temporary breakpoint. |
tcatch | Set temporary catchpoints to catch events. |
thbreak | Set a temporary hardware assisted breakpoint. |
watch | Set a watchpoint for an expression. |
Examine Data
Command | Description |
---|---|
append | Append code or data to a file. |
call | Call a function in the program. |
delete display | Cancel some expressions to be displayed when the program stops. |
delete mem | Delete a memory region. |
disable display | Disable some expressions to be displayed when the program stops. |
disable mem | Disable a memory region. |
disassemble | Disassemble a specified memory section. |
display | Print value of an expression each time the program stops. |
dump | Dump code or data to a file. |
enable display | Enable some expressions to be displayed when the program stops. |
enable mem | Enable a memory region. |
inspect | Alias to print. |
mem | Define attributes for a memory region. |
output | Like print but do not put value in the value history and do not print newline. |
Print expression's value. | |
print-object | Ask an Objective-C to print itself. |
printf | Print a formatted string. |
ptype | Print definition of a type. |
restore | Restore the contents of a file to a memory. |
set | Evaluate an expression and assign the result to a variable. |
set variable | Evaluate an expression and assign the result to a variable. |
undisplay | Cancel some expressions to be displayed when program stops. |
whatis | Print data type of an expression. |
x | Examine memory. |
Examine Files
Command | Description |
---|---|
add-shared-symbol-files | Load the symbols from shared object's in the dynamic linker's link map. |
add-symbol-file | Add a symbol file. |
cd | Change the working directory. |
core-file | Select a core dump file for examining the memory and registers. |
directory | Add new directory to the beginning of the search path for source files. |
edit | Edit file or function. |
exec-file | Select program file for getting the contents of a pure memory. |
file | Select program file to be debugged. |
forward-search | Search for regular expression from the last line listed. |
list | List a function or a line. |
load | Dynamically load a file into the running program. |
path | Add new directory to the beginning of the search path for object files. |
pwd | Print the working directory. |
reverse-search | Search backward for regular expression from the last line listed. |
search | Search regular expression from the last line listed. |
section | Change the base address of a section of a file. |
set extension-language | Set mapping between file name extension and source language. |
set gnutarget | Set the current BFD target. |
show gnutarget | Show the current BFD target. |
symbol-file | Load a symbol table from an executable file. |
Maintenance
Command | Description |
---|---|
flushregs | Force GDB to flush its register cache (maintainer command). |
maintenance | Commands for use by GDB maintainers. |
maintenance agent | Translate an expression into remote agent bytecode. |
maintenance check-symtabs | Check consistency of psymtabs and symtabs. |
maintenance cplus | C++ maintenance commands. |
maintenance cplus first_component | Print the first class/namespace component of NAME. |
maintenance cplus namespace | Print the list of possible C++ namespaces. |
maintenance demangle | Demangle a C++/ObjC mangled name. |
maintenance deprecate | Deprecate a command. |
maintenance dump-me | Get fatal error; make debugger dump its core. |
maintenance info | Commands for showing internal info about the program being debugged. |
maintenance info breakpoints | Status of all breakpoints. |
maintenance info psymtabs | List the partial symbol tables for all object files. |
maintenance info sections | List the BFD sections of the exec and core files. |
maintenance info symtabs | List the full symbol tables for all object files. |
maintenance internal-error | Give GDB an internal error. |
maintenance internal-warning | Give GDB an internal warning. |
maintenance packet | Send an arbitrary packet to a remote target. |
maintenance print | Maintenance command for printing GDB internal state. |
maintenance print architecture | Print the internal architecture configuration. |
maintenance print cooked-registers | Print the internal register configuration including cooked values. |
maintenance print dummy-frames | Print the contents of the internal dummy-frame stack. |
maintenance print msymbols | Print dump of current minimal symbol definitions. |
maintenance print objfiles | Print dump of current object file definitions. |
maintenance print psymbols | Print dump of current partial symbol definitions. |
maintenance print raw-registers | Print the internal register configuration including raw values. |
maintenance print reggroups | Print the internal register group names. |
maintenance print register-groups | Print the internal register configuration including each register's group. |
maintenance print registers | Print the internal register configuration. |
maintenance print statistics | Print statistics about internal gdb state. |
maintenance print symbols | Print dump of current symbol definitions. |
maintenance print type | Print a type chain for a given symbol. |
maintenance set | Set GDB internal variables used by the GDB maintainer. |
maintenance set dwarf2 | Set DWARF 2 specific variables. |
maintenance set profile | Set internal profiling. |
maintenance show | Show GDB internal variables used by the GDB maintainer. |
maintenance show dwarf2 | Show DWARF 2 specific variables. |
maintenance show profile | Show internal profiling. |
maintenance space | Set the display of space usage. |
maintenance time | Set the display of time usage. |
maintenance translate-address | Translate a section name and address to a symbol. |
maintenance undeprecate | Undeprecate a command. |
set archdebug | Set architecture debugging. |
set backtrace | Set backtrace specific variables. |
set breakpoint | Breakpoint specific settings. |
set debug arch | Set architecture debugging. |
set debug event | Set event debugging. |
set debug expression | Set expression debugging. |
set debug frame | Set frame debugging. |
set debug observer | Set observer debugging. |
set debug serial | Set serial debugging. |
set debug target | Set target debugging. |
set debugvarobj | Set varobj debugging. |
set eventdebug | Set event debugging. |
set remote | Remote protocol specific variables. |
set serial | Set default serial/parallel port configuration. |
set watchdog | Set watchdog timer. |
show archdebug | Show architecture debugging. |
show backtrace | Show backtrace specific variables. |
show breakpoint | Breakpoint specific settings. |
show debug arch | Show architecture debugging. |
show debug event | Show event debugging. |
show debug expression | Show expression debugging. |
show debug frame | Show frame debugging. |
show debug observer | Show observer debugging. |
show debug serial | Show serial debugging. |
show debug target | Show target debugging. |
show debugvarobj | Show varobj debugging. |
show eventdebug | Show event debugging. |
show remote | Show the remote protocol specific variables. |
show serial | Show the default serial/parallel port configuration. |
show watchdog | Show a watchdog timer. |
Obscure Features
Command | Description |
---|---|
compare-sections | Compare section data on target to the exec file. |
complete | List the completions for the rest of the line as a command. |
maintenance set dwarf2 max-cache-age | Set the upper bound on the age of cached dwarf2 compilation units. |
maintenance show dwarf2 max-cache-age | Show the upper bound on the age of cached dwarf2 compilation units. |
monitor | Send a command to the remote monitor (remote targets only). |
remote <command> | Send a command to the remote monitor. |
set annotate | Set annotation_level. |
set backtrace limit | Set an upper bound on the number of backtrace levels. |
set backtrace past-main | Set whether backtraces should continue past "main". |
set coerce-float-to-double | Set coercion of floats to doubles when calling functions. |
set cp-abi | Set the ABI used for inspecting C++ objects. |
set download-write-size | Set the write size used when downloading a program. |
set remote P-packet | Set use of remote protocol P (set-register) packet. |
set remote X-packet | Set use of remote protocol X (binary-download) packet. |
set remote Z-packet | Set use of remote protocol Z packets. |
set remote access-watchpoint-packet | Set use of remote protocol Z4 (access-watchpoint) packet. |
set remote binary-download-packet | Set use of remote protocol X (binary-download) packet. |
set remote fetch-register-packet | Set use of remote protocol p (fetch-register) packet. |
set remote hardware-breakpoint-packet | Set use of remote protocol Z1 (hardware-breakpoint) packet. |
set remote p-packet | Set use of remote protocol p (fetch-register) packet. |
set remote read-aux-vector-packet | Set use of remote protocol qPart_auxv (read-aux-vector) packet. |
set remote read-watchpoint-packet | Set use of remote protocol Z3 (read-watchpoint) packet. |
set remote set-register-packet | Set use of remote protocol P (set-register) packet. |
set remote software-breakpoint-packet | Set use of remote protocol Z0 (software-breakpoint) packet. |
set remote symbol-lookup-packet | Set use of remote protocol qSymbol (symbol-lookup) packet. |
set remote verbose-resume-packet | Set use of remote protocol vCont (verbose-resume) packet. |
set remote write-watchpoint-packet | Set use of remote protocol Z2 (write-watchpoint) packet. |
set remoteaddresssize | Set the maximum size of the address (in bits) in a memory packet. |
show annotate | Show annotation_level. |
show backtrace limit | Show the upper bound on the number of backtrace levels. |
show backtrace past-main | Show whether backtraces should continue past "main". |
show coerce-float-to-double | Show coercion of floats to doubles when calling functions. |
show cp-abi | Show the ABI used for inspecting C++ objects. |
show download-write-size | Show the write size used when downloading a program. |
show remote P-packet | Show current use of remote protocol P (set-register) packet. |
show remote X-packet | Show current use of remote protocol X (binary-download) packet. |
show remote Z-packet | Show use of remote protocol Z packets. |
show remote access-watchpoint-packet | Show current use of remote protocol Z4 (access-watchpoint) packet. |
show remote binary-download-packet | Show current use of remote protocol X (binary-download) packet. |
show remote fetch-register-packet | Show current use of remote protocol p (fetch-register) packet. |
show remote hardware-breakpoint-packet | Show current use of remote protocol Z1 (hardware-breakpoint) packet. |
show remote p-packet | Show current use of remote protocol `p' (fetch-register) packet. |
show remote read-aux-vector-packet | Show current use of remote protocol qPart_auxv (read-aux-vector) packet. |
show remote read-watchpoint-packet | Show current use of remote protocol Z3 (read-watchpoint) packet. |
show remote set-register-packet | Show current use of remote protocol P (set-register) packet. |
show remote software-breakpoint-packet | Show current use of remote protocol Z0 (software-breakpoint) packet. |
show remote symbol-lookup-packet | Show current use of remote protocol qSymbol (symbol-lookup) packet. |
show remote verbose-resume-packet | Show current use of remote protocol vCont (verbose-resume) packet. |
show remote write-watchpoint-packet | Show current use of remote protocol Z2 (write-watchpoint) packet. |
show remoteaddresssize | Show the maximum size of the address (in bits) in a memory packet. |
stop | There is no stop command. |
Running the Program
Command | Description |
---|---|
advance | Continue the program up to the given location (same form as args for break command). |
attach | Attach to a process or file outside of GDB. |
continue | Continue program being debugged. |
detach | Detach a process or file previously attached. |
disconnect | Disconnect from a target. |
finish | Execute until selected stack frame returns. |
handle | Specify how to handle a signal. |
info handle | What debugger does when program gets various signals. |
interrupt | Interrupt the execution of the debugged program. |
jump | Continue program being debugged at specified line or address. |
kill | Kill execution of program being debugged. |
next | Step program. |
nexti | Step one instruction. |
run | Start debugged program. |
set args | Set argument list to give program being debugged when it is started. |
set environment | Set environment variable value to give the program. |
set follow-fork-mode | Set debugger response to a program call of fork or vfork. |
set scheduler-locking | Set mode for locking scheduler during execution. |
set step-mode | Set mode of the step operation. |
show args | Show argument list to give program being debugged when it is started. |
show follow-fork-mode | Show debugger response to a program call of fork or vfork. |
show scheduler-locking | Show mode for locking scheduler during execution. |
show step-mode | Show mode of the step operation. |
signal | Continue program giving it signal specified by the argument. |
start | Run the debugged program until the beginning of the main procedure. |
step | Step program until it reaches a different source line. |
stepi | Step one instruction exactly. |
target | Connect to a target machine or process. |
thread | Use this command to switch between threads. |
thread apply | Apply a command to a list of threads. |
apply all | Apply a command to all threads. |
tty | Set terminal for future runs of program being debugged. |
unset environment | Cancel environment variable VAR for the program. |
until | Execute until the program reaches a source line greater than the current. |
Examine Stack
Command | Description |
---|---|
backtrace | Print backtrace of all stack frames. |
bt | Alias to backtrace. |
down | Select and print stack frame called by this one. |
frame | Select and print a stack frame. |
return | Make selected stack frame return to its caller. |
select-frame | Slect a stack frame without printing anything. |
up | Select and print a stack frame that called this one. |
Status Inquiries
Command | Description |
---|---|
info | Generic command for showing things about the program being debugged. |
info powerpc | Verious PowerPC info specific commands. |
macro | Prefix for commands dealing with C preprocessor macros. |
show | Generic command for showing things about the debugger. |
Support Facilities
Command | Description |
---|---|
apropos | Search for commands matching a REGEXP. |
define | Define a new command name. |
document | Document a user-defined command. |
dont-repeat | Don't repeat this command. |
down-silently | Same as the down command. |
echo | Print a constant string. |
help | Print list of commands. |
if | Execute nested commands once IF the conditional expression is non zero. |
interpreter-exec | Execute a command in an interpreter. |
make | Run the Make program using the rest of the line as arguments |
overlay | Commands for debugging overlays. |
overlay auto | Enable automatic overlay debugging. |
overlay list-overlays | List mappings of overlay sections. |
overlay load-target | Read the overlay mapping state from the target. |
overlay manual | Enable overlay debugging. |
overlay map-overlay | Assert that an overlay section is mapped. |
overlay off | Disable overlay debugging. |
overlay unmap-overlay | Assert that an overlay section is unmapped. |
quit | Exit GDB. |
set architecture | Set architecture of target. |
set can-use-hw-watchpoints | Set debugger's willingness to use watchpoint hardware. |
set case-sensitive | Set case sensitivity in name search. |
set charset | Set the host and target character sets. |
set check range | Set range checking. |
set check type | Set type checking. |
set complaints | Set max number of complaints about incorrect symbols. |
set confirm | Set whether to confirm potentially dangerous operations. |
set debug-file-directory | Set the directory where separate debug symbols are searched for. |
set demangle-style | Set the current C++ demangling style. |
set editing | Set editing of command lines as they are typed. |
set endian | Set endianness of target. |
set exec-done-display | Set notification of completion for asynchronous execution commands. |
set height | Set number of lines gdb thinks are in a page. |
set history | Generic command for setting command history parameters. |
set host-charset | Set the host character set. |
set input-radix | Set default input radix for entering numbers. |
set language | Set the current source language. |
set listsize | Set number of source lines gdb will list by default. |
set logging | Set logging options. |
set logging file | Set the current logfile. |
set logging off | Disable logging. |
set logging on | Enable logging. |
set logging overwrite | Set whether logging overwrites or appends to the log file. |
set logging redirect | Set the logging output mode. |
set opaque-type-resolution | Set resolution of opaque struct/class/union types (if set before loading symbols). |
set osabi | Set OS ABI of target. |
set output-radix | Set default output radix for printing of values. |
set overload-resolution | Set overload resolution in evaluating C++ functions. |
set pagination | Set state of pagination. |
set print address | Set printing of addresses. |
set print array | Set prettyprinting of arrays. |
set print asm-demangle | Set demangling of C++/ObjC names in disassembly listings. |
set print demangle | Set demangling of encoded C++/ObjC names when displaying symbols. |
set print object | Set printing of object's derived type based on vtable info. |
set print pascal_static-members | Set printing of pascal static members. |
set print pretty | Set prettyprinting of structures. |
set print sevenbit-strings | Set printing of 8-bit characters in strings as \nnn. |
set print static-members | Set printing of C++ static members. |
set print union | Set printing of unions interior to structures. |
set print vtbl | Set printing of C++ virtual function tables. |
set prompt | Set GDB's prompt. |
set radix | Set default input and output number radices. |
set remotecache | Set cache use for remote targets. |
set stop-on-solib-events | Set stopping for shared library events. |
set symbol-reloading | Set dynamic symbol table reloading multiple times in one run. |
set target-charset | Set the target character set. |
set trust-readonly-sections | Set mode for reading from readonly sections. |
set verbose | Set verbosity. |
set width | Set number of characters gdb thinks are in a line. |
set write | Set writing into executable and core files. |
shell | Execute the rest of the line as a shell command. |
show architecture | Show the current target architecture. |
show can-use-hw-watchpoints | Show debugger's willingness to use watchpoint hardware. |
show case-sensitive | Show case sensitivity in name search. |
show charset | Show the host and target character sets. |
show check range | Show range checking. |
show check type | Show type checking. |
show complaints | Show max number of complaints about incorrect symbols. |
show confirm | Show whether to confirm potentially dangerous operations. |
show debug-file-directory | Show the directory where separate debug symbols are searched for. |
show demangle-style | Show the current C++ demangling style. |
show editing | Show editing of command lines as they are typed. |
show endian | Show the current byte-order. |
show exec-done-display | Show notification of completion for asynchronous execution commands. |
show height | Show number of lines gdb thinks are in a page. |
show history | Generic command for showing command history parameters. |
show host-charset | Show the host character set. |
show input-radix | Show default input radix for entering numbers. |
show language | Show the current source language. |
show listsize | Show number of source lines gdb will list by default. |
show logging | Show logging options. |
show logging file | Show the current logfile. |
show logging overwrite | Show whether logging overwrites or appends to the log file. |
show logging redirect | Show the logging output mode. |
show opaque-type-resolution | Show resolution of opaque struct/class/union types (if set before loading symbols). |
show osabi | Show OS/ABI of target. |
show output-radix | Show default output radix for printing of values. |
show overload-resolution | Show overload resolution in evaluating C++ functions. |
show pagination | Show state of pagination. |
show print address | Show printing of addresses. |
show print array | Show prettyprinting of arrays. |
show print asm-demangle | Show demangling of C++/ObjC names in disassembly listings. |
show print demangle | Show demangling of encoded C++/ObjC names when displaying symbols. |
show print object | Show printing of object's derived type based on vtable info. |
show print pascal_static-members | Show printing of pascal static members. |
show print pretty | Show prettyprinting of structures. |
show print sevenbit-strings | Show printing of 8-bit characters in strings as \nnn. |
show print static-members | Show printing of C++ static members. |
show print union | Show printing of unions interior to structures. |
show print vtbl | Show printing of C++ virtual function tables. |
show prompt | Show gdb's prompt. |
show radix | Show the default input and output number radices. |
show remotecache | Show cache use for remote targets. |
show stop-on-solib-events | Show stopping for shared library events. |
show symbol-reloading | Show dynamic symbol table reloading multiple times in one run. |
show target-charset | Show the target character set. |
show trust-readonly-sections | Show mode for reading from readonly sections. |
show verbose | Show verbosity. |
show width | Show number of characters gdb thinks are in a line. |
show write | Show writing into executable and core files. |
source | Read commands from a file named FILE. |
up-silently | Same as the up command. |
while | Execute nested commands WHILE the conditional expression is non zero. |
Tracing
Command | Description |
---|---|
actions | Specify the actions to be taken at a tracepoint. |
collect | Specify one or more data items to be collected at a tracepoint. |
delete tracepoints | Delete specified tracepoints. |
disable tracepoints | Disable specified tracepoints. |
enable tracepoints | Enable specified tracepoints. |
end | Ends a list of commands or actions. |
passcount | Set the passcount for a tracepoint. |
save-tracepoints | Save current tracepoint definitions as a script. |
tdump | Print everything collected at the current tracepoint. |
tfind | Select a trace frame. |
tfind end | Synonym for none. |
tfind line | Select a trace frame by source line. |
tfind none | De-select any trace frame and resume 'live' debugging. |
tfind outside | Select a trace frame whose PC is outside the given range. |
tfind pc | Select a trace frame by PC. |
tfind range | Select a trace frame whose PC is in the given range. |
tfind start | Select the first trace frame in the trace buffer. |
tfind tracepoint | Select a trace frame by tracepoint number. |
trace | Set a tracepoint at a specified line or function or address. |
tstart | Start trace data collection. |
tstatus | Display the status of the current trace data collection. |
tstop | Stop trace data collection. |
while-stepping | Specify single-stepping behavior at a tracepoint. |
Tool Types
(none)
Shell Usage
- Format
- Missing description.
- Template
- Missing description.
- Location
- SDK:C
- Tutorials
The options are:
Option | Description |
---|---|
--args | . |
--async | . |
--noasync | . |
-b <baudrate> | Set serial port baud rate for remote debugging. |
--batch | . |
--cd <directory> | Change current directory to <directory>. |
--command <file> | Execute GDB commands from file <file>. |
--core <corefile> | . |
--pid <pid> | . |
--dbx | DBX compatibility mode. |
--directory <directory> | Add directory <directory> to the path to search for source files. |
--epoch | Output information for epoch emacs-GDB interface. |
--exec <exefile> | Debug file <exefile>. |
--fullname | Output information for emacs-GDB interface. |
--help | Display this message and exit. |
--interpreter <interpreter> | Use the specified interpreter/user interface. |
--mapped | Use mapped symbol files. |
--nw | Do not use a window interface. See option -w. |
--nx | Do not read ".gdbinit" file. |
--quiet | Do not print version number on startup. |
--readnow | Read the whole symbol table file on first access. |
--se <file> | Use file <file> as a symbol table file and as an executable file. |
--symbols <symfile> | Read a symbol table from file <symfile>. |
--tty <tty> | . |
--version | Print GDB version and exit. |
-w | Use a window interface. See option --nw. |
--write | . |
--xdb | . |
ARexx Interface
GDB has no ARexx interface.
GUnZip
Tags: #Archiving
GUnZip decompresses files created by gzip, zip, compress, compress -H or pack. The detection of the input format is automatic.
Tool Types
(none)
Shell Usage
- Format
- GUNZIP [-c=--stdout] [-d=--decompress] [-f=--force] [-h=--help] [-l=--list]
- [-L=--license] [-n=--no-name] [-N=--name] [-r=--recursive] [-S=--suffix <suffix>]
- [-t=--test] [-v=--verbose] [-V=--version] [-1=--fast] [-9=--best] {<file>}
- Template
- -c=--stdout -d=--decompress -f=--force -h=--help -l=--list -L=--license
- -n=--no-name -N=--name -r=--recursive -S=--suffix <suffix> -t=--test
- -v=--verbose -V=--version -1=--fast -9=--best <file>
- Location
- SDK:C
The options are:
Option | Description |
---|---|
-c or --stdout | Write output on standard output; keep original files unchanged. If there are several input files, the output consists of a sequence of independently compressed members. To obtain better compression, concatenate all input files before compressing them. |
-d or --decompress | Decompress |
-f or --force | Force overwrite of output file and compress links. |
-h or --help | Display a help screen and quit. |
-l or --list | List compressed file contents. |
-L or --license | Display the gzip license and exit. |
-n or --no-name | When compressing, do not save the original file name and timestamp by default. |
-N or --name | When compressing, always save the original file name and time stamp; this is the default. |
-r or --recursive | Travel the directory structure recursively. |
-S or --suffix | When compressing, use the given suffix instead of .gz. Any non-empty suffix can be given, but suffixes other than .z and .gz should be avoided to avoid confusion when files are transferred to other systems. |
-t or --test | Check the compressed file integrity. |
-v or --verbose | Display the name and percentage reduction for each file compressed or decompressed. |
-V or --version | Display the version number. |
-1 or --fast | Compress faster. |
-9=--best | Compress better. |
- See also
- Example 1
Decompress file myfile.gz to the current directory:
1> gunzip myfile.gz
- Example 2
Decompress files myfile.gz, yourfile.gz, and theirfile.gz to the current directory:
1> gunzip myfile.gz yourfile.gz theirfile.gz
- Example 3
List the contents of a myfile.gz archive:
1> gunzip -l myfile.gz
ARexx Interface
GUnZip has no ARexx interface.
GZip
Tags: #Archiving
Compress or decompress files.
GZIP reduces the size of the named files using Lempel-Ziv coding (LZ77). Whenever possible, each file is replaced by one with the extension .gz, while keeping the same file flags and modification times. If no files are specified, the standard input is compressed to the standard output.
Compressed files can be restored to their original form using GZIP's option -d.
Tool Types
(none)
Shell Usage
- Format
- GZIP [-c=--stdout] [-d=--decompress] [-f=--force] [-h=--help] [-l=--list]
- [-L=--license] [-n=--no-name] [-N=--name] [-q=--quiet] [-r=--recursive]
- [-S <suffix>=--suffix <suffix>] [-t=--test] [-v=--verbose] [-V=--version]
- [-1=--fast] [-9=--best] [<file>]
- Template
- -c=--stdout -d=--decompress -f=--force -h=--help -l=--list
- -L=--license -n=--no-name -N=--name -q=--quiet -r=--recursive
- -S <suffix>=--suffix <suffix> -t=--test -v=--verbose -V=--version
- -1=--fast -9=--best {<file>}
- Location
- SDK:C
The options are:
Option | Description |
---|---|
-c or --stdout |
Write output on standard output; keep original files unchanged. If there are several input files, the output consists of a sequence of independently compressed members. |
-d or --decompress |
Decompress |
-f or --force |
Force compression or decompression. |
-h or --help |
Display a help and quit. |
-l or --list |
For each compressed file, list the following fields:
Compressed size: size of the compressed file |
-L or --license |
Display the GZIP license and quit.. |
-n or --no-name |
When compressing, do not save the original file name and timestamp by default. (The original name is always saved if the name had to be truncated.) When decompressing, do not restore the original file name if present (remove only the GZIP suffix from the compressed file name) and do not restore the original timestamp if present (copy it from the compressed file). This option is the default when decompressing. |
-N or --name |
When compressing, always save the original file name and timestamp; this is the default. When decompressing, restore the original file name and timestamp if present. |
-q or --quiet |
Suppress all warnings. |
-r or --recursive |
Travel the directory structure recursively. If any of the file names specified on the command line are directories, GZIP will descend into the directory and compress or decompress (option -d) all the files it finds there. |
-S <suffix> or --suffix <suffix> |
When compressing, use suffix <suffix> instead of .gz. |
-t or --test |
Test. Check the compressed file integrity. |
-v or --verbose |
Verbose. Display the name and percentage reduction for each file compressed or decompressed. |
-V or --version |
Version. Display the version number and compilation options then quit. |
-1 or --fast |
Compress faster. |
-9 or --best |
Compress better. |
{<file>} | List of files to be processed. If not given, use standard input. |
- See also
- Example 1
Compress file myfile and create file myfile.gz. The original file myfile will be deleted.
1> gzip myfile
- Example 2
Compress file myfile to file myfile.gz and keep the original file myfile:
1> gzip >myfile.gz -c myfile
- Example 3
List compressed file myfile.gz contents:
1> gzip -l myfile.gz compressed uncompr. ratio uncompressed_name 40 13 -15.3% myfile
- Example 4
Decompress compressed file myfile.gz. The original file myfile will be restored and the compressed file myfile.gz will be deleted.
1> gzip -d myfile.gz
- Example 5
Decompress file myfile.gz to file myfile and keep the myfile.gz file:
1> gzip >myfile -c myfile.gz
ARexx Interface
GZIP has no ARexx interface.
IDLTool
Tags: #Code Generation #Conversion
IDLTool is a tool that generates a C source code for a bare-bones skeleton library. It reads an XML file, that contains a library description, and outputs the source code files. It can also convert an XML library description file to SFD files.
Incomplete description.
Tool Types
(none)
Shell Usage
- Format
- Missing description.
- Template
- Missing description.
- Location
- SDK:C
- See Also
- Tutorials
ARexx Interface
ListDynDep
List shared object dependencies.
Incomplete description.
Tool Types
Shell Usage
- Format
- Template
- Location
- SDK:C
ARexx Interface
Localize
Tags: #Localization
Localize is a tool for localizing an application.
Incomplete description.
Tool Types
Shell Usage
- Format
- Template
- Location
- SDK:C
ARexx Interface
Make and GMake
Tags: #Building
Make is a tool that controls the generation of executables and other non source files of a program from the program's source files.
Make uses a file called makefile for instructions on how to build your program. Makefile lists each of the non source files and how to compute them from the project's source files, i.e. which shell commands to call. When you write a program, you should write a makefile for it, so that it is possible to use Make to build and install the program.
Make uses Amiga Shell to execute the shell commands. If you are working on cross-platform projects or porting applications from other platforms, that can be a problem because of the different shell command set and different file path format. For better compatibility, AmigaOS SDK contains a POSIX compliance Make: GMake. GMake is essentially the same tool as Make, except that GMake uses a GNU Bash compatible ABC Shell to execute commands whereas Make uses Amiga Shell. GMake is ideal for cross-platform projects and porting applications from other platforms since it is Linux/Unix compatible. If you have an Amiga-specific project, use Make instead.
For a complete Make manual, visit the GNU website.
Tool Types
(none)
Shell Usage
- Format
- MAKE [-b=-m] [-B=--always-make] [-C=--directory <directory>] [-d] [--debug <flags>]
- [-e=--environment-overrides] [-f=--file=--makefile <file>]
- [-h=--help] [-i=--ignore-errors] [-I=--include-dir <directory>]
- [-j=--jobs <jobs>] [-k=--keep-going] [-l=--load-average=--max-load <load>]
- [-L=--check-symlink-times] [-n=--just-print=--dry-run=--recon]
- [-o=--old-file=--assume-old <file>] [-p=--print-data-base] [-q=--question]
- [-r=--no-builtin-rules] [-R=--no-builtin-variables] [-s=--silent=--quiet]
- [-S=--no-keep-going=--stop] [-t=--touch] [-v=--version] [-w=--print-directory]
- [--no-print-directory] [-W=--what-if=--new-file=--assume-new <file>]
- [--warn-undefined-variables]
- GMAKE [-b=-m] [-B=--always-make] [-C=--directory <directory>] [-d] [--debug <flags>]
- [-e=--environment-overrides] [-f=--file=--makefile <file>]
- [-h=--help] [-i=--ignore-errors] [-I=--include-dir <directory>]
- [-j=--jobs [<jobs>]] [-k=--keep-going] [-l=--load-average=--max-load <load>]
- [-L=--check-symlink-times] [-n=--just-print=--dry-run=--recon]
- [-o=--old-file=--assume-old <file>] [-p=--print-data-base] [-q=--question]
- [-r=--no-builtin-rules] [-R=--no-builtin-variables] [-s=--silent=--quiet]
- [-S=--no-keep-going=--stop] [-t=--touch] [-v=--version] [-w=--print-directory]
- [--no-print-directory] [-W=--what-if=--new-file=--assume-new <file>]
- [--warn-undefined-variables]
- Template
- -b=-m -B=--always-make -C=--directory <directory> -d --debug <flags>
- -e=--environment-overrides -f=--file=--makefile <file>
- -h=--help -i=--ignore-errors -I=--include-dir <directory>
- -j=--jobs [<jobs>] -k=--keep-going -l=--load-average=--max-load <load>
- -L=--check-symlink-times -n=--just-print=--dry-run=--recon
- -o=--old-file=--assume-old <file> -p=--print-data-base -q=--question
- -r=--no-builtin-rules -R=--no-builtin-variables -s=--silent=--quiet
- -S=--no-keep-going=--stop -t=--touch -v=--version -w=--print-directory
- --no-print-directory -W=--what-if=--new-file=--assume-new <file>
- --warn-undefined-variables
- Location
- SDK:C
- See Also
The options are:
Option | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-b or -m |
Not used. | ||||||||||||||||
-B or --always-make |
Consider all targets out-of-date. | ||||||||||||||||
-C <directory> or --directory <directory> |
Change current working directory to <directory> before reading the makefiles. | ||||||||||||||||
-d | Print debugging information in addition to normal processing. The debugging information says which files are being considered for remaking, which file-times are being compared and with what results, which files actually need to be remade, which implicit rules are considered and which are applied—everything interesting about how Make decides what to do. The -d option is equivalent to --debug=a (see below). | ||||||||||||||||
--debug <flags> | Print debugging information in addition to normal processing. Various levels and types of output can be chosen. With no arguments, print the “basic” level of debugging. Possible arguments are below; only the first character is considered, and values must be comma- or space-separated.
| ||||||||||||||||
-e or --environment-overrides |
Give variables taken from the environment precedence over variables from makefiles. | ||||||||||||||||
-f <file> or --file <file> or --makefile <file> |
Read file <file> as a makefile. | ||||||||||||||||
-h or --help |
Print this message and exit. | ||||||||||||||||
-i or --ignore-errors |
Ignore command errors. | ||||||||||||||||
-I <directory> or --include-dir <directory> |
Search directory <directory> for included makefiles. | ||||||||||||||||
-j [<jobs>] or --jobs [<jobs>] |
Specifies the number of jobs to run simultaneously. With no argument, make runs as many recipes simultaneously as possible. | ||||||||||||||||
-k or --keep-going |
Continue as much as possible after an error. | ||||||||||||||||
-l [<load>] or --load-average [<load>] or --max-load <load> |
Do not start multiple jobs unless load is below <load>. With no argument, removes a previous load limit. | ||||||||||||||||
-L or --check-symlink-times |
This option causes Make to consider the timestamps on any symbolic links in addition to the timestamp on the file referenced by those links. When this option is provided, the most recent timestamp among the file and the symbolic links is taken as the modification time for this target file. | ||||||||||||||||
-n or --just-print or --dry-run or --recon |
Do not actually run any commands - just print them. | ||||||||||||||||
-o <file> or --old-file <file> or --assume-old <file> |
Consider file <file> to be very old and do not remake it. | ||||||||||||||||
-p or --print-data-base |
Print Make's internal database. | ||||||||||||||||
-q or --question |
"Question mode". Do not run any jobs, or print anything; just return an exit status that is zero if the specified targets are already up to date, one if any remaking is required, or two if an error is encountered. | ||||||||||||||||
-r or --no-builtin-rules |
Disable the built-in implicit rules. | ||||||||||||||||
-R or --no-builtin-variables |
Disable the built-in variable settings. | ||||||||||||||||
-s or --silent or --quiet |
Silent operation. | ||||||||||||||||
-S or --no-keep-going or --stop |
Cancel the effect of the -k option. | ||||||||||||||||
-t or --touch |
Touch files (mark them up to date without really changing them) instead of running their recipes. | ||||||||||||||||
-v or --version |
Print Make's version number end exit. | ||||||||||||||||
-w or --print-directory |
Print a message containing the working directory both before and after executing the makefile. | ||||||||||||||||
--no-print-directory | Do not print current directory, even it was enabled (option -w). | ||||||||||||||||
-W <file> or --what-if <file> or --new-file <file> or --assume-new <file> |
Pretend that the target file <file> has just been modified. | ||||||||||||||||
--warn-undefined-variables | Issue a warning message whenever Make sees a reference to an undefined variable. |
ARexx Interface
Make has no ARexx interface.
MakeAudioMode
MakeAudioMode creates audio mode files for AHI.
Incomplete description.
Tool Types
Shell Usage
- Format
- Template
- Location
- SDK:C
ARexx Interface
ModList
Tags: #Debugging
ModList lists the currently installed resident modules.
Tool Types
(none)
Shell Usage
- Format
- MODLIST [SORT] [DEV]
- Template
- SORT/S,DEV/S
- Location
- SDK:C
The options are:
SORT | List modules sorted alphabetically by their IDs. |
DEV | List modules in the following order:
|
ModList displays the following information on each module:
- Priority
- Memory location
- Version
- ID
- ROM residency
- Module type
- Nativity
- Initialization
ARexx Interface
ModList has no ARexx interface.
SH
Amiga Bourne Compatible Shell (ABC Shell).
- Built-in Commands
Command | Description |
---|---|
. (dot) | Reads a specified file and then executes the commands. |
: (colon) | Expands only arguments. |
break | Exits from the enclosing for, while, until, or select loop, if one exists. |
builtin | Run a shell builtin, passing it args, and return its exit status. |
continue | Resumes the next iteration of the enclosing for, while, until, or select loop. |
eval | Reads the arguments as input to the shell and executes the resulting command or commands. |
exec | Executes the command specified by the Argument parameter, instead of this shell, without creating a new process. |
exit | Exits the shell whose exit status is specified by the n parameter. |
return | Causes a shell to return to the invoking script. |
set | Unless options or arguments are specified, writes the names and values of all shell variables in the collation sequence of the current locale. |
shift | Renames positional parameters. |
times | Prints the accumulated user and system times for both the shell and the processes run from the shell. |
trap | Runs a specified command when the shell receives a specified signal or signals. |
wait | |
read | Reads a line from the standard input and parses it. |
test | Evaluate a conditional expression expr and return a status of 0 (true) or 1 (false). |
umask | Set the shell process’s file creation mask to mode. |
unset | Unsets the values and attributes of the specified parameters. |
Incomplete description.
Tool Types
(none)
Shell Usage
- Format
- Template
- Location
- SDK:C
ARexx Interface
SH has no ARexx interface.
TAR
Tags: #Archiving
TAR saves many files together into a single tape or disk archive, and can restore individual files from the archive.
Incomplete description.
Tool Types
Shell Usage
- Format
- Template
- Location
- SDK:C
ARexx Interface
USBSnoop
Tags: #Debugging
USBSnoop is a tool for spying and debugging USB drivers.
Incomplete description.
Tool Types
(none)
Shell Usage
- Format
- USBSNOOP [ACTIVATE]
- Template
- ACTIVATE/S
- Location
- SDK:C
ARexx Interface
USBSnoop has no ARexx interface.