1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
[% # $Id: vbindiff.pod.tt 4752 2008-06-26 00:40:57Z cjm $ %]
[% IF Win32 %]
| perl maketxt.pl ../VBinDiff.txt
[% ELSE %]
| pod2man --center="Christopher J. Madsen" --release="VBinDiff [% version %]" --name=VBINDIFF - ../vbindiff.1
[% END %]
----------------------------------------------------------------------
=head1 NAME
[% IF Win32 AND !HTML %]
===============================================================================
[% PERL %]
# Generate title line:
# VBinDiff Visual Binary Diff 0.xx DD-Mmm-YYYY
use Date::Format 'time2str';
my $line = 'VBinDiff';
my $center = sprintf '%s %s', $stash->get('name'), $stash->get('version');
my $date = time2str('%e-%b-%Y', time);
$line .= (' ' x (int((79 - length $center) / 2) - length $line)) . $center;
$line .= (' ' x (79 - length($line) - length($date))) . $date . "\n";
print $line
[% END %]
===============================================================================
Copyright 1995-2008 Christopher J. Madsen
[% ELSE %]
vbindiff - hexadecimal file display and comparison
[% END %]
=head1 SYNOPSIS
B<vbindiff> I<file1> [ I<file2> ]
=head1 DESCRIPTION
Visual Binary Diff (VBinDiff) displays files in hexadecimal and ASCII
(or EBCDIC). It can also display two files at once, and highlight
the differences between them. Unlike B<diff>, it works well with
large files (up to 4 GB).
=head2 Viewing files
Movement Keys
-------------
Up Move one line (16 bytes) towards the beginning of the file
Down Move one line (16 bytes) towards the end of the file
Left Move one byte towards the beginning of the file
Right Move one byte towards the end of the file
PageUp Move one page towards the beginning of the file
PageDn Move one page towards the end of the file
Home Move to the beginning of the file
End Move to the end of the (shorter) file
F Search for a string or byte sequence
G Move to a specified file position
When displaying two files, both files move together. If bytes have
been added or removed in one of the files, you can adjust the
comparison by moving just one of the files.
[% IF Win32 %]
Holding down Alt while using the movement keys will scroll only the
bottom file. Holding down Ctrl will scroll only the top file.
[% ELSE %]
To move only the top file, press C<T>. To move only the bottom file,
press C<B>. To return to moving both files, press the same key again.
(The window at the bottom of the screen will indicate when you are
moving only one file.)
[% END %]
Other Keys
----------
Enter Move to the next difference between the files
Space (same as Enter)
C Toggle between ASCII and EBCDIC display
E Edit currently displayed section of file
Esc Exit VBinDiff
Q Exit VBinDiff
The C<Enter> key will advance to the next difference between the files
(after those already displayed on the screen). If there are no more
differences, it moves to the end.
=head2 Line editor
The line editor is used to enter search strings and file positions.
It uses the basic Emacs-style editing keys.
Keys
-----------------
Ctrl-B, Left Move the cursor one character left
Ctrl-F, Right Move the cursor one character right
Ctrl-A, Home Move to the beginning of the line
Ctrl-E, End Move to the end of the line
Ctrl-P, Up Move up in input history
Ctrl-N, Down Move down in input history
Ctrl-H, Backspace Delete the character to the left
Ctrl-D, Delete Delete the character under the cursor
Ctrl-K Delete from cursor to end of line
Insert Toggle between insert & overstrike mode
Enter Finished entering text
Esc Abort the operation
=head2 Editing files
You can press C<E> to edit the current file. When displaying two
files, this edits the one in the top window[% IF Win32 %]
. Press C<Alt+E> to edit the file in the bottom window.
[% ELSE %]
, unless you are in "move bottom" mode.
[% END %]
When editing, you can move the cursor around with the arrow keys. Use
TAB to switch between entering hexadecimal or ASCII (or EBCDIC)
characters. Press the Esc key when you are done. You will be given
the choice to save or discard your changes then.
If you are displaying two files, you can use the Enter key to copy a
byte from the other file into the one you are editing.
You cannot scroll through the file while editing, although you can
save your changes and then move to a different part of the file.
Also, you cannot insert or delete bytes, only change them.
=head1 OPTIONS
-L, --license Display license information for vbindiff
-V, --version Display the version number
--help Display help information
=head1 BUGS
Does not work properly with files over 4 gigabytes. It should be
able to view the first 4 gigabytes ok, but the display only has room
for 8 hex digits of file position, and the Goto box is also limited to
8 digits.
=head1 LICENSE
VBinDiff is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
VBinDiff is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with VBinDiff (see the file COPYING[% '.txt' IF Win32 %]); if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
=head1 AUTHOR
Christopher J. Madsen <vbindiff .at. cjmweb.net>
L<http://www.cjmweb.net/vbindiff/>
|
