~ubuntu-branches/ubuntu/hardy/vsdump/hardy

« back to all changes in this revision

Viewing changes to debian/vsdump.1

  • Committer: Bazaar Package Importer
  • Author(s): Juan Angulo Moreno
  • Date: 2007-08-03 11:00:06 UTC
  • Revision ID: james.westby@ubuntu.com-20070803110006-8xmpmeuv0qpjlobv
Tags: 0.0.40-1
* New upstream release.
* [debian/control] Update description. Thanks to Trent Buck (Closes: #435664)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\"                                      Hey, EMACS: -*- nroff -*-
 
2
.\" First parameter, NAME, should be all caps
 
3
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 
4
.\" other parameters are allowed: see man(7), man(1)
 
5
.TH VSDUMP 1 "jun 26, 2007"
 
6
.\" Please adjust this date whenever revising the manpage.
 
7
.\"
 
8
.\" Some roff macros, for reference:
 
9
.\" .nh        disable hyphenation
 
10
.\" .hy        enable hyphenation
 
11
.\" .ad l      left justify
 
12
.\" .ad b      justify to both left and right margins
 
13
.\" .nf        disable filling
 
14
.\" .fi        enable filling
 
15
.\" .br        insert line break
 
16
.\" .sp <n>    insert n+1 empty lines
 
17
.\" for manpage-specific macros, see man(7)
 
18
.SH NAME
 
19
vsdump \- VSD/VSS file format reverse engineering
 
20
.SH SYNOPSIS
 
21
.B vsdump
 
22
.RB [SUBOPTIONS]
 
23
.RB FILE
 
24
.SH DESCRIPTION
 
25
This manual page documents briefly the
 
26
.B vsdump
 
27
command.
 
28
.PP
 
29
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
 
30
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
 
31
.\" respectively.
 
32
\fBvsdump\fP is an ALT Linux (www.altlinux.ru) project of VSD/VSS file 
 
33
format reverse engineering.
 
34
VSD/VSS is an OLE file. Main data is stored in 'VisioDocument' file 
 
35
inside this OLE. 'VisioDocument' file has a header with version number
 
36
and pointer to the 1st stream.
 
37
Pointers contain Type, Offset to the start, Length, and Format of stream.
 
38
The Format field has a 'compressed' flag (the 2nd least significant bit).
 
39
.PP
 
40
Format == 0x4* is used for streams that contains some strings.
 
41
.br
 
42
Format == 0x5* is used for streams that contains some pointers.
 
43
.br
 
44
Format == 0xd* is used for streams made of chunks.
 
45
.PP
 
46
Type == 15 is used for streams that contains 'Page' data.
 
47
.br
 
48
Type == 23 is used for streams that contains Icons.
 
49
.br
 
50
And so on.
 
51
.PP
 
52
To (de)compress some streams Visio uses some version of LZW 
 
53
algorithmwith options different from other MS-Office applications.
 
54
.PP
 
55
Those streams are made of chunks. Chunks starts with header that contains
 
56
Type and Length fields. Most of chunk types has a mandatory fields and
 
57
some of them has a discretionary fields. The type of chunk imply an order
 
58
and format of mandatory fields and place of start for discretionary fields
 
59
(if any).
 
60
.PP
 
61
The discrepionary fields made of 'blocks'. Blocks start with length, type
 
62
fields and index of variable it is linked to.
 
63
.br
 
64
Blocks made of 'slices'. Every slice can be single byte operation like
 
65
"+" or "*" or 'command' to put one/two bytes data or IEEE-754 fraction
 
66
or stringor name or function into formula.
 
67
.SH SUBOPTIONS
 
68
A summary of options is included below.
 
69
.TP
 
70
.B help
 
71
.br 
 
72
list subcommands
 
73
.TP
 
74
.B dump <file> [directory]
 
75
dump pointers and inflated streams
 
76
.TP
 
77
.B test <file>
 
78
test command table
 
79
.SH AUTHOR
 
80
vsdump was written by Valek Filippov (frob@df.ru)
 
81
.PP
 
82
This manual page was written by Juan Angulo Moreno <juan@apuntale.com>,
 
83
for the Debian project (but may be used by others).