xref: /illumos-gate/usr/src/man/man1/unifdef.1 (revision bbf21555)
te
Copyright (c) 1994 Sun Microsystems, Inc. - All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
UNIFDEF 1 "Jan 14, 1992"
NAME
unifdef - resolve and remove ifdef'ed lines from C program source
SYNOPSIS

unifdef [-clt] [-Dname] [-Uname] [-iDname] [-iUname] ...
 [filename]
DESCRIPTION

unifdef removes ifdefed lines from a file while otherwise leaving the file alone. It is smart enough to deal with the nested ifdefs, comments, single and double quotes of C syntax, but it does not do any including or interpretation of macros. Neither does it strip out comments, though it recognizes and ignores them. You specify which symbols you want defined with -D options, and which you want undefined with -U options. Lines within those ifdefs will be copied to the output, or removed, as appropriate. Any ifdef, ifndef, else, and endif lines associated with filename will also be removed.

ifdefs involving symbols you do not specify are untouched and copied out along with their associated ifdef, else, and endif lines.

If an ifdefX occurs nested inside another ifdefX, then the inside ifdef is treated as if it were an unrecognized symbol. If the same symbol appears in more than one argument, only the first occurrence is significant.

unifdef copies its output to the standard output and will take its input from the standard input if no filename argument is given.

OPTIONS

The following options are supported: -c

Complement the normal operation. Lines that would have been removed or blanked are retained, and vice versa.

-l

Replace ``lines removed'' lines with blank lines.

-t

Plain text option. unifdef refrains from attempting to recognize comments and single and double quotes.

-Dname

Lines associated with the defined symbol name.

-Uname

Lines associated with the undefined symbol name.

-iDname

Ignore, but print out, lines associated with the defined symbol name. If you use ifdefs to delimit non-C lines, such as comments or code which is under construction, then you must tell unifdef which symbols are used for that purpose so that it will not try to parse for quotes and comments within them.

-iUname

Ignore, but print out, lines associated with the undefined symbol name.

EXIT STATUS

The following exit values are returned: 0

Successful operation.

1

Operation failed.

SEE ALSO

diff (1), attributes (7)

DIAGNOSTICS
Premature EOF

Inappropriate else or endif.