d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

cmp(1): Add EXAMPLES section

Browse Source 
Add a small number of examples depicting the use of -l, -z and byte offsets

Approved by:	0mp@
This commit is contained in:
Fernando Apesteguía 2020-06-20 11:20:16 +00:00
parent 4583682ec1
commit 1831993577
1 changed files with 16 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
usr.bin/cmp/cmp.1
View File

@ -31,7 +31,7 @@
.\" @(#)cmp.1 8.1 (Berkeley) 6/6/93 .\" @(#)cmp.1 8.1 (Berkeley) 6/6/93
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd June 16, 2020 .Dd June 20, 2020
.Dt CMP 1 .Dt CMP 1
.Os .Os
.Sh NAME .Sh NAME
@ -107,26 +107,33 @@ file (before any differences were found).
An error occurred. An error occurred.
.El .El
.Sh EXAMPLES .Sh EXAMPLES
Assuming a file named example.txt with the following contents: Assuming a file named
.Pa example.txt
with the following contents:
.Bd -literal -offset indent .Bd -literal -offset indent
a a
b b
c c
.Ed .Ed
.Pp .Pp
Compare stdin with example.txt: Compare stdin with
.Pa example.txt :
.Bd -literal -offset indent .Bd -literal -offset indent
$ echo -e "a\\nb\\nc" | cmp - example.txt $ echo -e "a\\nb\\nc" | cmp - example.txt
.Ed .Ed
.Pp .Pp
Same as above but introducing a change in byte three in stdin. Same as above but introducing a change in the third byte of stdin.
Show the byte number (decimal) and differing byte (octal): Show the byte number (decimal) and differing byte (octal):
.Bd -literal -offset indent .Bd -literal -offset indent
$ echo -e "a\\nR\\nc" | cmp -l - example.txt $ echo -e "a\\nR\\nc" | cmp -l - example.txt
3 122 142 3 122 142
.Ed .Ed
.Pp .Pp
Compare example.txt and /boot/loader.conf exiting if size differs. Compare file sizes of
.Pa example.txt
and
.Pa /boot/loader.conf
and return 1 if they are not equal.
Note that Note that
.Fl z .Fl z
can only be used with regular files: can only be used with regular files:
@ -135,8 +142,10 @@ $ cmp -z example.txt /boot/loader.conf
example.txt /boot/loader.conf differ: size example.txt /boot/loader.conf differ: size
.Ed .Ed
.Pp .Pp
Compare stdin with file example.txt omitting the 4 first bytes from stdin and Compare stdin with
the 2 first bytes from example.txt: .Pa example.txt
omitting the first 4 bytes from stdin and the first 2 bytes from
.Pa example.txt :
.Bd -literal -offset indent .Bd -literal -offset indent
$ echo -e "a\\nR\\nb\\nc" | cmp - example.txt 4 2 $ echo -e "a\\nR\\nb\\nc" | cmp - example.txt 4 2
.Ed .Ed