|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
System Administration Commands lucompare(1M)
NAME
lucompare - compare boot environments
SYNOPSIS
/usr/sbin/lucompare [-i infile | -t] [-o outfile] BE_name
[-X]
/usr/sbin/lucompare [ -C file [-o outfile]] [-X]
DESCRIPTION
The lucompare command is part of a suite of commands that
make up the Live Upgrade feature of the Solaris operating
environment. See live_upgrade(5) for a description of the
Live Upgrade feature.
The lucompare command compares the contents of the current
boot environment (BE) with the contents of another BE. With
the -C option, lucompare compares file statistics so that
you can determine which files have changed on a BE since a
specified time, such as the creation time of a BE. A speci-
fied BE must be inactive and in the complete state, as
reported by the lustatus(1M) command. Also, a BE cannot have
a copy job scheduled, which is also reported by
lustatus(1M). A specified BE cannot have any partitions
mounted with lumount(1M) or mount(1M).
For each file system defined for a specified BE, lucompare
compares all files with the files with the same pathnames in
the current BE. The files present in the active BE, but not
in the specified BE, and vice-versa, are reported. You also
have the option to specify a list of files to be compared.
If you specify the -C option, instead of doing an absolute
comparison of the current BE with a target BE, lucompare
compares the files in a specified BE with the list of files
recorded in a file. When a BE is created, lucreate(1M)
creates a file named :<BE_name> in /etc/lu/compare. You can
use the -C option to compare the files in a specified BE to
this snapshot in /etc/lu/compare or you can compare the BE
to a file previously created with the -o option. Comparing a
BE to its own snapshot in /etc/lu/compare enables you to
determine which files have changed on the BE since its crea-
tion.
By default, the output of lucompare is written to stdout.
With the -C option, you must use the -o option to specify an
output file. The output for lucompare is a list of files
that differ in permissions, owner, group, or sum, along with
the reason for difference. The output format is shown below:
> active BE
< BE_name
SunOS 5.10 Last change: 21 Dec 2001 1
System Administration Commands lucompare(1M)
reason
> file_name:owner:group:number_of_links:mode:type: size
or major_minor number:checksum
< file_name:owner:group:number_of_links:mode:type: size
or major_minor number:checksum
The above fields are obtained from the stat(2) structure of
the file.
The type field can be one of the following:
SYMLINK symbolic link
FIFO FIFO file
CHRSPC character special
BLKSPC block special
DIR directory
REGFIL regular file
UNKNOW unknown file type
lucompare computes checksums only if the file on the speci-
fied BE matches its counterpart on the active BE in all of
the fields described above. If the checksums differ, lucom-
pare appends the differing checksums to the entries for the
compared files.
The lucompare command requires root privileges.
OPTIONS
The lucompare command has the following options:
-C file Compare file statistics of BE with
those recorded in file. file can be
SunOS 5.10 Last change: 21 Dec 2001 2
System Administration Commands lucompare(1M)
the snapshot created at BE creation
time, /etc/lu/compare/:<BE_name>, or
a file previously created with the
-o option. You must use the -o
option with this option.
-i infile Compare files listed in infile. The
files to be compared should be an
absolute filename. If the entry in
the file is a directory, then com-
parison is recursive with respect to
the directory. Mutually exclusive
of -t.
-o outfile Send output of differences to out-
file. You must use this option if
you use -C.
-t Compare only nonbinary files. This
is achieved by performing a file(1)
command on each file in the tree
walk and only comparing text files.
Mutually exclusive of -i.
-X Enable XML output. Characteristics
of XML are defined in DTD, in
/usr/share/lib/xml/dtd/lu_cli.dtd.<num>,
where <num> is the version number of
the DTD file.
OPERANDS
BE_name
Name of the BE to which the active BE will be compared.
You cannot specify a BE that is involved in another Live
Upgrade operation, or specify a BE for which you have
mounted partitions (using lumount(1M) or mount(1M)).
EXAMPLES
SunOS 5.10 Last change: 21 Dec 2001 3
System Administration Commands lucompare(1M)
Example 1: Checking Differences Since BE Creation
The following command lists the differences in the BE s8u5
between its creation time and the present.
# lucompare -C /etc/lu/compare/:s8u5 -o /var/tmp/compare.out s8u5
Note that /etc/lu/compare/:s8u5 is the file created by
lucreate upon creation of a BE. The list of differences is
sent to /var/tmp/compare.out.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
FILES
/etc/lutab
list of BEs on the system
/usr/share/lib/xml/dtd/lu_cli.dtd.<num>
Live Upgrade DTD (see -X option)
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWluu |
|_____________________________|_____________________________|
SEE ALSO
lu(1M), luactivate(1M), lucancel(1M), lucreate(1M),
lucurr(1M), ludelete(1M), ludesc(1M), lufslist(1M),
lumake(1M), lumount(1M), lurename(1M), lustatus(1M),
luupgrade(1M), lutab(4), attributes(5), live_upgrade(5)
SunOS 5.10 Last change: 21 Dec 2001 4
System Administration Commands lucompare(1M)
NOTES
The lucompare command makes no attempt to reconcile any
differences it detects between BEs.
SunOS 5.10 Last change: 21 Dec 2001 5
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:26:11 GMT 2007
|
Your favourite pages:
No pages logged yet. Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (5334 hits) (openSUSE 10.2)
svn man page (5209 hits) (FreeBSD 6.2)
adv_cap_autoneg man page (4870 hits) (Solaris 10 11_06)
CPAN man page (4607 hits) (Suse Linux 10.1)
ssh man page (4342 hits) (Suse Linux 10.1)
ssh-socks5-proxy-connect man page (2884 hits) (Solaris 10 11_06)
netcat man page (2717 hits) (Suse Linux 10.1)
pprosetup man page (2492 hits) (Solaris 10 11_06)
startproc man page (2471 hits) (Suse Linux 10.1)
signal man page (2408 hits) (Suse Linux 10.1)
|