mirror of
https://gitlab.rtems.org/rtems/rtos/rtems.git
synced 2025-12-05 15:15:44 +00:00
261 lines
6.5 KiB
Perl
261 lines
6.5 KiB
Perl
@c
|
|
@c COPYRIGHT (c) 1988-2002.
|
|
@c On-Line Applications Research Corporation (OAR).
|
|
@c All rights reserved.
|
|
@c
|
|
@c $Id$
|
|
@c
|
|
|
|
@chapter RTEMS Specific Utilities
|
|
|
|
This section describes the additional commands
|
|
available within the @b{RTEMS Development Environment}. Although
|
|
some of these commands are of general use, most are included to
|
|
provide some capability necessary to perform a required function
|
|
in the development of the RTEMS executive, one of its support
|
|
components, or an RTEMS based application.
|
|
|
|
Some of the commands are implemented as C programs.
|
|
However, most commands are implemented as Bourne shell scripts.
|
|
Even if the current user has selected a different shell, the
|
|
scripts will automatically invoke the Bourne shell during their
|
|
execution lifetime.
|
|
|
|
The commands are presented in UNIX manual page style
|
|
for compatibility and convenience. A standard set of paragraph
|
|
headers were used for all of the command descriptions. If a
|
|
section contained no data, the paragraph header was omitted to
|
|
conserve space. Each of the permissible paragraph headers and
|
|
their contents are described below:
|
|
|
|
@table @code
|
|
@item SYNOPSIS
|
|
describes the command syntax
|
|
|
|
@item DESCRIPTION
|
|
a full description of the command
|
|
|
|
@item OPTIONS
|
|
describes each of the permissible options for the command
|
|
|
|
@item NOTES
|
|
lists any special noteworthy comments about the command
|
|
|
|
@item ENVIRONMENT
|
|
describes all environment variables utilized by the command
|
|
|
|
@item EXAMPLES
|
|
illustrates the use of the command with specific examples
|
|
|
|
@item FILES
|
|
provides a list of major files that the command references
|
|
|
|
@item SEE ALSO
|
|
lists any relevant commands which can be consulted
|
|
@end table
|
|
|
|
Most environment variables referenced by the commands
|
|
are defined for the RTEMS Development Environment during the
|
|
login procedure. During login, the user selects a default RTEMS
|
|
environment through the use of the Modules package. This tool
|
|
effectively sets the environment variables to provide a
|
|
consistent development environment for a specific user.
|
|
Additional environment variables within the RTEMS environment
|
|
were set by the system administrator during installation. When
|
|
specifying paths, a command description makes use of these
|
|
environment variables.
|
|
|
|
When referencing other commands in the SEE ALSO
|
|
paragraph, the following notation is used: command(code).
|
|
Where command is the name of a related command, and code is a
|
|
section number. Valid section numbers are as follows:
|
|
|
|
@table @code
|
|
@item 1
|
|
Section 1 of the standard UNIX documentation
|
|
|
|
@item 1G
|
|
Section 1 of the GNU documentation
|
|
|
|
@item 1R
|
|
a manual page from this document, the RTEMS Development Environment Guide
|
|
@end table
|
|
|
|
For example, ls(1) means see the standard ls command
|
|
in section 1 of the UNIX documentation. gcc020(1G) means see
|
|
the description of gcc020 in section 1 of the GNU documentation.
|
|
|
|
@c
|
|
@c packhex
|
|
@c
|
|
@section packhex - Compress Hexadecimal File
|
|
|
|
@subheading SYNOPSIS
|
|
|
|
@example
|
|
packhex <source >destination
|
|
@end example
|
|
|
|
@subheading DESCRIPTION
|
|
|
|
packhex accepts Intel Hexadecimal or Motorola Srecord
|
|
on its standard input and attempts to pack as many contiguous
|
|
bytes as possible into a single hexadecimal record. Many
|
|
programs output hexadecimal records which are less than 80 bytes
|
|
long (for human viewing). The overhead required by each
|
|
unnecessary record is significant and packhex can often reduce
|
|
the size of the download image by 20%. packhex attempts to
|
|
output records which are as long as the hexadecimal format
|
|
allows.
|
|
|
|
@subheading OPTIONS
|
|
|
|
This command has no options.
|
|
|
|
@subheading EXAMPLES
|
|
|
|
Assume the current directory contains the Motorola
|
|
Srecord file download.sr. Then executing the command:
|
|
|
|
@example
|
|
packhex <download.sr >packed.sr
|
|
@end example
|
|
|
|
will generate the file packed.sr which is usually
|
|
smaller than download.sr.
|
|
|
|
@subheading CREDITS
|
|
|
|
The source for packhex first appeared in the May 1993
|
|
issue of Embedded Systems magazine. The code was downloaded
|
|
from their BBS. Unfortunately, the author's name was not
|
|
provided in the listing.
|
|
|
|
@c
|
|
@c unhex
|
|
@c
|
|
@section unhex - Convert Hexadecimal File into Binary Equivalent
|
|
|
|
@subheading SYNOPSIS
|
|
|
|
@example
|
|
unhex [-valF] [-o file] [file [file ...] ]
|
|
@end example
|
|
|
|
@subheading DESCRIPTION
|
|
|
|
unhex accepts Intel Hexadecimal, Motorola Srecord, or
|
|
TI 'B' records and converts them to their binary equivalent.
|
|
The output may sent to standout or may be placed in a specified
|
|
file with the -o option. The designated output file may not be
|
|
an input file. Multiple input files may be specified with their
|
|
outputs logically concatenated into the output file.
|
|
|
|
@subheading OPTIONS
|
|
|
|
This command has the following options:
|
|
|
|
@table @code
|
|
@item v
|
|
Verbose
|
|
|
|
@item a base
|
|
First byte of output corresponds with base
|
|
address
|
|
|
|
@item l
|
|
Linear Output
|
|
|
|
@item o file
|
|
Output File
|
|
|
|
@item F k_bits
|
|
Fill holes in input with 0xFFs up to k_bits * 1024 bits
|
|
@end table
|
|
|
|
@subheading EXAMPLES
|
|
|
|
The following command will create a binary equivalent
|
|
file for the two Motorola S record files in the specified output
|
|
file binary.bin:
|
|
|
|
@example
|
|
unhex -o binary.bin downloadA.sr downloadB.sr
|
|
@end example
|
|
|
|
@c
|
|
@c size_rtems
|
|
@c
|
|
@section size_rtems - report RTEMS size information
|
|
|
|
@subheading SYNOPSIS
|
|
|
|
@example
|
|
size_rtems
|
|
@end example
|
|
|
|
@subheading DESCRIPTION
|
|
|
|
size_rtems analyzes RTEMS and determines all of the
|
|
critical sizing information which is reported in the related
|
|
documentation.
|
|
|
|
@subheading EXAMPLES
|
|
|
|
To generate the RTEMS size report for the currently
|
|
configured processor, execute the following command:
|
|
|
|
@example
|
|
size_rtems
|
|
@end example
|
|
|
|
Although the actual size information will differ, a
|
|
report of the following format will be output:
|
|
|
|
@example
|
|
RTEMS SIZE REPORT
|
|
|
|
CODE DATA BSS
|
|
==================
|
|
MANAGERS: 15988 0 0
|
|
CORE : 4568 0 0
|
|
CPU : 364 0 0
|
|
OVERALL : 20556 0 0
|
|
MINIMUM : 8752 0 0
|
|
|
|
init : 1592 0 0
|
|
tasks : 2440 0 0
|
|
intr : 64 0 0
|
|
clock : 2252 0 0
|
|
sem : 876 0 0
|
|
msg : 1624 0 0
|
|
event : 604 0 0
|
|
signal : 212 0 0
|
|
part : 872 0 0
|
|
region : 844 0 0
|
|
dpmem : 532 0 0
|
|
timer : 424 0 0
|
|
io : 288 0 0
|
|
fatal : 40 0 0
|
|
rtmon : 764 0 0
|
|
mp : 2984 0 0
|
|
|
|
sem : 4 0 0
|
|
msg : 4 0 0
|
|
event : 4 0 0
|
|
signal : 4 0 0
|
|
part : 4 0 0
|
|
region : 4 0 0
|
|
timer : 4 0 0
|
|
dpmem : 4 0 0
|
|
io : 4 0 0
|
|
rtmon : 4 0 0
|
|
mp : 8 0 0
|
|
@end example
|
|
|
|
@subheading SEE ALSO
|
|
|
|
gsize020(1G), gsize386(1G), gsize960(1G)
|
|
|
|
|