rtl-config.1

上传的是rtlinux的源码包

.\" This -*- nroff -*- file has been generated from
.\" DocBook SGML with docbook-to-man on Debian GNU/Linux.
...\"
...\"	transcript compatibility for postscript use.
...\"
...\"	synopsis:  .P! <file.ps>
...\"
.de P!
\\&.
.fl			\" force out current output buffer
\\!%PB
\\!/showpage{}def
...\" the following is from Ken Flowers -- it prevents dictionary overflows
\\!/tempdict 200 dict def tempdict begin
.fl			\" prolog
.sy cat \\$1\" bring in postscript file
...\" the following line matches the tempdict above
\\!end % tempdict %
\\!PE
\\!.
.sp \\$2u	\" move below the image
..
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
'\" t 
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n  
.TH "rtl-config" "1" 
.SH "NAME" 
rtl-config \(em script used to get information about the installed 
version of RTLinux  
.SH "SYNOPSIS" 
.PP 
.nf 
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
\fBrtl-config\fP \fB[options]\fR      
.fi 
.SH "DESCRIPTION" 
.PP 
\fBrtl-config\fP is a tool that is used to 
determine the compiler and linker flags that should be used to 
compile and link programs that use RTLinux.   
 
.SH "OPTIONS" 
.PP 
\fBrtl-config\fP accepts the following 
options (Note that without options, 
\fBrtl-config\fP has the same effect as typing 
"\fBrtl-config --help\fP") 
.IP "\fB--help\fP" 10 
prints 
out useful usage information 
.IP "\fB--config=\fP\fB/path/to/config/file\fR" 10 
uses the specified file as the new 
configuration file to from which to parse all information 
used 
.IP "\fB--modules\fP" 10 
returns the full list of RTLinux 
modules 
.IP "\fB--module_dir\fP" 10 
returns the full path to the RTLinux 
modules 
.IP "\fB--linux\fP" 10 
returns the full path to the Linux source 
tree 
.IP "\fB--prefix\fP" 10 
returns the full path to the RTLinux source 
tree 
.IP "\fB--arch\fP" 10 
returns the machine architecture for which RTLinux was 
compiled 
.IP "\fB--version\fP" 10 
returns the versions of the 
\fBrtl-config\fP script, Linux, and 
RTLinux 
.IP "\fB--rtlVersion\fP" 10 
returns the version of the RTLinux 
kernel 
.IP "\fB--linuxVersion\fP" 10 
returns the version of the Linux 
kernel 
.IP "\fB--cc\fP" 10 
returns 
the name of the compiler used to compile 
RTLinux 
.IP "\fB--docs\fP" 10 
returns 
the root path to the RTLinux documentation 
directory. 
.IP "\fB--include\fP" 10 
returns the full list of include file paths used 
during the compilation process for \fInon Real 
Time\fP programs. It is presented in a form 
that is acceptable to the compiler (refer to both --cc and 
--rtinclude). 
 
.IP "\fB--rtinclude\fP" 10 
returns the full list of include file paths used 
during the compilation process of \fIReal 
Time\fP programs. It is presented in a form 
acceptable to the compiler (refer to both --cc and 
--include). 
 
.IP "\fB--cflags\fP" 10 
returns the full list of optimization flags, and 
general other C flags necessary to compile the user's 
RT modules in C 
.IP "\fB--cppflags\fP" 10 
returns the full list of optimization flags, and 
general other flags necessary to compile the user's RT 
modules in C++  
.IP "\fB--mk\fP" 10 
prints to 
\fBstdout\fP a full Makefile-compatible 
file that can be included into the user's 
Makefiles.  This output is a replica of the old rtl.mk 
file that has been available since older RTLinux 
distributions. 
.SH "EXAMPLES" 
.PP 
The following example demonstrates a typical usage of 
\fBrtl-config\fP.  It compiles the user's 
\fBmy_module.c\fP with all the necessary flags, 
include file paths, libraries, and optimization flags: 
.PP 
\fBgcc -c `rtl-config --cflags` my_module.c\fP 
.PP 
The following example creates a Makefile compatible include 
file rtl.mk in the user's "Projects" directory: 
.PP 
\fBrtl-config --mk > Projects/rtl.mk\fP 
.SH "RETURN VALUE" 
.PP 
\fBrtl-config\fP returns 0 on success and a 
non-zero error code on error. 
 
.SH "NOTES" 
.PP 
Unless the \fB--config=...\fP option is specified 
at the command line, this script extracts its information from 
the file \fB/usr/include/rtlinux/rtl.config\fP      
.SH "AUTHOR" 
.PP 
Edgar F. Hilton (\[e-mail] (link to URL mailto:[e-mail]) \fR) 
 
.SH "SEE ALSO" 
\fIrtlinux(1) (link to URL rtlinux.1.html) \fR 
.PP 
\(co2001 FSMLabs Inc. 
.PP 
All rights reserved. 
...\" created by instant / docbook-to-man, Wed 13 Jun 2001, 17:58