From aed2d9575f511061525b68711bd43d6ecd18926d Mon Sep 17 00:00:00 2001
From: Kern Sibbald <kern@sibbald.com>
Date: Thu, 21 Jul 2005 18:31:29 +0000
Subject: [PATCH] Update doc

---
 docs/.cvsignore         |  9 ++++++++-
 docs/manual/.cvsignore  |  1 +
 docs/manual/restore.tex | 42 +++++++++++++++++++++++++++++++++++++++--
 3 files changed, 49 insertions(+), 3 deletions(-)

diff --git a/docs/.cvsignore b/docs/.cvsignore
index c0ebe344..c3bcc2c0 100644
--- a/docs/.cvsignore
+++ b/docs/.cvsignore
@@ -1,6 +1,13 @@
-latex-fr-base
+manual-fr-base
+manual-de-base
 diff
 Makefile
 1
 2
 3
+autom4te.cache
+bacula-doc-*
+config.log
+config.out
+config.status
+kernsconfig
diff --git a/docs/manual/.cvsignore b/docs/manual/.cvsignore
index bea8b4a8..44b4938e 100644
--- a/docs/manual/.cvsignore
+++ b/docs/manual/.cvsignore
@@ -41,3 +41,4 @@ images.tex
 developersi.tex
 baculai-*.tex
 Makefile
+version.tex
diff --git a/docs/manual/restore.tex b/docs/manual/restore.tex
index 021f0a34..01915d59 100644
--- a/docs/manual/restore.tex
+++ b/docs/manual/restore.tex
@@ -1013,12 +1013,50 @@ FileIndex=1-1
   The disadvantage of this bootstrap file compared to what is created when you
   ask for one to be written, is that there is no File and Block specified, so
   the restore code must search all data in the Volume to find the requested
-  file. 
+  file. A fully specified bootstrap file would have the File and Blocks specified
+  as follows:
+\footnotesize
+\begin{verbatim}
+Volume="DLT-22Apr05"
+VolSessionId=11
+VolSessionTime=1114075126
+VolFile=118-118
+VolBlock=0-4053
+FileIndex=1-1
+\end{verbatim}
+\normalsize
 \item [Problem]
   You don't have a bootstrap file, and you don't have the Job report for
   the backup of your database, but you did backup the database, and you
   know the Volume to which it was backed up.
   
 \item [Solution]
-  
+  Use {\bf bls} to indicate where it is on the tape. For example:
+
+\footnotesize
+\begin{verbatim}
+./bls -j -V DLT-22Apr05 /dev/nst0
+\end{verbatim}
+\normalsize
+  Might produce the following output:
+\footnotesize
+\begin{verbatim}
+bls: butil.c:258 Using device: "/dev/nst0" for reading.
+21-Jul 18:34 bls: Ready to read from volume "DLT-22Apr05" on device "DLTDrive" (/dev/nst0).
+Volume Record: File:blk=0:0 SessId=11 SessTime=1114075126 JobId=0 DataLen=164
+...
+Begin Job Session Record: File:blk=118:0 SessId=11 SessTime=1114075126 JobId=7510
+   Job=CatalogBackup.2005-04-22_01.10.0 Date=22-Apr-2005 10:21:00 Level=F Type=B
+End Job Session Record: File:blk=118:4053 SessId=11 SessTime=1114075126 JobId=7510
+   Date=22-Apr-2005 10:23:06 Level=F Type=B Files=1 Bytes=210,739,395 Errors=0 Status=T
+...
+21-Jul 18:34 bls: End of Volume at file 201 on device "DLTDrive" (/dev/nst0), Volume "DLT-22Apr05"
+21-Jul 18:34 bls: End of all volumes.
+\end{verbatim}
+\normalsize
+  Of course, there will be many more records printed, but we have indicated
+  the essential lines of output. From the information on the Begin Job and End 
+  Job Session Records, you can reconstruct a bootstrap file such as the one
+  shown above.
+
 \end{description}
-- 
2.39.5