|
Packit |
7cfc04 |
'\" et
|
|
Packit |
7cfc04 |
.TH CXREF "1P" 2013 "IEEE/The Open Group" "POSIX Programmer's Manual"
|
|
Packit |
7cfc04 |
.SH PROLOG
|
|
Packit |
7cfc04 |
This manual page is part of the POSIX Programmer's Manual.
|
|
Packit |
7cfc04 |
The Linux implementation of this interface may differ (consult
|
|
Packit |
7cfc04 |
the corresponding Linux manual page for details of Linux behavior),
|
|
Packit |
7cfc04 |
or the interface may not be implemented on Linux.
|
|
Packit |
7cfc04 |
|
|
Packit |
7cfc04 |
.SH NAME
|
|
Packit |
7cfc04 |
cxref
|
|
Packit |
7cfc04 |
\(em generate a C-language program cross-reference table
|
|
Packit |
7cfc04 |
(\fBDEVELOPMENT\fP)
|
|
Packit |
7cfc04 |
.SH SYNOPSIS
|
|
Packit |
7cfc04 |
.LP
|
|
Packit |
7cfc04 |
.nf
|
|
Packit |
7cfc04 |
cxref \fB[\fR\(mics\fB] [\fR\(mio \fIfile\fB] [\fR\(miw \fInum\fB] [\fR\(miD \fIname\fB[\fR=\fIdef\fB]]\fR...\fB [\fR\(miI \fIdir\fB]\fR...
|
|
Packit |
7cfc04 |
\fB[\fR\(miU \fIname\fB]\fR... \fIfile\fR...
|
|
Packit |
7cfc04 |
.fi
|
|
Packit |
7cfc04 |
.SH DESCRIPTION
|
|
Packit |
7cfc04 |
The
|
|
Packit |
7cfc04 |
.IR cxref
|
|
Packit |
7cfc04 |
utility shall analyze a collection of C-language
|
|
Packit |
7cfc04 |
.IR file s
|
|
Packit |
7cfc04 |
and attempt to build a cross-reference table. Information from
|
|
Packit |
7cfc04 |
.BR #define
|
|
Packit |
7cfc04 |
lines shall be included in the symbol table. A sorted listing shall be
|
|
Packit |
7cfc04 |
written to standard output of all symbols (auto, static, and global) in
|
|
Packit |
7cfc04 |
each
|
|
Packit |
7cfc04 |
.IR file
|
|
Packit |
7cfc04 |
separately, or with the
|
|
Packit |
7cfc04 |
.BR \(mic
|
|
Packit |
7cfc04 |
option, in combination. Each symbol shall contain an
|
|
Packit |
7cfc04 |
<asterisk>
|
|
Packit |
7cfc04 |
before the declaring reference.
|
|
Packit |
7cfc04 |
.SH OPTIONS
|
|
Packit |
7cfc04 |
The
|
|
Packit |
7cfc04 |
.IR cxref
|
|
Packit |
7cfc04 |
utility shall conform to the Base Definitions volume of POSIX.1\(hy2008,
|
|
Packit |
7cfc04 |
.IR "Section 12.2" ", " "Utility Syntax Guidelines",
|
|
Packit |
7cfc04 |
except that the order of the
|
|
Packit |
7cfc04 |
.BR \(miD ,
|
|
Packit |
7cfc04 |
.BR \(miI ,
|
|
Packit |
7cfc04 |
and
|
|
Packit |
7cfc04 |
.BR \(miU
|
|
Packit |
7cfc04 |
options (which are identical to their interpretation by
|
|
Packit |
7cfc04 |
.IR c99 )
|
|
Packit |
7cfc04 |
is significant. The following options shall be supported:
|
|
Packit |
7cfc04 |
.IP "\fB\(mic\fP" 10
|
|
Packit |
7cfc04 |
Write a combined cross-reference of all input files.
|
|
Packit |
7cfc04 |
.IP "\fB\(mis\fP" 10
|
|
Packit |
7cfc04 |
Operate silently; do not print input filenames.
|
|
Packit |
7cfc04 |
.IP "\fB\(mio\ \fIfile\fR" 10
|
|
Packit |
7cfc04 |
Direct output to named
|
|
Packit |
7cfc04 |
.IR file .
|
|
Packit |
7cfc04 |
.IP "\fB\(miw\ \fInum\fR" 10
|
|
Packit |
7cfc04 |
Format output no wider than
|
|
Packit |
7cfc04 |
.IR num
|
|
Packit |
7cfc04 |
(decimal) columns. This option defaults to 80 if
|
|
Packit |
7cfc04 |
.IR num
|
|
Packit |
7cfc04 |
is not specified or is less than 51.
|
|
Packit |
7cfc04 |
.IP "\fB\(miD\fP" 10
|
|
Packit |
7cfc04 |
Equivalent to
|
|
Packit |
7cfc04 |
.IR c99 .
|
|
Packit |
7cfc04 |
.IP "\fB\(miI\fP" 10
|
|
Packit |
7cfc04 |
Equivalent to
|
|
Packit |
7cfc04 |
.IR c99 .
|
|
Packit |
7cfc04 |
.IP "\fB\(miU\fP" 10
|
|
Packit |
7cfc04 |
Equivalent to
|
|
Packit |
7cfc04 |
.IR c99 .
|
|
Packit |
7cfc04 |
.SH OPERANDS
|
|
Packit |
7cfc04 |
The following operand shall be supported:
|
|
Packit |
7cfc04 |
.IP "\fIfile\fR" 10
|
|
Packit |
7cfc04 |
A pathname of a C-language source file.
|
|
Packit |
7cfc04 |
.SH STDIN
|
|
Packit |
7cfc04 |
Not used.
|
|
Packit |
7cfc04 |
.SH "INPUT FILES"
|
|
Packit |
7cfc04 |
The input files are C-language source files.
|
|
Packit |
7cfc04 |
.SH "ENVIRONMENT VARIABLES"
|
|
Packit |
7cfc04 |
The following environment variables shall affect the execution of
|
|
Packit |
7cfc04 |
.IR cxref :
|
|
Packit |
7cfc04 |
.IP "\fILANG\fP" 10
|
|
Packit |
7cfc04 |
Provide a default value for the internationalization variables that are
|
|
Packit |
7cfc04 |
unset or null. (See the Base Definitions volume of POSIX.1\(hy2008,
|
|
Packit |
7cfc04 |
.IR "Section 8.2" ", " "Internationalization Variables"
|
|
Packit |
7cfc04 |
for the precedence of internationalization variables used to determine
|
|
Packit |
7cfc04 |
the values of locale categories.)
|
|
Packit |
7cfc04 |
.IP "\fILC_ALL\fP" 10
|
|
Packit |
7cfc04 |
If set to a non-empty string value, override the values of all the
|
|
Packit |
7cfc04 |
other internationalization variables.
|
|
Packit |
7cfc04 |
.IP "\fILC_COLLATE\fP" 10
|
|
Packit |
7cfc04 |
.br
|
|
Packit |
7cfc04 |
Determine the locale for the ordering of the output.
|
|
Packit |
7cfc04 |
.IP "\fILC_CTYPE\fP" 10
|
|
Packit |
7cfc04 |
Determine the locale for the interpretation of sequences of bytes of
|
|
Packit |
7cfc04 |
text data as characters (for example, single-byte as opposed to
|
|
Packit |
7cfc04 |
multi-byte characters in arguments and input files).
|
|
Packit |
7cfc04 |
.IP "\fILC_MESSAGES\fP" 10
|
|
Packit |
7cfc04 |
.br
|
|
Packit |
7cfc04 |
Determine the locale that should be used to affect the format and
|
|
Packit |
7cfc04 |
contents of diagnostic messages written to standard error.
|
|
Packit |
7cfc04 |
.IP "\fINLSPATH\fP" 10
|
|
Packit |
7cfc04 |
Determine the location of message catalogs for the processing of
|
|
Packit |
7cfc04 |
.IR LC_MESSAGES .
|
|
Packit |
7cfc04 |
.SH "ASYNCHRONOUS EVENTS"
|
|
Packit |
7cfc04 |
Default.
|
|
Packit |
7cfc04 |
.SH STDOUT
|
|
Packit |
7cfc04 |
The standard output shall be used for the cross-reference listing,
|
|
Packit |
7cfc04 |
unless the
|
|
Packit |
7cfc04 |
.BR \(mio
|
|
Packit |
7cfc04 |
option is used to select a different output file.
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
The format of standard output is unspecified, except that the following
|
|
Packit |
7cfc04 |
information shall be included:
|
|
Packit |
7cfc04 |
.IP " *" 4
|
|
Packit |
7cfc04 |
If the
|
|
Packit |
7cfc04 |
.BR \(mic
|
|
Packit |
7cfc04 |
option is not specified, each portion of the listing shall start
|
|
Packit |
7cfc04 |
with the name of the input file on a separate line.
|
|
Packit |
7cfc04 |
.IP " *" 4
|
|
Packit |
7cfc04 |
The name line shall be followed by a sorted list of symbols, each with
|
|
Packit |
7cfc04 |
its associated location pathname, the name of the function in which it
|
|
Packit |
7cfc04 |
appears (if it is not a function name itself), and line number
|
|
Packit |
7cfc04 |
references.
|
|
Packit |
7cfc04 |
.IP " *" 4
|
|
Packit |
7cfc04 |
Each line number may be preceded by an
|
|
Packit |
7cfc04 |
<asterisk>
|
|
Packit |
7cfc04 |
(\c
|
|
Packit |
7cfc04 |
.BR '*' )
|
|
Packit |
7cfc04 |
flag, meaning that this is the declaring reference. Other
|
|
Packit |
7cfc04 |
single-character flags, with implementation-defined meanings, may be
|
|
Packit |
7cfc04 |
included.
|
|
Packit |
7cfc04 |
.SH STDERR
|
|
Packit |
7cfc04 |
The standard error shall be used only for diagnostic messages.
|
|
Packit |
7cfc04 |
.SH "OUTPUT FILES"
|
|
Packit |
7cfc04 |
The output file named by the
|
|
Packit |
7cfc04 |
.BR \(mio
|
|
Packit |
7cfc04 |
option shall be used instead of standard output.
|
|
Packit |
7cfc04 |
.SH "EXTENDED DESCRIPTION"
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH "EXIT STATUS"
|
|
Packit |
7cfc04 |
The following exit values shall be returned:
|
|
Packit |
7cfc04 |
.IP "\00" 6
|
|
Packit |
7cfc04 |
Successful completion.
|
|
Packit |
7cfc04 |
.IP >0 6
|
|
Packit |
7cfc04 |
An error occurred.
|
|
Packit |
7cfc04 |
.SH "CONSEQUENCES OF ERRORS"
|
|
Packit |
7cfc04 |
Default.
|
|
Packit |
7cfc04 |
.LP
|
|
Packit |
7cfc04 |
.IR "The following sections are informative."
|
|
Packit |
7cfc04 |
.SH "APPLICATION USAGE"
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH EXAMPLES
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH RATIONALE
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH "FUTURE DIRECTIONS"
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH "SEE ALSO"
|
|
Packit |
7cfc04 |
.IR "\fIc99\fR\^"
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
The Base Definitions volume of POSIX.1\(hy2008,
|
|
Packit |
7cfc04 |
.IR "Chapter 8" ", " "Environment Variables",
|
|
Packit |
7cfc04 |
.IR "Section 12.2" ", " "Utility Syntax Guidelines"
|
|
Packit |
7cfc04 |
.SH COPYRIGHT
|
|
Packit |
7cfc04 |
Portions of this text are reprinted and reproduced in electronic form
|
|
Packit |
7cfc04 |
from IEEE Std 1003.1, 2013 Edition, Standard for Information Technology
|
|
Packit |
7cfc04 |
-- Portable Operating System Interface (POSIX), The Open Group Base
|
|
Packit |
7cfc04 |
Specifications Issue 7, Copyright (C) 2013 by the Institute of
|
|
Packit |
7cfc04 |
Electrical and Electronics Engineers, Inc and The Open Group.
|
|
Packit |
7cfc04 |
(This is POSIX.1-2008 with the 2013 Technical Corrigendum 1 applied.) In the
|
|
Packit |
7cfc04 |
event of any discrepancy between this version and the original IEEE and
|
|
Packit |
7cfc04 |
The Open Group Standard, the original IEEE and The Open Group Standard
|
|
Packit |
7cfc04 |
is the referee document. The original Standard can be obtained online at
|
|
Packit |
7cfc04 |
http://www.unix.org/online.html .
|
|
Packit |
7cfc04 |
|
|
Packit |
7cfc04 |
Any typographical or formatting errors that appear
|
|
Packit |
7cfc04 |
in this page are most likely
|
|
Packit |
7cfc04 |
to have been introduced during the conversion of the source files to
|
|
Packit |
7cfc04 |
man page format. To report such errors, see
|
|
Packit |
7cfc04 |
https://www.kernel.org/doc/man-pages/reporting_bugs.html .
|