The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

 NAME

dircmp - directory comparison (LEGACY)

 SYNOPSIS



dircmp [-ds] dir1 dir2

 DESCRIPTION

The dircmp utility examines the directory hierarchies specified by dir1 and dir2 and generates various tabulated information about the contents of the directories. Sorted listings of files that are unique to each directory are generated for all the options. If no option is specified, a list is output that indicates whether the filenames common to both directories have the same contents.

 OPTIONS

The dircmp utility supports the XBD specification, Utility Syntax Guidelines  . The following options are supported:
-d
Compare the contents of files with the same name in both directories and output a list indicating what must be changed in the two files to bring them into agreement. The list format is described in diff.
-s
Suppress messages about identical files.

 OPERANDS

The following operands are supported:
dir1
dir2
A pathname of a directory to be compared.

 STDIN

Not used.

 INPUT FILES

None.

 ENVIRONMENT VARIABLES

The following environment variables may affect the execution of dircmp:
LANG
Provide a default value for the internationalisation variables that are unset or null. If LANG is unset or null, the corresponding value from the implementation-dependent default locale will be used. If any of the internationalisation variables contains an invalid setting, the utility will behave as if none of the variables had been defined.
LC_ALL
If set to a non-empty string value, override the values of all the other internationalisation variables.
LC_COLLATE
Determine the locale for the ordering of the output.
LC_CTYPE
Determine the locale for the interpretation of sequences of bytes of text data as characters (for example, single- as opposed to multi-byte characters in arguments and input files).
LC_MESSAGES
Determine the locale that should be used to affect the format and contents of diagnostic messages written to standard error.
NLSPATH
Determine the location of message catalogues for the processing of LC_MESSAGES .

 ASYNCHRONOUS EVENTS

Default.

 STDOUT

The output format of dircmp is unspecified, but includes:

 STDERR

Used only for diagnostic messages.

 OUTPUT FILES

None.

 EXTENDED DESCRIPTION

None.

 EXIT STATUS

The following exit values are returned:
0
Successful completion.
>0
An error occurred. (Differences in directory contents are not considered errors.)

 CONSEQUENCES OF ERRORS

Default.

 APPLICATION USAGE

Applications should migrate to the diff -r command.

 EXAMPLES

None.

 FUTURE DIRECTIONS

None.

 SEE ALSO

cmp, diff.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]