File: savedump.1

package info (click to toggle)
dumputils 1.0.0-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 184 kB
  • ctags: 175
  • sloc: ansic: 2,403; makefile: 133; sh: 88
file content (129 lines) | stat: -rw-r--r-- 3,179 bytes parent folder | download
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
.\" Process this file with
.\" groff -man -Tascii savedump.1
.\"
.TH savedump 1 "October 2004" Linux "Linux User's Manual"
.SH NAME
savedump \- copy LKCD dump image from raw block device to a filesystem or ftp site. 
.SH SYNOPSIS
.B savedump [
.I [-r dumpdevice]
.B || 
.I [-e dumpdevice]
.B ]
.I [-d dumpdevice] [-o dump-path]
.SH DESCRIPTION
.B savedump
copies a LKCD dump image from a raw block device to a filesystem or a ftp site.
Savedump is generally run via /etc/init.d/dumputils on bootup, to automate dump
recovery. Once invoked savedump reads it's configuration information from
/etc/dumputils.conf.

.BR dumpdevice: 

The dumpdevice argument is the dump device that holds the raw LKCD dump.  such
as: /dev/vmdump

.BR dump-path:

The dump-path argument is the path to store the resulting dump file to.  It may
be a path on a filesystem or a FTP URL in the form.
ftp://user:password@host:port/path where user, password, port & path are
optional.
.SH OPTIONS
.IP [-r]
Reset the raw LKCD dump from the dumpdevice, option is exclusive of -e
.IP [-e]
Erase the raw LKCD dump from the dumpdevice, option is exclusive of -r
.IP [-d]
Specify the dumpdevice overriding DUMPDEV= /etc/dumputils.conf file.
.IP [-o]
Specify the dump-path overriding DUMPDIR= in the /etc/dumputils.conf file.
.SH RETURN VALUES
.IP 10 
malloc() returned NULL, could not allocate memory

.B Establishing FTP connection
.IP 20 
gethostbyname() returned 0, could not resolve hostname
.IP 21 
socket() returned -1, could not create socket
.IP 22 
connect() returned -1, could not connect to socket
.IP 23
FTP, timeout waiting for response from server
.IP 24
FTP, timeout while writing to server.
.IP 31 
fdopen() returned NULL, could not create filestream
.IP 32 
FTP, protocol error when getting response from server
.IP 33 
FTP, USER command failed.
.IP 34 
FTP, invalid user
.IP 35 
FTP, invalid login (password)
.IP 36 
FTP, SYST command failed
.IP 37
FTP, bad response to SYST
.IP 38
FTP, Could not open file

.B Accessing DUMPDEVICE
.IP 40 
stat() returned -1, Can not stat DUMPDEVICE
.IP 41 
DUMPDEVICE is not a valid block device

.B Parsing /etc/dumputils.conf
.IP 50
No valid DUMPDEV= parameter found in /etc/duputils.conf
.IP 51
No valid DUMPDIR= parameter found in /etc/duputils.conf
.IP 53
Can not open /etc/duputils.conf

.B General Errors
.IP 60 
Must be root to run savedump.
.IP 61 
Failed to mark dump as erased
.IP 62 
Failed to mark dump as valid (reset)
.IP 63 
Error parsing arguments
.IP 64 
stat() returned -1, Can not stat DUMPDIR (output)
.IP 65 
DUMPDIR is not a directory
.IP 66
fcntl failed

.B Parsing FTP URL
.IP 71 
URL is > 500 characters
.IP 72 
Not a RFC 1738 compliant URL

.B Local filesystem 
.IP 81 
Could not open or write to file, it may already exist, or you don't have permission
.IP 82 
Could not open /boot/System.map for read
.IP 83 
Could not open dump partition for read
.IP 84 
read, write or seek failed on dump partition 
.IP 85 
Invalid dump header.
.IP 86 
Could not write dump, dump header, or dump page
.IP 87 
Dump is nothing but header
.IP 88 
Dump page read error
.IP 89 
Corruped dump, dump truncated
.SH AUTHOR
Troy Heber <troy.heber@hp.com>