From 9a6093aa78f6e2c0cf747f834131086c60f5eeff Mon Sep 17 00:00:00 2001 From: Kern Sibbald Date: Wed, 3 Aug 2005 19:26:46 +0000 Subject: [PATCH] Updates --- docs/Makefile | 6 ++-- docs/Makefile.in | 2 +- docs/developers/Makefile.in | 4 +-- docs/developers/imagename_translations | 21 ++---------- docs/developers/version.tex | 2 +- docs/manual-de/version.tex | 2 +- docs/manual/Makefile.in | 2 +- docs/manual/ansi-labels.tex | 1 - docs/manual/autochangerres.tex | 2 +- docs/manual/autochangers.tex | 16 ++++----- docs/manual/bugs.tex | 2 +- docs/manual/catmaintenance.tex | 2 +- docs/manual/configure.tex | 6 ++-- docs/manual/console.tex | 32 +++++++++--------- docs/manual/consoleconf.tex | 4 +-- docs/manual/copy.tex | 2 +- docs/manual/dirdconf.tex | 46 +++++++++++++------------- docs/manual/disk.tex | 4 +-- docs/manual/dvd.tex | 38 +++++++++++---------- docs/manual/faq.tex | 12 +++---- docs/manual/filedconf.tex | 4 +-- docs/manual/fileset.tex | 22 ++++++------ docs/manual/firewalls.tex | 4 +-- docs/manual/general.tex | 27 ++++++++------- docs/manual/gpl.tex | 18 +++++----- docs/manual/install.tex | 30 ++++++++--------- docs/manual/kaboom.tex | 2 +- docs/manual/lesser.tex | 46 +++++++++++++------------- docs/manual/license.tex | 2 +- docs/manual/messagesres.tex | 10 +++--- docs/manual/mysql.tex | 2 +- docs/manual/oldfileset.tex | 10 +++--- docs/manual/progs.tex | 11 +++--- docs/manual/python.tex | 2 +- docs/manual/quickstart.tex | 4 +-- docs/manual/recycling.tex | 8 ++--- docs/manual/restore.tex | 8 ++--- docs/manual/rpm-faq.tex | 2 +- docs/manual/security.tex | 4 +-- docs/manual/spooling.tex | 4 +-- docs/manual/sqlite.tex | 2 +- docs/manual/state.tex | 2 +- docs/manual/storedconf.tex | 12 +++---- docs/manual/strategies.tex | 2 +- docs/manual/stunnel.tex | 4 +-- docs/manual/supported.tex | 2 +- docs/manual/supportedchangers.tex | 2 +- docs/manual/supporteddrives.tex | 37 ++++++++++----------- docs/manual/supportedoses.tex | 2 +- docs/manual/tapetesting.tex | 2 +- docs/manual/tips.tex | 20 +++++------ docs/manual/tls.tex | 2 +- docs/manual/tutorial.tex | 8 ++--- docs/manual/vars.tex | 4 +-- docs/manual/verify.tex | 3 +- docs/manual/version.tex | 2 +- docs/manual/win32.tex | 14 ++++---- 57 files changed, 264 insertions(+), 282 deletions(-) diff --git a/docs/Makefile b/docs/Makefile index e5415fad..0a0d5888 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -4,9 +4,9 @@ # autoconf/Make.common.in -*- Makefile -*- # release date (man), LSM date, version number/name, current maintainer -DATE="26 July 2005" +DATE="03 August 2005" LSMDATE=@LSMDATE@ -VERSION=1.37.32 +VERSION=1.37.34 VERNAME=bacula-$(VERSION)# MAINT=Kern Sibbald# MAINTEMAIL=# @@ -65,7 +65,7 @@ DIST = Makefile.in all: (cd manual; make) - (cd developers; make developers) + (cd developers; make) configure: autoconf/configure.in autoconf/aclocal.m4 autoconf/acconfig.h autoconf/config.h.in diff --git a/docs/Makefile.in b/docs/Makefile.in index ef021a32..d0b043c7 100644 --- a/docs/Makefile.in +++ b/docs/Makefile.in @@ -23,7 +23,7 @@ DIST = Makefile.in all: (cd manual; make) - (cd developers; make developers) + (cd developers; make) configure: autoconf/configure.in autoconf/aclocal.m4 autoconf/acconfig.h autoconf/config.h.in diff --git a/docs/developers/Makefile.in b/docs/developers/Makefile.in index 7f5b96f3..1da44871 100644 --- a/docs/developers/Makefile.in +++ b/docs/developers/Makefile.in @@ -48,7 +48,7 @@ html: @echo "Making developers html" @cp -fp ${IMAGES}/*.eps . @rm -f next.eps next.png prev.eps prev.png up.eps up.png - @(if [ -e imagename_translations ] ; then \ + @(if [ -f imagename_translations ] ; then \ ./translate_images.pl --from_meaningful_names developers.html; \ fi) latex2html -white -no_subdir -split 0 -toc_stars -white -notransparent \ @@ -64,7 +64,7 @@ web: @rm -f next.eps next.png prev.eps prev.png up.eps up.png @cp -fp ${IMAGES}/*.eps ${IMAGES}/*.png developers/ @rm -f developers/next.eps developers/next.png developers/prev.eps developers/prev.png developers/up.eps developers/up.png - @(if [ -e developers/imagename_translations ] ; then \ + @(if [ -f developers/imagename_translations ] ; then \ ./translate_images.pl --to_meaningful_names developers/Bacula_Users_Guide.html; \ fi) @rm -rf developers/*.html diff --git a/docs/developers/imagename_translations b/docs/developers/imagename_translations index a2078c7e..8cfd734f 100644 --- a/docs/developers/imagename_translations +++ b/docs/developers/imagename_translations @@ -1,19 +1,2 @@ -img4.png./flow.eps -img6.png./Conf-Diagram.eps -img7.png./bimagemgr1.eps -img8.png./bimagemgr2.eps -img10.png./win32-nsis.eps -img12.png./win32-pkg.eps -img13.png./win32-location.eps -img14.png./win32-service.eps -img15.png./win32-service-ok.eps -img16.png./win32-start.eps -img17.png./win32-finish.eps -img18.png./idle.eps -img20.png./menu.eps -img21.png./running.eps -img22.png./error.eps -img23.png./access-is-denied.eps -img25.png./properties-security.eps -img26.png./properties-security-advanced-owner.eps -img27.png./confirm.eps +img1.png./bacula-logo.eps +img2.png./smartall.eps diff --git a/docs/developers/version.tex b/docs/developers/version.tex index 09612cef..e96ec72d 100644 --- a/docs/developers/version.tex +++ b/docs/developers/version.tex @@ -1 +1 @@ -1.37.32 (26 July 2005) +1.37.34 (03 August 2005) diff --git a/docs/manual-de/version.tex b/docs/manual-de/version.tex index 09612cef..e96ec72d 100644 --- a/docs/manual-de/version.tex +++ b/docs/manual-de/version.tex @@ -1 +1 @@ -1.37.32 (26 July 2005) +1.37.34 (03 August 2005) diff --git a/docs/manual/Makefile.in b/docs/manual/Makefile.in index 4c4bdf24..e01e4186 100644 --- a/docs/manual/Makefile.in +++ b/docs/manual/Makefile.in @@ -58,7 +58,7 @@ html: @echo "Making html" @cp -fp ${IMAGES}/*.eps . @rm -f next.eps next.png prev.eps prev.png up.eps up.png - @(if [ -e imagename_translations ] ; then \ + @(if [ -f imagename_translations ] ; then \ ./translate_images.pl --from_meaningful_names bacula.html; \ fi) latex2html -white -no_subdir -split 0 -toc_stars -white -notransparent \ diff --git a/docs/manual/ansi-labels.tex b/docs/manual/ansi-labels.tex index d23e6602..0cb4f680 100644 --- a/docs/manual/ansi-labels.tex +++ b/docs/manual/ansi-labels.tex @@ -59,4 +59,3 @@ and multiple backup programs. In other words, if there is a possibility of Bacula encountering an ANSI/IBM label, you must set this to yes. \end{description} - diff --git a/docs/manual/autochangerres.tex b/docs/manual/autochangerres.tex index 6842542e..9798e08c 100644 --- a/docs/manual/autochangerres.tex +++ b/docs/manual/autochangerres.tex @@ -6,7 +6,7 @@ The Autochanger resource supports single or multiple drive autochangers by grouping one or more Device resources into one unit called an autochanger in Bacula (often referred to -as a ``tape library´´ by autochanger manufacturers). +as a "tape library" by autochanger manufacturers). \begin{description} \item [Name = \lt{}Autochanger-Name\gt{}] diff --git a/docs/manual/autochangers.tex b/docs/manual/autochangers.tex index 658f297b..73e5a2ef 100644 --- a/docs/manual/autochangers.tex +++ b/docs/manual/autochangers.tex @@ -53,8 +53,8 @@ directory that allows Bacula to use the {\bf chio} program. Bacula also supports autochangers with barcode readers. This support includes two Console commands: {\bf label barcodes} -and {\bf update slots}. For more details on these commands, see the ``Barcode -Support'' section below. +and {\bf update slots}. For more details on these commands, see the "Barcode +Support" section below. Current Bacula autochanger support does not include cleaning, stackers, or silos. However, under certain conditions, you may be able to make Bacula @@ -423,7 +423,7 @@ your autochanger one after another by using the {\bf label barcodes} command. For each tape in the changer containing a barcode, Bacula will mount the tape and then label it with the same name as the barcode. An appropriate Media record will also be created in the catalog. Any barcode that begins with the -same characters as specified on the ``CleaningPrefix=xxx'' command, will be +same characters as specified on the "CleaningPrefix=xxx" command, will be treated as a cleaning tape, and will not be labeled. For example with: Please note that Volumes must be pre-labeled to be automatically used in @@ -617,7 +617,7 @@ autochanger testing. mtx-changer Script} Before attempting to use the autochanger with Bacula, it is preferable to -``hand-test'' that the changer works. To do so, we suggest you do the +"hand-test" that the changer works. To do so, we suggest you do the following commands (assuming that the {\bf mtx-changer} script is installed in {\bf /etc/bacula/mtx-changer}): @@ -666,7 +666,7 @@ Assuming you have a tape in slot 3, it will be loaded into the read slot (0). \item [/etc/bacula/mtx-changer \ /dev/sg0 \ loaded \ 0 \ /dev/nst0 \ 0] \index[sd]{/etc/bacula/mtx-changer \ /dev/sg0 \ loaded \ 0 \ /dev/nst0 \ 0 } -It should print ``3'' +It should print "3" \item [/etc/bacula/mtx-changer \ /dev/sg0 \ unload] \index[sd]{/etc/bacula/mtx-changer \ /dev/sg0 \ unload } @@ -728,7 +728,7 @@ As noted earlier, there are several scripts in {\bf \lt{}bacula-source\gt{}/examples/devices} that implement the above features, so they may be a help to you in getting your script to work. -If Bacula complains ``Rewind error on /dev/nst0. ERR=Input/output error.'' you +If Bacula complains "Rewind error on /dev/nst0. ERR=Input/output error." you most likely need more sleep time in your {\bf mtx-changer} before returning to Bacula after a load command has been completed. @@ -818,7 +818,7 @@ before loading the next volume to be labeled. Once all your Volumes are labeled, Bacula will automatically load them as they are needed. -To ``see'' how you have labeled your Volumes, simply enter the {\bf list +To "see" how you have labeled your Volumes, simply enter the {\bf list volumes} command from the Console program, which should print something like the following: @@ -879,7 +879,7 @@ prevent Bacula from attempting to write on the Volume. Bacula calls the autochanger script that you specify on the {\bf Changer Device} statement. Normally this script will be the {\bf mtx-changer} script that we can provide, but it can in fact be any program. The only requirements -are that the ``commands'' that Bacula uses are {\bf loaded}, {\bf load}, {\bf +are that the "commands" that Bacula uses are {\bf loaded}, {\bf load}, {\bf unload}, {\bf list}, and {\bf slots}. In addition, each of those commands must return the information in the precise format as specified below: diff --git a/docs/manual/bugs.tex b/docs/manual/bugs.tex index 2235674b..c9b07450 100644 --- a/docs/manual/bugs.tex +++ b/docs/manual/bugs.tex @@ -18,5 +18,5 @@ the patches that have been created for the previously released version of Bacula. In addition, the file {\bf patches-version-number} in the {\bf patches} directory contains a summary of each of the patches. -A ``raw'' list of the current task list and known issues can be found in {\bf +A "raw" list of the current task list and known issues can be found in {\bf kernstodo} in the main Bacula source directory. diff --git a/docs/manual/catmaintenance.tex b/docs/manual/catmaintenance.tex index 45287f4b..6aeea730 100644 --- a/docs/manual/catmaintenance.tex +++ b/docs/manual/catmaintenance.tex @@ -261,7 +261,7 @@ version. You may begin using Bacula with SQLite then later find that you want to switch to MySQL for any of a number of reasons: SQLite tends to use more disk than MySQL, SQLite apparently does not handle database sizes greater than 2GBytes, -... Several users have done so by first producing an ASCII ``dump'' of the +... Several users have done so by first producing an ASCII "dump" of the SQLite database, then creating the MySQL tables with the {\bf create\_mysql\_tables} script that comes with Bacula, and finally feeding the SQLite dump into MySQL using the {\bf -f} command line option to continue past diff --git a/docs/manual/configure.tex b/docs/manual/configure.tex index fe185f0d..4e60ccc1 100644 --- a/docs/manual/configure.tex +++ b/docs/manual/configure.tex @@ -61,7 +61,7 @@ Director { \end{verbatim} \normalsize -Defines the Director resource with the name ``MyDir'' and a working directory +Defines the Director resource with the name "MyDir" and a working directory \$HOME/bacula/bin/working. In general, if you want spaces in a name to the right of the first equal sign (=), you must enclose that name within double quotes. Otherwise quotes are not generally necessary because once defined, @@ -100,7 +100,7 @@ value is a name, you must enclose the name in double quotes for the spaces to be accepted. Names may contain up to 127 characters. Currently, a name may contain any ASCII character. Within a quoted string, any character following a backslash (\textbackslash{}) is taken as itself (handy for inserting -blackslashes and double quotes (``). +blackslashes and double quotes ("). Please note, however, that Bacula resource names as well as certain other names (e.g. Volume names) will in the future be severely limited to permit @@ -220,7 +220,7 @@ A time or duration specified in seconds. The time is stored internally as a 64 bit integer value, but it is specified in two parts: a number part and a modifier part. The number can be an integer or a floating point number. If it is entered in floating point notation, it will be rounded to the nearest -integer. The modifer is mandatory and follows the number part, either with +integer. The modifier is mandatory and follows the number part, either with or without intervening spaces. The following modifiers are permitted: \begin{description} diff --git a/docs/manual/console.tex b/docs/manual/console.tex index 31f5601c..e1d8e825 100644 --- a/docs/manual/console.tex +++ b/docs/manual/console.tex @@ -333,7 +333,7 @@ autochanger one after another by using the {\bf label barcodes} command. For each tape in the changer containing a barcode, Bacula will mount the tape and then label it with the same name as the barcode. An appropriate Media record will also be created in the catalog. Any barcode that begins with the same -characters as specified on the ``CleaningPrefix=xxx'' directive in the +characters as specified on the "CleaningPrefix=xxx" directive in the Director's Pool resource, will be treated as a cleaning tape, and will not be labeled. However, an entry for the cleaning tape will be created in @@ -443,15 +443,15 @@ Bacula should create a client record in the database the first time you run a job for that client. Doing a {\bf status} will not cause a database record to be created. The client database record will be created whether or not the job fails, but it must at least start. When the Client is actually contacted, -additional info from the client will be added to the client record (a ``uname --a'' output). +additional info from the client will be added to the client record (a "uname +-a" output). If you want to see what Client resources you have available in your conf file, you use the Console command {\bf show clients}. \item [llist] \index[console]{llist } - The llist or ``long list'' command takes all the same arguments that the list + The llist or "long list" command takes all the same arguments that the list command described above does. The difference is that the llist command list the full contents of each database record selected. It does so by listing the various fields of the record vertically, with one field per line. It is @@ -523,7 +523,7 @@ program. \item[python] \index[console]{python} - The python command takes a slingle argument {\bf restart}: + The python command takes a single argument {\bf restart}: python restart @@ -613,13 +613,13 @@ completely release (close) the device. immediately for all new jobs. However, if you change schedules, be aware that the scheduler pre-schedules jobs up to two hours in advance, so any changes that are to take place during the next two - hours may be delayed. Jobs that have already been sheduled to run - (i.e. depassed their requested start time) will continue with the + hours may be delayed. Jobs that have already been scheduled to run + (i.e. surpassed their requested start time) will continue with the old values. New jobs will use the new values. Each time you issue a reload command while jobs are running, the prior config values will queued until all jobs that were running before issuing the reload terminate, at which time the old config values will - be released from memory. The Directory premits keeping up to + be released from memory. The Directory permits keeping up to 10 prior set of configurations before it will refuse a reload command. Once at least one old set of config values has been released it will again accept new reload commands. @@ -800,11 +800,11 @@ In the Running Jobs listing, you may find the following types of information: Looking at the above listing from bottom to top, obviously JobId 5343 (Rufus) is running. JobId 5348 (Minou) is waiting for JobId 5343 to finish because it -is using the Storage resource, hence the ``waiting on max Storage jobs''. +is using the Storage resource, hence the "waiting on max Storage jobs". JobId 5349 has a lower priority than all the other jobs so it is waiting for higher priority jobs to finish, and finally, JobId 2508 (MatouVerify) is -waiting because only one job can run at a time, hence it is simply ``waiting -execution\". +waiting because only one job can run at a time, hence it is simply "waiting +execution" \item [unmount] \index[console]{unmount } @@ -905,7 +905,7 @@ use \lt{}database-name\gt{} it the same way variable expansion is done on the {\bf LabelFormat} string. Thus, for the most part, you can test your LabelFormat strings. The difference between the {\bf var} command and the actual LabelFormat process - is that during the var command, no job is running so ''dummy`` values are + is that during the var command, no job is running so "dummy" values are used in place of Job specific variables. Generally, however, you will get a good idea of what is going to happen in the real case. @@ -1145,9 +1145,9 @@ you will need to label it. Before adding a volume, you must know the following information: \begin{enumerate} -\item The name of the Pool (normally ''Default``) +\item The name of the Pool (normally "Default") \item The Media Type as specified in the Storage Resource in the Director's - configuration file (e.g. ''DLT8000``) + configuration file (e.g. "DLT8000") \item The number and names of the Volumes you wish to create. \end{enumerate} @@ -1192,6 +1192,6 @@ To see what you have added, enter: Notice that the console program automatically appended a number to the base Volume name that you specify (Save in this case). If you don't want it to -append a number, you can simply answer 0 (zero) to the question ''Enter number -of Media volumes to create. Max=1000:``, and in this case, it will create a +append a number, you can simply answer 0 (zero) to the question "Enter number +of Media volumes to create. Max=1000:", and in this case, it will create a single Volume with the exact name you specify. diff --git a/docs/manual/consoleconf.tex b/docs/manual/consoleconf.tex index ad932a2e..d2f44e6a 100644 --- a/docs/manual/consoleconf.tex +++ b/docs/manual/consoleconf.tex @@ -151,7 +151,7 @@ levels. kind of console that was initially implemented in versions prior to 1.33 and remains valid. Typically you would use it only for administrators. \item The second type of console, and new to version 1.33 and higher is a - ``named'' console defined within a Console resource in both the Director's + "named" console defined within a Console resource in both the Director's configuration file and in the Console's configuration file. Both the names and the passwords in these two entries must match much as is the case for Client programs. @@ -171,7 +171,7 @@ directive, is the same as a Client name, the user of that console is permitted to use the {\bf SetIP} command to change the Address directive in the Director's client resource to the IP address of the Console. This permits portables or other machines using DHCP (non-fixed IP addresses) to -``notify'' the Director of their current IP address. +"notify" the Director of their current IP address. \end{itemize} The Console resource is optional and need not be specified. However, if it is diff --git a/docs/manual/copy.tex b/docs/manual/copy.tex index a9eaa420..b2ffc9ec 100644 --- a/docs/manual/copy.tex +++ b/docs/manual/copy.tex @@ -13,7 +13,7 @@ method, for any purpose. \company\ makes no warranty, either express or implied, including but not limited to any implied warranties of merchantability and fitness for a particular purpose, regarding these materials and makes such materials -available solely on an ``as-is'' basis. +available solely on an "as-is" basis. In no event shall \company\ be liable to anyone for special, collateral, incidental, or consequential damages in connection with or arising out of diff --git a/docs/manual/dirdconf.tex b/docs/manual/dirdconf.tex index b8ffdbb9..bd185290 100644 --- a/docs/manual/dirdconf.tex +++ b/docs/manual/dirdconf.tex @@ -369,7 +369,7 @@ For a {\bf Backup} Job, the Level may be one of the following: is all files that have changed since the last successful backup of the specified FileSet. If the Director cannot find a previous Full backup then the job will be upgraded into a Full backup. When the Director looks for a -``suitable'' backup record in the catalog database, it looks for a previous +"suitable" backup record in the catalog database, it looks for a previous Job with: \begin{itemize} @@ -388,13 +388,13 @@ performed as requested. The File daemon (Client) decides which files to backup for an Incremental backup by comparing start time of the prior Job (Full, Differential, or -Incremental) against the time each file was last ``modified'' (st\_mtime) and -the time its attributes were last ``changed''(st\_ctime). If the file was +Incremental) against the time each file was last "modified" (st\_mtime) and +the time its attributes were last "changed"(st\_ctime). If the file was modified or its attributes changed on or after this start time, it will then be backed up. Please note that some virus scanning software may change st\_ctime while -doing the scan. For exaple, if the the virus scanning program attempts to +doing the scan. For example, if the the virus scanning program attempts to reset the access time (st\_atime), which Bacula does not use, it will cause st\_ctime to change and hence Bacula will backup the file during an Incremental or Differential backup. In the case of Sophos virus scanning, you @@ -415,7 +415,7 @@ process and not currently implemented in Bacula. In addition, if you move a directory rather than copy it, the files in it do not have their modification time (st\_mtime) or their attribute change time (st\_ctime) -changed. As a conseqence, those files will probably not be backed up by an +changed. As a consequence, those files will probably not be backed up by an Incremental or Differential backup which depend solely on these time stamps. If you move a directory, @@ -428,7 +428,7 @@ delete the original. is all files that have changed since the last successful Full backup of the specified FileSet. If the Director cannot find a previous Full backup or a suitable Full backup, then the Differential job will be upgraded into a Full -backup. When the Director looks for a ``suitable'' Full backup record in the +backup. When the Director looks for a "suitable" Full backup record in the catalog database, it looks for a previous Job with: \begin{itemize} @@ -447,8 +447,8 @@ performed as requested. The File daemon (Client) decides which files to backup for a differential backup by comparing the start time of the prior Full backup Job against the -time each file was last ``modified'' (st\_mtime) and the time its attributes -were last ``changed'' (st\_ctime). If the file was modified or its attributes +time each file was last "modified" (st\_mtime) and the time its attributes +were last "changed" (st\_ctime). If the file was modified or its attributes were changed on or after this start time, it will then be backed up. The start time used is displayed after the {\bf Since} on the Job report. In rare cases, using the start time of the prior backup may cause some files to be @@ -472,7 +472,7 @@ As noted above, if you move a directory rather than copy it, the files in it do not have their modification time (st\_mtime) or their attribute change time (st\_ctime) -changed. As a conseqence, those files will probably not be backed up by an +changed. As a consequence, those files will probably not be backed up by an Incremental or Differential backup which depend solely on these time stamps. If you move a directory, @@ -882,7 +882,7 @@ program {\bf Special Windows Considerations} The command can be anything that cmd.exe or command.com will recognize as an - executable file. Specifiying the executable's extension is optional, unless + executable file. Specifying the executable's extension is optional, unless there is an ambiguity. (i.e. ls.bat, ls.exe) The System \%Path\% will be searched for the command. (under the envrionment @@ -893,7 +893,7 @@ program System environment variables can be called out using the \%var\% syntax and used as either part of the command name or arguments. - When specifiying a full path to an executable if the path or executable name + When specifying a full path to an executable if the path or executable name contains whitespace or special characters they will need to be quoted. Arguments containing whitespace or special characters will also have to be quoted. @@ -908,7 +908,7 @@ ClientRunBeforeJob = "\"C:/Program Files/Software The special characters \&()[]\{\}\^{}=;!'+,`\~{} will need to be quoted if they are part of a filename or argument. - If someone is logged in, a blank ``command'' window running the commands + If someone is logged in, a blank "command" window running the commands will be present during the execution of the command. @@ -923,13 +923,13 @@ will \item The batch file should explicitly 'exit 0' on successful completion. \item The path to the batch file should be specified in Unix form: - ClientRunBeforeJob = ``c:/bacula/bin/systemstate.bat'' + ClientRunBeforeJob = "c:/bacula/bin/systemstate.bat" rather than DOS/Windows form: ClientRunBeforeJob = -``c:\textbackslash{}bacula\textbackslash{}bin\textbackslash{}systemstate.bat'' +"c:\textbackslash{}bacula\textbackslash{}bin\textbackslash{}systemstate.bat" INCORRECT \end{enumerate} @@ -950,7 +950,7 @@ script is: \end{verbatim} \normalsize -The following line in the Job resoure in the bacula-dir.conf file: +The following line in the Job resource in the bacula-dir.conf file: \footnotesize \begin{verbatim} Client Run Before Job = "su - mercuryd -c \"/u01/mercuryd/backupdb.sh '%t' @@ -1382,7 +1382,7 @@ pseudo-BNF: second | third | forth | fifth = sun | mon | tue | wed | thu | fri | sat | sunday | monday | tuesday | wednesday | - thursday | friday + thursday | friday | saturday = w00 | w01 | ... w52 | w53 = jan | feb | mar | apr | may | jun | jul | aug | sep | oct | nov | dec | january | @@ -1718,7 +1718,7 @@ required. is an arbitrary string of characters up to 127 maximum that you define. It can be anything you want. However, it is best to make it descriptive of the -storage media (e.g. File, DAT, ''HP DLT8000``, 8mm, ...). In addition, it is +storage media (e.g. File, DAT, "HP DLT8000", 8mm, ...). In addition, it is essential that you make the {\bf Media Type} specification unique for each storage media type. If you have two DDS-4 drives that have incompatible formats, or if you have a DDS-4 drive and a DDS-4 autochanger, you almost @@ -2220,7 +2220,7 @@ The {\bf format} should be specified in double quotes, and consists of letters, numbers and the special characters hyphen ({\bf -}), underscore ({\bf \_}), colon ({\bf :}), and period ({\bf .}), which are the legal characters for a Volume name. The {\bf format} should be enclosed in double -quotes (''). +quotes ("). In addition, the format may contain a number of variable expansion characters which will be expanded by a complex algorithm allowing you to create Volume @@ -2229,13 +2229,13 @@ resolve to the set of characters noted above that are legal Volume names. Generally, these variable expansion characters begin with a dollar sign ({\bf \$}) or a left bracket ({\bf [}). If you specify variable expansion characters, you should always enclose the format with double quote characters -({\bf ``}). For more details on variable expansion, please see the +({\bf "}). For more details on variable expansion, please see the \ilink{Variable Expansion}{_ChapterStart50} Chapter of this manual. If no variable expansion characters are found in the string, the Volume name will be formed from the {\bf format} string appended with the number of volumes in the pool plus one, which will be edited as four digits with -leading zeros. For example, with a {\bf Label Format = ''File-``}, the first +leading zeros. For example, with a {\bf Label Format = "File-"}, the first volumes will be named {\bf File-0001}, {\bf File-0002}, ... With the exception of Job specific variables, you can test your {\bf @@ -2434,7 +2434,7 @@ directive. This is the kind of console that was initially implemented in versions prior to 1.33 and remains valid. Typically you would use it only for administrators. \item The second type of console, and new to version 1.33 and higher is a - ''named`` console defined within a Console resource in both the Director's + "named" console defined within a Console resource in both the Director's configuration file and in the Console's configuration file. Both the names and the passwords in these two entries must match much as is the case for Client programs. @@ -2453,12 +2453,12 @@ followed by a list of access names. Examples of this are shown below. directive, is the same as a Client name, that console is permitted to use the {\bf SetIP} command to change the Address directive in the Director's client resource to the IP address of the Console. This permits portables or other -machines using DHCP (non-fixed IP addresses) to ''notify`` the Director of +machines using DHCP (non-fixed IP addresses) to "notify" the Director of their current IP address. \end{itemize} The Console resource is optional and need not be specified. The following -directives are permited within the Director's configuration resource: +directives are permitted within the Director's configuration resource: \begin{description} diff --git a/docs/manual/disk.tex b/docs/manual/disk.tex index f5a7728b..ddf2d1f9 100644 --- a/docs/manual/disk.tex +++ b/docs/manual/disk.tex @@ -247,11 +247,11 @@ following: \item The \ilink{ Recycle Oldest Volume = yes}{RecycleOldest} record in the Pool resource tells Bacula to Prune the oldest volume in the Pool, and if all - files were pruned to recyle this volume and use it. + files were pruned to recycle this volume and use it. \item The \ilink{ Recycle Current Volume = yes}{RecycleCurrent} record in the Pool resource tells Bacula to Prune the currently mounted volume in the - Pool, and if all files were pruned to recyle this volume and use it. + Pool, and if all files were pruned to recycle this volume and use it. \item The \ilink{ Purge Oldest Volume = yes}{PurgeOldest} record in the Pool resource permits a forced recycling of the oldest Volume when a new one diff --git a/docs/manual/dvd.tex b/docs/manual/dvd.tex index a212cd5a..58ca5f7b 100644 --- a/docs/manual/dvd.tex +++ b/docs/manual/dvd.tex @@ -185,36 +185,45 @@ The following directives are added to the Director's Job resource. \addcontentsline{toc}{subsection}{Other Points} \begin{itemize} +\item DVD+RW supports only about 1000 overwrites. Every time you + mount the filesystem read/write will count as one write. This can + add up quickly, so it is best to mount your DVD+RW filesystem read-only. + Bacula does not need the DVD to be mounted read-write, since it uses + the raw device for writing. +\item Reformatting DVD+RW 10-20 times can apparently make the medium + unusable. Normally you should not have to format or reformat + DVD+RW media. If it is necessary, current versions of growisofs will + do so automatically. \item I had several problems writing to DVD-RWs (this does NOT concern DVD+RW), -because these media have two writing-modes: {\bf Incremental Sequential} and -{\bf Restricted Overwrite}. Depending on your device and the media you use, -one of these modes may not work correctly (e.g. {\bf Incremental Sequential} does -not work with my NEC DVD-writer and Verbatim DVD-RW). + because these media have two writing-modes: {\bf Incremental Sequential} and + {\bf Restricted Overwrite}. Depending on your device and the media you use, + one of these modes may not work correctly (e.g. {\bf Incremental Sequential} does + not work with my NEC DVD-writer and Verbatim DVD-RW). -To retrieve the current mode of a DVD-RW, run: + To retrieve the current mode of a DVD-RW, run: \begin{verbatim} dvd+rw-mediainfo /dev/xxx \end{verbatim} -where you replace xxx with your DVD device name. + where you replace xxx with your DVD device name. -{\bf Mounted Media} line should give you the information. + {\bf Mounted Media} line should give you the information. -To set the device to {\bf Restricted Overwrite} mode, run: + To set the device to {\bf Restricted Overwrite} mode, run: \begin{verbatim} dvd+rw-format /dev/xxx \end{verbatim} -If you want to set it back to the default {\bf Incremental Sequential} mode, run: + If you want to set it back to the default {\bf Incremental Sequential} mode, run: \begin{verbatim} dvd+rw-format -blank /dev/xxx \end{verbatim} \item Bacula only accepts to write to blank DVDs. To quick blank a DVD+/-RW, run -this command: + this command: \begin{verbatim} dd if=/dev/zero bs=1024 count=512 | growisofs -Z /dev/xxx=/dev/fd/0 \end{verbatim} -Then, try to mount the device, if it cannot be mounted, it will be considered -as blank by Bacula, if it can be mounted, try a full blank (see below). + Then, try to mount the device, if it cannot be mounted, it will be considered + as blank by Bacula, if it can be mounted, try a full blank (see below). \item If you wish to blank completely a DVD+/-RW, use the following: \begin{verbatim} @@ -225,11 +234,6 @@ as blank by Bacula, if it can be mounted, try a full blank (see below). \item DVD+RW and DVD-RW support only about 1000 overwrites (i.e. don't use the same medium for years if you don't want to have problems...). -\item Reformating DVD+RW 10-20 time can apparently make the medium - unusable. Normally you should not have to format or reformat - DVD+RW media. If it is necessary, current versions of growisofs will - do so automatically. - \item For more informations about DVD writing, please look at the \elink{dvd+rw-tools homepage}{http://fy.chalmers.se/~appro/linux/DVD+RW/}. \end{itemize} diff --git a/docs/manual/faq.tex b/docs/manual/faq.tex index daf8955d..3d513577 100644 --- a/docs/manual/faq.tex +++ b/docs/manual/faq.tex @@ -409,7 +409,7 @@ please use the one distributed in the source code. \item [How Can I Be Sure that Bacula Really Saves and Restores All Files? ] \index[general]{How Can I Be Sure that Bacula Really Saves and Restores All Files? } It is really quite simple, but took me a while to figure - out how to ``prove'' it. First make a Bacula Rescue disk, see the + out how to "prove" it. First make a Bacula Rescue disk, see the \ilink{Disaster Recovery Using Bacula}{_ChapterStart38} of this manual. Second, you run a full backup of all your files on all partitions. Third, you run an Verify InitCatalog Job on the same FileSet, which @@ -549,7 +549,7 @@ Pool Bacula also has compression code, which is normally used only when backing up - to file Volumes. There are two conditions for this ''software`` to become + to file Volumes. There are two conditions for this "software" to become enabled. \begin{enumerate} @@ -734,11 +734,11 @@ to change it. \label{ConnectionRefused} \subsection*{I get a Connection refused when connecting to my Client} -\item [In connecting to my Client, I get ''ERR:Connection Refused. Packet - Size too big from File daemon:192.168.1.4:9102`` Why?] - \index[general]{In connecting to my Client, I get ``ERR:Connection +\item [In connecting to my Client, I get "ERR:Connection Refused. Packet + Size too big from File daemon:192.168.1.4:9102" Why?] + \index[general]{In connecting to my Client, I get "ERR:Connection Refused. - Packet Size too big from File daemon:192.168.1.4:9102'' Why? } + Packet Size too big from File daemon:192.168.1.4:9102" Why? } This is typically a communications error resulting from one of the following: diff --git a/docs/manual/filedconf.tex b/docs/manual/filedconf.tex index 61a1e2f0..ffce3256 100644 --- a/docs/manual/filedconf.tex +++ b/docs/manual/filedconf.tex @@ -65,9 +65,9 @@ required. Bacula}, but may be shared by other Bacula daemons. This record is required. On Win32 systems, in some circumstances you may need to specify a drive - leter in the specified working directory path. Also, please be sure + letter in the specified working directory path. Also, please be sure that this directory is writable by the SYSTEM user otherwise restores - may fail (the bootstrap file that is tranferred to the File daemon from + may fail (the bootstrap file that is transferred to the File daemon from the Director is temporarily put in this directory before being passed to the Storage daemon). diff --git a/docs/manual/fileset.tex b/docs/manual/fileset.tex index bf5d0839..6051cc40 100644 --- a/docs/manual/fileset.tex +++ b/docs/manual/fileset.tex @@ -151,7 +151,7 @@ you want everything to be backed up. However, one additional point is that in the case that no match was found, Bacula will use the options found in the last Options resource. As a consequence, if you want a particular set -of ``default'' options, you should put them in an Options resource after +of "default" options, you should put them in an Options resource after any other Options. This is perhaps a bit overwhelming, so there are a number of examples included @@ -371,7 +371,7 @@ The directives within an Options resource may be one of the following: \item [hardlinks=yes|no] \index[dir]{hardlinks} - When enabled (default), this directive will cause hardl inks to be + When enabled (default), this directive will cause hard inks to be backed up. However, the File daemon keeps track of hard linked files and will backup the data only once. The process of keeping track of the hard links can be quite expensive if you have lots of them (tens of @@ -424,7 +424,7 @@ The directives within an Options resource may be one of the following: included. If {\bf Exclude=yes} is specified, the regex will select which files are to be excluded. Multiple regex directives may be specified within an Options resource, and they will be applied in turn - until the first one that matches. Note, if you exculde a + until the first one that matches. Note, if you exclude a directory, no files or directories below it will be matched. \item [regexfile=\lt{}string\gt{}] @@ -460,7 +460,7 @@ The directives within an Options resource may be one of the following: The default is {\bf no}. If this option is set to yes, and you have the POSIX {\bf libacl} installed on your system, Bacula will backup the file and directory UNIX Access Control Lists (ACL) as defined in IEEE Std - 1003.1e draft 17 and ``POSIX.1e'' (abandoned). This feature is + 1003.1e draft 17 and "POSIX.1e" (abandoned). This feature is available on UNIX only and depends on the ACL library. Bacula is automatically compiled with ACL support if the {\bf libacl} library is installed on your system (shown in config.out). While restoring the @@ -511,7 +511,7 @@ There are a number of special cases when specifying directories and files in a \begin{itemize} \item Any name preceded by an at-sign (@) is assumed to be the name of a - file, which contains a list of files each preceded by a ``File =''. The + file, which contains a list of files each preceded by a "File =". The named file is read once when the configuration file is parsed during the Director startup. Note, that the file is read on the Director's machine and not on the Client's. In fact, the @filename can appear anywhere @@ -541,7 +541,7 @@ Include { script as in the second example below. Also, you must take care to escape (precede with a \textbackslash{}) wild-cards, shell character, and to ensure that any spaces in your command are escaped as well. If - you use a single quotes (') within a double quote (``), Bacula will + you use a single quotes (') within a double quote ("), Bacula will treat everything between the single quotes as one field so it will not be necessary to escape the spaces. In general, getting all the quotes and escapes correct is a real pain as you can see by the next example. @@ -566,7 +566,7 @@ Include { will produce a list of all the local partitions on a RedHat Linux system. Note, the above line was split, but should normally be written on one line. Quoting is a real problem because you must quote for Bacula which consists of - preceding every \textbackslash{} and every '' with a \textbackslash{}, and + preceding every \textbackslash{} and every " with a \textbackslash{}, and you must also quote for the shell command. In the end, it is probably easier just to execute a small file with: @@ -693,7 +693,7 @@ Include { and after one minute of waiting, Bacula will give up and go on to the next file. The data read can be anything since Bacula treats it as a stream. - This feature can be an excellent way to do a ``hot'' backup of a very large + This feature can be an excellent way to do a "hot" backup of a very large database. You can use the {\bf RunBeforeJob} to create the fifo and to start a program that dynamically reads your database and writes it to the fifo. Bacula will then write it to the Volume. @@ -901,7 +901,7 @@ FileSet { \end{verbatim} \normalsize -The ``trick'' here was to add a RegexFile expression that matches +The "trick" here was to add a RegexFile expression that matches all files. It does not match directory names, so all directories in /myfile will be backed up (the directory entry) and any *.Z and *.gz files contained in them. If you know that certain directories do @@ -1008,7 +1008,7 @@ the drive and a colon (as in c:). However, the path separators must be specified in Unix convention (i.e. forward slash (/)). If you wish to include a quote in a file name, precede the quote with a backslash (\textbackslash{}). For example you might use the following -for a Windows machine to backup the ``My Documents'' directory: +for a Windows machine to backup the "My Documents" directory: \footnotesize \begin{verbatim} @@ -1034,7 +1034,7 @@ rules: \item To exclude a directory, you must not have a trailing slash on the directory name. \item If you have spaces in your filename, you must enclose the entire name - in double-quote characters (``). Trying to use a backslash before the space + in double-quote characters ("). Trying to use a backslash before the space will not work. \item If you are using the old Exclude syntax (noted below), you may not specify a drive letter in the exclude. The new syntax noted above should work diff --git a/docs/manual/firewalls.tex b/docs/manual/firewalls.tex index e6efd51e..82bf1c00 100644 --- a/docs/manual/firewalls.tex +++ b/docs/manual/firewalls.tex @@ -32,8 +32,8 @@ Where it should be obvious that DIR represents the Director, FD the File daemon or client, and SD the Storage daemon. The numbers that follow those names are the standard ports used by Bacula, and the -\gt{} represents the left side making a connection to the right side (i.e. the right side is the -``server'' or is listening on the specified port), and the left side is the -``client'' who initiates the conversation. +"server" or is listening on the specified port), and the left side is the +"client" who initiates the conversation. Note, port 9103 serves both the Director and the File daemon, each having its own independent connection. diff --git a/docs/manual/general.tex b/docs/manual/general.tex index 83d2b8e1..1df40f44 100644 --- a/docs/manual/general.tex +++ b/docs/manual/general.tex @@ -33,7 +33,7 @@ If you want Bacula to behave like the above mentioned simple programs and write over any tape that you put in the drive, then you will find working with Bacula difficult. Bacula is designed to protect your data following the rules you specify, and this means reusing a tape only -as the last resort. It is possible to ``force'' Bacula to write +as the last resort. It is possible to "force" Bacula to write over any tape in the drive, but it is easier and more efficient to use a simpler program for that kind of operation. @@ -65,7 +65,7 @@ Bacula is made up of the following five major components or services: backup, restore, verify and archive operations. The system administrator uses the Bacula Director to schedule backups and to recover files. For more details see the Director Services Daemon Design Document in the Bacula -Developer's Guild. The Director runs as a daemon or a service (i.e. in the +Developer's Guide. The Director runs as a daemon or a service (i.e. in the background). \item \label{UADef} @@ -74,7 +74,7 @@ user to communicate with the {\bf Bacula Director} (see above). Currently, the Bacula Console is available in three versions. The first and simplest is to run the Console program in a shell window (i.e. TTY interface). Most system administrators will find this completely adequate. The second version -is a GNOME GUI interface that for the moment (23 November 2003) is far from +is a GNOME GUI interface that is far from complete, but quite functional as it has most the capabilities of the shell Console. The third version is a wxWidgets GUI with an interactive file restore. It also has most of the capabilities of the shell console, allows @@ -94,8 +94,8 @@ program runs as a daemon on the machine to be backed up, and in some of the documentation, the File daemon is referred to as the Client (for example in Bacula's configuration file). In addition to Unix/Linux File daemons, there is a Windows File daemon (normally distributed in binary format). The Windows -File daemon runs on all currently known Windows versions (95, 98, Me, NT, -2000, XP). +File daemon runs on current Windows versions (NT, +2000, XP, 2003, and possibly Me and 98). \item \label{SDDef} {\bf Bacula Storage} services consist of the software programs that perform @@ -113,10 +113,9 @@ The Catalog services permit the System Administrator or user to quickly locate and restore any desired file. The Catalog services sets Bacula apart from simple backup programs like tar and bru, because the catalog maintains a record of all Volumes used, all Jobs run, and all Files saved, permitting -efficicient restoration and Volume management. Bacula currently supports +efficient restoration and Volume management. Bacula currently supports three different databases, MySQL, PostgreSQL, and SQLite, one of which must -be chosen when building {\bf Bacula}. There also exists an Internal database, -but it is no longer supported. +be chosen when building {\bf Bacula}. The three SQL databases currently supported (MySQL, PostgreSQL or SQLite) provide quite a number of features, including rapid indexing, arbitrary @@ -126,7 +125,7 @@ SQLite. For the technical and porting details see the Catalog Services Design Document in the developer's documented. The RPMs for MySQL and PostgreSQL ship as part of the Linux RedHat -and several other releases, or building the rpms from the source is +and several other releases. Alternatively, building the rpms from the source is quite easy, see the \ilink{ Installing and Configuring MySQL}{_ChapterStart} chapter of this document for the details. For more information on MySQL, please see: @@ -320,21 +319,21 @@ chapter of this document. \item [Monitor] \index[fd]{Monitor } - The program that interfaces to the all the daemons allowing the user or + The program that interfaces to all the daemons allowing the user or system administrator to monitor Bacula status. \item [Resource] \index[fd]{Resource } A resource is a part of a configuration file that defines a specific unit of information that is available to Bacula. It consists of several directives -(individual configuation statements). For example, the {\bf Job} resource +(individual configuration statements). For example, the {\bf Job} resource defines all the properties of a specific Job: name, schedule, Volume pool, backup type, backup level, ... \item [Restore] \index[fd]{Restore } A restore is a configuration resource that describes the operation of -recovering a file (lost or damaged) from backup media. It is the inverse of a +recovering a file from backup media. It is the inverse of a save, except that in most cases, a restore will normally have a small set of files to restore, while normally a Save backs up all the files on the system. Of course, after a disk crash, Bacula can be called upon to do a full @@ -416,7 +415,7 @@ Volume is valid. The File Retention Period determines the time that File records are kept in the catalog database. This period is important because the volume of the database File records by far use the most storage space in the database. As a -consequence, you must ensure that regular ``pruning'' of the database file +consequence, you must ensure that regular "pruning" of the database file records is done. (See the Console {\bf retention} command for more details on this subject). @@ -476,7 +475,7 @@ Bacula} can be a central component of your disaster recovery system. For example, if you have created an emergency boot disk, a Bacula Rescue disk to save the current partitioning information of your hard disk, and maintain a complete Bacula backup, it is possible to completely recover your system from -``bare metal'' that is starting from an empty disk. +"bare metal" that is starting from an empty disk. If you have used the {\bf WriteBootstrap} record in your job or some other means to save a valid bootstrap file, you will be able to use it to extract diff --git a/docs/manual/gpl.tex b/docs/manual/gpl.tex index ebe25377..9f92d762 100644 --- a/docs/manual/gpl.tex +++ b/docs/manual/gpl.tex @@ -126,13 +126,13 @@ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION {\bf 0.} This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the -terms of this General Public License. The ``Program'', below, refers to any -such program or work, and a ``work based on the Program'' means either the +terms of this General Public License. The "Program", below, refers to any +such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, -translation is included without limitation in the term ``modification''.) Each -licensee is addressed as ``you''. +translation is included without limitation in the term "modification".) Each +licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is @@ -298,8 +298,8 @@ similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program -specifies a version number of this License which applies to it and ``any later -version'', you have the option of following the terms and conditions either of +specifies a version number of this License which applies to it and "any later +version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. @@ -317,7 +317,7 @@ promoting the sharing and reuse of software generally. {\bf 11.} BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE -THE PROGRAM ``AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR +THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM @@ -350,7 +350,7 @@ which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion -of warranty; and each file should have at least the ``copyright'' line and a +of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. \footnotesize @@ -392,7 +392,7 @@ use may be called something other than {\tt `show w'} and {\tt `show c'}; they could even be mouse-clicks or menu items\verb:--:whatever suits your program. You should also get your employer (if you work as a programmer) or your -school, if any, to sign a ``copyright disclaimer'' for the program, if +school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: \footnotesize diff --git a/docs/manual/install.tex b/docs/manual/install.tex index 33c66658..bbafa2ce 100644 --- a/docs/manual/install.tex +++ b/docs/manual/install.tex @@ -84,7 +84,7 @@ needed), you do the following: Although the exact composition of the dependency packages may change from time to time, the current makeup is the following: -\addcontentsline{lot}{table}{Depedency Packages} +\addcontentsline{lot}{table}{Dependency Packages} \begin{longtable}{|l|l|l|l|} \hline \multicolumn{1}{|c| }{\bf 3rd Party Package } & \multicolumn{1}{c| }{\bf @@ -195,7 +195,7 @@ The basic installation is rather simple. so that you are sure to start from scratch and not have a mixture of the two options. This is because ./configure caches much of the information. The {\bf -make distclean} is also critical if you move the source dirctory from one +make distclean} is also critical if you move the source directory from one machine to another. If the {\bf make distclean} fails, just ignore it and continue on. \item make @@ -236,7 +236,7 @@ SQLite heavy modifications to the configuration files so that you are sure that Bacula works and are familiar with it. After that changing the conf files will be easier. -\item If after installing Bacula, you decide to ``move it'', that is to +\item If after installing Bacula, you decide to "move it", that is to install it in a different set of directories, proceed as follows: \footnotesize @@ -259,8 +259,8 @@ reported to work with the Client only as long as readline support is disabled. If you install Bacula on more than one system, and they are identical, you can -simply transfer the source tree to that other system and do a ``make -install''. However, if there are differences in the libraries or OS versions, +simply transfer the source tree to that other system and do a "make +install". However, if there are differences in the libraries or OS versions, or you wish to install on a different OS, you should start from the original compress tar file. If you do transfer the source tree, and you have previously done a ./configure command, you MUST do: @@ -274,7 +274,7 @@ make distclean prior to doing your new ./configure. This is because the GNU autoconf tools cache the configuration, and if you re-use a configuration for a Linux machine on a Solaris, you can be sure your build will fail. To avoid this, as -mentioned above, either start from the tar file, or do a ``make distclean''. +mentioned above, either start from the tar file, or do a "make distclean". In general, you will probably want to supply a more complicated {\bf configure} statement to ensure that the modules you want are built and that @@ -677,21 +677,21 @@ customize your installation. \index[general]{{-}{-}with-dir-user } This option allows you to specify the Userid used to run the Director. The Director must be started as root, but doesn't need to run as root, and after - doing preliminary initializations, it can ``drop'' to the UserId specified on + doing preliminary initializations, it can "drop" to the UserId specified on this option. \item [ {-}{-}with-dir-group=\lt{}Group\gt{} ] \index[general]{{-}{-}with-dir-group } This option allows you to specify the GroupId used to run the Director. The Director must be started as root, but doesn't need to run as root, and after - doing preliminary initializations, it can ``drop'' to the GroupId specified + doing preliminary initializations, it can "drop" to the GroupId specified on this option. \item [ {-}{-}with-sd-user=\lt{}User\gt{} ] \index[general]{{-}{-}with-sd-user } This option allows you to specify the Userid used to run the Storage daemon. The Storage daemon must be started as root, but doesn't need to run as root, - and after doing preliminary initializations, it can ``drop'' to the UserId + and after doing preliminary initializations, it can "drop" to the UserId specified on this option. If you use this option, you will need to take care that the Storage daemon has access to all the devices (tape drives, ...) that it needs. @@ -700,7 +700,7 @@ customize your installation. \index[general]{{-}{-}with-sd-group } This option allows you to specify the GroupId used to run the Storage daemon. The Storage daemon must be started as root, but doesn't need to run as root, - and after doing preliminary initializations, it can ``drop'' to the GroupId + and after doing preliminary initializations, it can "drop" to the GroupId specified on this option. \item [ {-}{-}with-fd-user=\lt{}User\gt{} ] @@ -708,14 +708,14 @@ customize your installation. This option allows you to specify the Userid used to run the File daemon. The File daemon must be started as root, and in most cases, it needs to run as root, so this option is used only in very special cases, after doing - preliminary initializations, it can ``drop'' to the UserId specified on this + preliminary initializations, it can "drop" to the UserId specified on this option. \item [ {-}{-}with-fd-group=\lt{}Group\gt{} ] \index[general]{{-}{-}with-fd-group } This option allows you to specify the GroupId used to run the File daemon. The File daemon must be started as root, and in most cases, it must be run as - root, however, after doing preliminary initializations, it can ``drop'' to + root, however, after doing preliminary initializations, it can "drop" to the GroupId specified on this option. \end{description} @@ -746,7 +746,7 @@ For most systems, we recommend starting with the following options: If you want to install Bacula in an installation directory rather than run it out of the build directory (as developers will do most of the time), you should also include the \verb:--:sbindir and \verb:--:sysconfdir options with appropriate -paths. Neither are necessary if you do not use ``make install'' as is the case +paths. Neither are necessary if you do not use "make install" as is the case for most development work. The install process will create the sbindir and sysconfdir if they do not exist, but it will not automatically create the pid-dir, subsys-dir, or working-dir, so you must ensure that they exist before @@ -894,7 +894,7 @@ Finally, you should follow the installation instructions in the \index[general]{Kern's Configure Script } \addcontentsline{toc}{subsection}{Kern's Configure Script} -The script that I use for building on my ``production'' Linux machines is: +The script that I use for building on my "production" Linux machines is: \footnotesize \begin{verbatim} @@ -952,7 +952,7 @@ make install \normalsize If you have previously installed Bacula, the old binaries will be overwritten, -but the old configuration files will remain unchanged, and the ``new'' +but the old configuration files will remain unchanged, and the "new" configuration files will be appended with a {\bf .new}. Generally if you have previously installed and run Bacula you will want to discard or ignore the configuration files with the appended {\bf .new}. diff --git a/docs/manual/kaboom.tex b/docs/manual/kaboom.tex index 8a37f256..2a4245d3 100644 --- a/docs/manual/kaboom.tex +++ b/docs/manual/kaboom.tex @@ -64,7 +64,7 @@ sufficient if you are running more than one daemon on a machine. \index[general]{Testing The Traceback } \addcontentsline{toc}{subsection}{Testing The Traceback} -To ``manually'' test the traceback feature, you simply start {\bf Bacula} then +To "manually" test the traceback feature, you simply start {\bf Bacula} then obtain the {\bf PID} of the main daemon thread (there are multiple threads). Unfortunately, the output had to be split to fit on this page: diff --git a/docs/manual/lesser.tex b/docs/manual/lesser.tex index 4660e1c3..0a14d58e 100644 --- a/docs/manual/lesser.tex +++ b/docs/manual/lesser.tex @@ -150,7 +150,7 @@ therefore permits such linking only if the entire combination fits its criteria of freedom. The Lesser General Public License permits more lax criteria for linking other code with the library. -We call this license the ``Lesser'' General Public License because it does +We call this license the "Lesser" General Public License because it does Less to protect the user's freedom than the ordinary General Public License. It also provides other free software developers Less of an advantage over competing non-free programs. These disadvantages are the reason we use the @@ -177,8 +177,8 @@ Library has the freedom and the wherewithal to run that program using a modified version of the Library. The precise terms and conditions for copying, distribution and modification -follow. Pay close attention to the difference between a ``work based on the -library'' and a ``work that uses the library''. The former contains code +follow. Pay close attention to the difference between a "work based on the +library" and a "work that uses the library". The former contains code derived from the library, whereas the latter must be combined with the library in order to run. @@ -194,22 +194,22 @@ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION {\bf 0.} This License Agreement applies to any software library or other program which contains a notice placed by the copyright holder or other authorized party saying it may be distributed under the terms of this Lesser -General Public License (also called ``this License''). Each licensee is -addressed as ``you''. +General Public License (also called "this License"). Each licensee is +addressed as "you". -A ``library'' means a collection of software functions and/or data prepared so +A "library" means a collection of software functions and/or data prepared so as to be conveniently linked with application programs (which use some of those functions and data) to form executables. -The ``Library'', below, refers to any such software library or work which has -been distributed under these terms. A ``work based on the Library'' means +The "Library", below, refers to any such software library or work which has +been distributed under these terms. A "work based on the Library" means either the Library or any derivative work under copyright law: that is to say, a work containing the Library or a portion of it, either verbatim or with modifications and/or translated straightforwardly into another language. (Hereinafter, translation is included without limitation in the term -``modification''.) +"modification".) -``Source code'' for a work means the preferred form of the work for making +"Source code" for a work means the preferred form of the work for making modifications to it. For a library, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the @@ -307,17 +307,17 @@ object code. {\bf 5.} A program that contains no derivative of any portion of the Library, but is designed to work with the Library by being compiled or linked with it, -is called a ``work that uses the Library''. Such a work, in isolation, is not +is called a "work that uses the Library". Such a work, in isolation, is not a derivative work of the Library, and therefore falls outside the scope of this License. -However, linking a ``work that uses the Library'' with the Library creates an +However, linking a "work that uses the Library" with the Library creates an executable that is a derivative of the Library (because it contains portions -of the Library), rather than a ``work that uses the library''. The executable +of the Library), rather than a "work that uses the library". The executable is therefore covered by this License. Section 6 states terms for distribution of such executables. -When a ``work that uses the Library'' uses material from a header file that is +When a "work that uses the Library" uses material from a header file that is part of the Library, the object code for the work may be a derivative work of the Library even though the source code is not. Whether this is true is especially significant if the work can be linked without the Library, or if @@ -336,7 +336,7 @@ containing that work also fall under Section 6, whether or not they are linked directly with the Library itself. {\bf 6.} As an exception to the Sections above, you may also combine or link a -``work that uses the Library'' with the Library to produce a work containing +"work that uses the Library" with the Library to produce a work containing portions of the Library, and distribute that work under terms of your choice, provided that the terms permit modification of the work for the customer's own use and reverse engineering for debugging such modifications. @@ -353,7 +353,7 @@ Also, you must do one of these things: machine-readable source code for the Library including whatever changes were used in the work (which must be distributed under Sections 1 and 2 above); and, if the work is an executable linked with the Library, with the complete -machine-readable ``work that uses the Library'', as object code and/or source +machine-readable "work that uses the Library", as object code and/or source code, so that the user can modify the Library and then relink to produce a modified executable containing the modified Library. (It is understood that the user who changes the contents of definitions files in the Library will @@ -376,7 +376,7 @@ made with. materials or that you have already sent this user a copy. \end{itemize} -For an executable, the required form of the ``work that uses the Library'' +For an executable, the required form of the "work that uses the Library" must include any data and utility programs needed for reproducing the executable from it. However, as a special exception, the materials to be distributed need not include anything that is normally distributed (in either @@ -470,8 +470,8 @@ be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Library -specifies a version number of this License which applies to it and ``any later -version'', you have the option of following the terms and conditions either of +specifies a version number of this License which applies to it and "any later +version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Library does not specify a license version number, you may choose any version ever published by the Free Software Foundation. @@ -489,7 +489,7 @@ promoting the sharing and reuse of software generally. {\bf 15.} BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE -THE LIBRARY ``AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR +THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY @@ -525,7 +525,7 @@ License). To apply these terms, attach the following notices to the library. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the -``copyright'' line and a pointer to where the full notice is found. +"copyright" line and a pointer to where the full notice is found. \footnotesize \begin{verbatim} @@ -548,13 +548,13 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. You should also get your employer (if you work as a programmer) or your -school, if any, to sign a ``copyright disclaimer'' for the library, if +school, if any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample; alter the names: \footnotesize \begin{verbatim} Yoyodyne, Inc., hereby disclaims all copyright interest in -the library `Frob' (a library for tweaking knobs) written +the library "Frob" (a library for tweaking knobs) written by James Random Hacker. {\it signature of Ty Coon}, 1 April 1990 Ty Coon, President of Vice diff --git a/docs/manual/license.tex b/docs/manual/license.tex index 8c435d80..b11fdd20 100644 --- a/docs/manual/license.tex +++ b/docs/manual/license.tex @@ -68,7 +68,7 @@ NO WARRANTY BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE -PROGRAM ``AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, +PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, diff --git a/docs/manual/messagesres.tex b/docs/manual/messagesres.tex index e09f236d..a52c3e04 100644 --- a/docs/manual/messagesres.tex +++ b/docs/manual/messagesres.tex @@ -85,7 +85,7 @@ tie this Messages resource to a Job and/or to the daemon. In the absence of this resource, Bacula will send all mail using the following command: -{\bf mail -s ``Bacula Message'' \lt{}recipients\gt{}} +{\bf mail -s "Bacula Message" \lt{}recipients\gt{}} In many cases, depending on your machine, this command may not work. Using the {\bf MailCommand}, you can specify exactly how to send the mail. During @@ -109,10 +109,10 @@ The following is the command I (Kern) use. Note, the whole command should appear on a single line in the configuration file rather than split as is done here for presentation: -{\bf mailcommand = ``/home/kern/bacula/bin/bsmtp -h mail.example.com -f -\textbackslash{}''\textbackslash{}(Bacula\textbackslash{}) -\%r\textbackslash{}`` -s \textbackslash{}''Bacula: \%t \%e of \%c -\%l\textbackslash{}`` \%r'' } +{\bf mailcommand = "/home/kern/bacula/bin/bsmtp -h mail.example.com -f +\textbackslash{}"\textbackslash{}(Bacula\textbackslash{}) +\%r\textbackslash{}" -s \textbackslash{}"Bacula: \%t \%e of \%c +\%l\textbackslash{}" \%r" } Note, the {\bf bsmtp} program is provided as part of {\bf Bacula}. For additional details, please see the diff --git a/docs/manual/mysql.tex b/docs/manual/mysql.tex index fd9d6797..46af240b 100644 --- a/docs/manual/mysql.tex +++ b/docs/manual/mysql.tex @@ -249,4 +249,4 @@ If you upgrade MySQL, you must reconfigure, rebuild, and re-install Bacula otherwise you are likely to get bizarre failures. If you install from rpms and you upgrade MySQL, you must also rebuild Bacula. You can do so by rebuilding from the source rpm. To do so, you may need -eo modify the bacula.spec file to account for the new MySQL version. +to modify the bacula.spec file to account for the new MySQL version. diff --git a/docs/manual/oldfileset.tex b/docs/manual/oldfileset.tex index a1a6cc8b..8f65193f 100644 --- a/docs/manual/oldfileset.tex +++ b/docs/manual/oldfileset.tex @@ -321,7 +321,7 @@ command or commands with a {\bf sh -c} so that they are invoked by a shell. This will not be the case if you are invoking a script as in the second example below. Also, you must take care to escape wild-cards and ensure that any spaces in your command are escaped as well. If you use a single quotes -(') within a double quote (``), Bacula will treat everything between the +(') within a double quote ("), Bacula will treat everything between the single quotes as one field so it will not be necessary to escape the spaces. In general, getting all the quotes and escapes correct is a real pain as you can see by the next example. As a consequence, it is often easier to put @@ -344,7 +344,7 @@ Include = signature=SHA1 { will produce a list of all the local partitions on a RedHat Linux system. Note, the above line was split, but should normally be written on one line. Quoting is a real problem because you must quote for Bacula which consists of -preceding every \textbackslash{} and every '' with a \textbackslash{}, and +preceding every \textbackslash{} and every " with a \textbackslash{}, and you must also quote for the shell command. In the end, it is probably easier just to execute a small file with: @@ -420,7 +420,7 @@ process on the system that is writing into the fifo, or Bacula will hang, and after one minute of waiting, it will go on to the next file. The data read can be anything since Bacula treats it as a stream. -This feature can be an excellent way to do a ``hot'' backup of a very large +This feature can be an excellent way to do a "hot" backup of a very large database. You can use the {\bf RunBeforeJob} to create the fifo and to start a program that dynamically reads your database and writes it to the fifo. Bacula will then write it to the Volume. @@ -584,7 +584,7 @@ rules: \item To exclude a directory, you must not have a trailing slash on the directory name. \item If you have spaces in your filename, you must enclose the entire name -in double-quote characters (``). Trying to use a backslash before the space +in double-quote characters ("). Trying to use a backslash before the space will not work. \item You must not precede the excluded file or directory with a drive letter (such as {\bf c:}) otherwise it will not work. @@ -606,7 +606,7 @@ the drive and a colon (as in c:). However, the path separators must be specified in Unix convention (i.e. forward slash (/)). If you wish to include a quote in a file name, precede the quote with a backslash (\textbackslash{}\textbackslash{}). For example you might use the following -for a Windows machine to backup the ''My Documents`` directory: +for a Windows machine to backup the "My Documents" directory: \footnotesize \begin{verbatim} diff --git a/docs/manual/progs.tex b/docs/manual/progs.tex index 7ee0df49..58963fa5 100644 --- a/docs/manual/progs.tex +++ b/docs/manual/progs.tex @@ -225,7 +225,7 @@ available for each record: \addcontentsline{toc}{subsubsection}{bls Listing Blocks} Normally, except for debugging purposes, you will not need to list Bacula -blocks (the ``primitive'' unit of Bacula data on the Volume). However, you can +blocks (the "primitive" unit of Bacula data on the Volume). However, you can do so with: \footnotesize @@ -481,8 +481,8 @@ you have provided security on your database, you may need to supply either the database name ({\bf -b} option), the user name ({\bf -u} option), and/or the password ({\bf -p}) options. -As an example, let's suppose that you did a backup to Volumes ``Vol001'' -and ``Vol002'', then sometime later all records of one or both those +As an example, let's suppose that you did a backup to Volumes "Vol001" +and "Vol002", then sometime later all records of one or both those Volumes were pruned or purged from the database. By using {\bf bscan} you can recreate the catalog entries for @@ -951,7 +951,7 @@ entering a ctl-d in column 1 of the last line. database, and optionally fix them. The {\bf dbcheck} program can be found in the {\bf \lt{}bacula-source\gt{}/src/tools} directory of the source distribution. Though it is built with the make process, it is not normally -``installed''. +"installed". It is called: @@ -1091,7 +1091,7 @@ was correct and to print some statistics on file name and path length. However, you may find it useful to see what bacula would do with a given {\bf Include} resource. The {\bf testfind} program can be found in the {\bf \lt{}bacula-source\gt{}/src/tools} directory of the source distribution. -Though it is built with the make process, it is not normally ``installed''. +Though it is built with the make process, it is not normally "installed". It is called: @@ -1158,4 +1158,3 @@ cause {\bf testfind} to print the raw filenames without showing the Bacula internal file type, or the link (if any). Debug levels of 10 or greater cause the filename and the path to be separated using the same algorithm that is used when putting filenames into the Catalog database. - diff --git a/docs/manual/python.tex b/docs/manual/python.tex index 9f4afc32..4fa06eee 100644 --- a/docs/manual/python.tex +++ b/docs/manual/python.tex @@ -4,7 +4,7 @@ \section*{Python Scripting} \label{_ChapterStart60} \index[general]{Python Scripting} -\index[general]{Scripting!Pyton} +\index[general]{Scripting!Python} \addcontentsline{toc}{section}{Python Scripting} You may be asking what Python is and why a scripting language is diff --git a/docs/manual/quickstart.tex b/docs/manual/quickstart.tex index 59c1ca34..63b9d835 100644 --- a/docs/manual/quickstart.tex +++ b/docs/manual/quickstart.tex @@ -53,8 +53,8 @@ The steps for creating a Pool, adding Volumes to it, and writing software labels to the Volumes, may seem tedious at first, but in fact, they are quite simple to do, and they allow you to use multiple Volumes (rather than being limited to the size of a single tape). Pools also give you significant -flexibility in your backup process. For example, you can have a ``Daily'' Pool -of Volumes for Incremental backups and a ``Weekly'' Pool of Volumes for Full +flexibility in your backup process. For example, you can have a "Daily" Pool +of Volumes for Incremental backups and a "Weekly" Pool of Volumes for Full backups. By specifying the appropriate Pool in the daily and weekly backup Jobs, you thereby insure that no daily Job ever writes to a Volume in the Weekly Pool and vice versa, and Bacula will tell you what tape is needed and diff --git a/docs/manual/recycling.tex b/docs/manual/recycling.tex index 7ec1a867..b09ada2b 100644 --- a/docs/manual/recycling.tex +++ b/docs/manual/recycling.tex @@ -54,7 +54,7 @@ A key point mentioned above, that can be a source of frustration, is that Bacula will only recycle purged Volumes if there is no other appendable Volume available, otherwise, it will always write to an appendable Volume before recycling even if there are Volume marked as Purged. This preserves your data -as long as possible. So, if you wish to ``force'' Bacula to use a purged +as long as possible. So, if you wish to "force" Bacula to use a purged Volume, you must first ensure that no other Volume in the Pool is marked {\bf Append}. If necessary, you can manually set a volume to {\bf Full}. The reason for this is that Bacula wants to preserve the data on your old tapes (even @@ -108,7 +108,7 @@ details of the Files backed up. In addition, without the File records, you cannot use the Console restore command to restore the files. When a Job record is pruned, the Volume (Media record) for that Job can still -remain in the database, and if you do a ``list volumes'', you will see the +remain in the database, and if you do a "list volumes", you will see the volume information, but the Job records (and its File records) will no longer be available. @@ -117,7 +117,7 @@ also prevents the catalog from growing to be too large. You choose the retention periods in function of how many files you are backing up and the time periods you want to keep those records online, and the size of the database. You can always re-insert the records (with 98\% of the original data) -by using ``bscan'' to scan in a whole Volume or any part of the volume that +by using "bscan" to scan in a whole Volume or any part of the volume that you want. By setting {\bf AutoPrune} to {\bf yes} you will permit {\bf Bacula} to @@ -192,7 +192,7 @@ If the volume is reused, it is relabeled with the same Volume Name, however all previous data will be lost. \end{description} -Note, it is also possible to ``force'' pruning of all Volumes in the Pool +Note, it is also possible to "force" pruning of all Volumes in the Pool associated with a Job by adding {\bf Prune Files = yes} to the Job resource. \label{Recycling} diff --git a/docs/manual/restore.tex b/docs/manual/restore.tex index 61a91dda..1e2c7094 100644 --- a/docs/manual/restore.tex +++ b/docs/manual/restore.tex @@ -246,7 +246,7 @@ $ \normalsize Depending on the number of {\bf JobFiles} for each JobId, the {\bf Building -directory tree ...``} can take a bit of time. If you notice ath all the +directory tree ..."} can take a bit of time. If you notice ath all the JobFiles are zero, your Files have probably been pruned and you will not be able to select any individual files -- it will be restore everything or nothing. @@ -597,7 +597,7 @@ its contents to be restored, you can still select items within the directory to be restored by individually marking those files, but in that case, you should - individually use the ''markdir`` command to select all higher level + individually use the "markdir" command to select all higher level directory entries (one at a time) to be restored if you want the directory entries properly restored. \end{itemize} @@ -700,9 +700,9 @@ Try the following things, each separately, and reset your Device resource to what it is now after each individual test: \begin{enumerate} -\item Set ''Block Positioning = no`` in your Device resource and try the +\item Set "Block Positioning = no" in your Device resource and try the restore. This is a new directive and untested. -\item Set ''Minimum Block Size = 512`` and ''Maximum Block Size = 512`` and +\item Set "Minimum Block Size = 512" and "Maximum Block Size = 512" and try the restore. Again send me the full job report output. If you are able to determine the block size your drive was previously using, you should try diff --git a/docs/manual/rpm-faq.tex b/docs/manual/rpm-faq.tex index c03e77b8..95c80230 100644 --- a/docs/manual/rpm-faq.tex +++ b/docs/manual/rpm-faq.tex @@ -41,7 +41,7 @@ The package build is controlled by a mandatory define set at the beginning of the file. These defines basically just control the dependency information that gets coded into the finished rpm package. The platform define may be edited in the spec file directly (by default all -defines are set to 0 or ``not set''). For example, to build the RedHat 7.x +defines are set to 0 or "not set"). For example, to build the RedHat 7.x package find the line in the spec file which reads \footnotesize diff --git a/docs/manual/security.tex b/docs/manual/security.tex index b829db7f..e48ab19e 100644 --- a/docs/manual/security.tex +++ b/docs/manual/security.tex @@ -111,8 +111,8 @@ undef-fd : ALL : deny \normalsize where director.example.org is the host which will be contacting the client -(ie. the box on which the Bacula Director daemon runs). The use of ``ALL : -deny'' ensures that the twist option (if present) is not invoked. To properly +(ie. the box on which the Bacula Director daemon runs). The use of "ALL : +deny" ensures that the twist option (if present) is not invoked. To properly test your configuration, start the daemon(s), then attempt to connect from an IP address which should be able to connect. You should see something like this: diff --git a/docs/manual/spooling.tex b/docs/manual/spooling.tex index 048f18ca..82379a01 100644 --- a/docs/manual/spooling.tex +++ b/docs/manual/spooling.tex @@ -27,8 +27,8 @@ important purposes. reducing downtime, and/or interference with users. \end{itemize} -Data spooling is exactly that ``spooling''. It is not a way to first write a -``backup'' to a disk file and then to a tape. When the backup has only been spooled to disk, +Data spooling is exactly that "spooling". It is not a way to first write a +"backup" to a disk file and then to a tape. When the backup has only been spooled to disk, it is not complete yet and cannot be restored until it is written to tape. In a future version, Bacula will support writing a backup to disk then later {\bf Migrating} or {\bf Copying} it to a tape. diff --git a/docs/manual/sqlite.tex b/docs/manual/sqlite.tex index b2bfba7f..44b8f678 100644 --- a/docs/manual/sqlite.tex +++ b/docs/manual/sqlite.tex @@ -98,7 +98,7 @@ the SQLite libraries will be linked into {\bf Bacula}. \index[general]{Testing SQLite } \addcontentsline{toc}{subsection}{Testing SQLite} -We have much less ``production'' experience +We have much less "production" experience using SQLite than using MySQL. SQLite has performed flawlessly for us in all our testing. However, several users have reported corrupted databases while using diff --git a/docs/manual/state.tex b/docs/manual/state.tex index f834c286..b8af271b 100644 --- a/docs/manual/state.tex +++ b/docs/manual/state.tex @@ -83,7 +83,7 @@ In other words, what is and what is not currently implemented and functional. \item Access control lists for Consoles that permit restricting user access to only their data. \item Data spooling to disk during backup with subsequent write to tape from - the spooled disk files. This prevents tape ``shoe shine'' during + the spooled disk files. This prevents tape "shoe shine" during Incremental/Differential backups. \item Support for save/restore of files larger than 2GB. \item Support for 64 bit machines, e.g. amd64. diff --git a/docs/manual/storedconf.tex b/docs/manual/storedconf.tex index 4e44c9f3..105693b6 100644 --- a/docs/manual/storedconf.tex +++ b/docs/manual/storedconf.tex @@ -260,12 +260,12 @@ specified within the Device resource are specific to the Device. \index[sd]{Archive Device } The specified {\bf name-string} gives the system file name of the storage device managed by this storage daemon. This will usually be the device file - name of a removable storage device (tape drive), for example ``{\bf - /dev/nst0}'' or ``{\bf /dev/rmt/0mbn}''. For a DVD-writer, it will be for + name of a removable storage device (tape drive), for example "{\bf + /dev/nst0}" or "{\bf /dev/rmt/0mbn}". For a DVD-writer, it will be for example {\bf /dev/hdc}. It may also be a directory name if you are archiving to disk storage. In this case, you must supply the full absolute path to the directory. When specifying a tape device, it is preferable that the - ``non-rewind'' variant of the device file name be given. In addition, on + "non-rewind" variant of the device file name be given. In addition, on systems such as Sun, which have multiple tape access methods, you must be sure to specify to use Berkeley I/O conventions with the device. The {\bf b} in the Solaris (Sun) archive specification {\bf /dev/rmt/0mbn} is what is @@ -306,7 +306,7 @@ specified within the Device resource are specific to the Device. \item [Media Type = {\it name-string}] \index[sd]{Media Type } The specified {\bf name-string} names the type of media supported by this - device, for example, ``DLT7000''. Media type names are arbitrary in that you + device, for example, "DLT7000". Media type names are arbitrary in that you set it to anything you want, but must be known to the volume database to keep track of which storage daemons can read which volumes. The same {\bf name-string} must appear in the appropriate Storage resource definition in @@ -320,9 +320,9 @@ specified within the Device resource are specific to the Device. have a single Storage daemon, but it is with multiple Storage daemons, especially if they have incompatible media. - For example, if you specify a Media Type of ``DDS-4'' then during the + For example, if you specify a Media Type of "DDS-4" then during the restore, Bacula will be able to choose any Storage Daemon that handles - ``DDS-4''. If you have an autochanger, you might want to name the Media Type + "DDS-4". If you have an autochanger, you might want to name the Media Type in a way that is unique to the autochanger, unless you wish to possibly use the Volumes in other drives. You should also ensure to have unique Media Type names if the Media is not compatible between drives. This specification diff --git a/docs/manual/strategies.tex b/docs/manual/strategies.tex index 5eff154b..e6896d2e 100644 --- a/docs/manual/strategies.tex +++ b/docs/manual/strategies.tex @@ -174,7 +174,7 @@ run this way, or using modifications of it based on two week cycles or longer. \index[general]{Practical Details } \addcontentsline{toc}{subsubsection}{Practical Details} -The simplest way to ``force'' Bacula to use a different tape each day is to +The simplest way to "force" Bacula to use a different tape each day is to define a different Pool for each day of the the week a backup is done. In addition, you will need to specify appropriate Job and File retention periods so that Bacula will relabel and overwrite the tape each week rather than diff --git a/docs/manual/stunnel.tex b/docs/manual/stunnel.tex index 6e4add91..4b8ec736 100644 --- a/docs/manual/stunnel.tex +++ b/docs/manual/stunnel.tex @@ -534,8 +534,8 @@ following, which I put in a file named {\bf makepem}: # OPENSSL=openssl umask 77 - PEM1=`/bin/mktemp openssl.XXXXXX` - PEM2=`/bin/mktemp openssl.XXXXXX` + PEM1="/bin/mktemp openssl.XXXXXX" + PEM2="/bin/mktemp openssl.XXXXXX" ${OPENSSL} req -newkey rsa:1024 -keyout $PEM1 -nodes \ -x509 -days 365 -out $PEM2 cat $PEM1 > stunnel.pem diff --git a/docs/manual/supported.tex b/docs/manual/supported.tex index c2ae3747..2eb0bcf3 100644 --- a/docs/manual/supported.tex +++ b/docs/manual/supported.tex @@ -70,7 +70,7 @@ is defective. You must remove this directory prior to running Bacula, or you can simply change the name to {\bf /lib/tls-broken}) then you must reboot your machine (one of the few times Linux must be rebooted). If you are not able to remove/rename /lib/tls, an alternative is to set the environment -variable ``LD\_ASSUME\_KERNEL=2.4.19'' prior to executing Bacula. For this +variable "LD\_ASSUME\_KERNEL=2.4.19" prior to executing Bacula. For this option, you do not need to reboot, and all programs other than Bacula will continue to use /lib/tls. diff --git a/docs/manual/supportedchangers.tex b/docs/manual/supportedchangers.tex index e9df6ba4..5effb130 100644 --- a/docs/manual/supportedchangers.tex +++ b/docs/manual/supportedchangers.tex @@ -11,7 +11,7 @@ \index[general]{Autochangers!Supported} \addcontentsline{toc}{subsection}{Supported Autochanger Models} -I hesitate to call these ``supported'' autochangers because the only +I hesitate to call these "supported" autochangers because the only autochangers that I have in my possession and am able to test are the HP SureStore DAT40X6 and the Overland PowerLoader LTO-2. All the other autochangers have been reported to work by Bacula users. Note, in the diff --git a/docs/manual/supporteddrives.tex b/docs/manual/supporteddrives.tex index cf170e5d..3d152cbc 100644 --- a/docs/manual/supporteddrives.tex +++ b/docs/manual/supporteddrives.tex @@ -129,23 +129,22 @@ required to use (but you may) the same name in your Bacula conf resources. \begin{tabular}{|c|c|c|c} Media Type & Drive Type & Media Capacity & Transfer Rate \\ \hline -DDS-1 & DAT & 2 GB & ?? GB/hr \\ \hline -DDS-2 & DAT & 4 GB & ?? GB/hr \\ \hline -DDS-3 & DAT & 12 GB & 5.4 GB/hr \\ \hline -Travan 40 & Travan & 20 GB & ?? GB/hr \\ \hline -DDS-4 & DAT & 20 GB & 11 GB/hr \\ \hline -VXA-1 & Exabyte & 33 GB & 11 GB/hr \\ \hline -DAT-72 & DAT & 36 GB & 13 GB/hr \\ \hline -DLT IV & DLT8000 & 40 GB & 22 GB/hr \\ \hline -VXA-2 & Exabyte & 80 GB & 22 GB/hr \\ \hline -Half-high Ultrum 1 & LTO 1 & 100 GB & 27 GB/hr \\ \hline -Ultrium 1 & LTO 1 & 100 GB & 54 GB/hr \\ \hline -Super DLT 1 & SDLT 220 & 110 GB & 40 GB/hr \\ \hline -VXA-3 & Exabyte & 160 GB & 43 GB/hr \\ \hline -Super DLT I & SDLT 320 & 160 GB & 58 GB/hr \\ \hline -Ultrium 2 & LTO 2 & 200 GB & 108 GB/hr \\ \hline -Super DLT II & SDLT 600 & 300 GB & 127 GB/hr \\ \hline -VXA-4 & Exabyte & 320 GB & 86 GB/hr \\ \hline -Ultrium 3 & LTO 3 & 400 GB & 216 GB/hr \\ \hline +DDS-1 & DAT & 2 GB & ?? GB/hr \\ \hline +DDS-2 & DAT & 4 GB & ?? GB/hr \\ \hline +DDS-3 & DAT & 12 GB & 5.4 GB/hr \\ \hline +Travan 40 & Travan & 20 GB & ?? GB/hr \\ \hline +DDS-4 & DAT & 20 GB & 11 GB/hr \\ \hline +VXA-1 & Exabyte & 33 GB & 11 GB/hr \\ \hline +DAT-72 & DAT & 36 GB & 13 GB/hr \\ \hline +DLT IV & DLT8000 & 40 GB & 22 GB/hr \\ \hline +VXA-2 & Exabyte & 80 GB & 22 GB/hr \\ \hline +Half-high Ultrum 1 & LTO 1 & 100 GB & 27 GB/hr \\ \hline +Ultrium 1 & LTO 1 & 100 GB & 54 GB/hr \\ \hline +Super DLT 1 & SDLT 220 & 110 GB & 40 GB/hr \\ \hline +VXA-3 & Exabyte & 160 GB & 43 GB/hr \\ \hline +Super DLT I & SDLT 320 & 160 GB & 58 GB/hr \\ \hline +Ultrium 2 & LTO 2 & 200 GB & 108 GB/hr \\ \hline +Super DLT II & SDLT 600 & 300 GB & 127 GB/hr \\ \hline +VXA-4 & Exabyte & 320 GB & 86 GB/hr \\ \hline +Ultrium 3 & LTO 3 & 400 GB & 216 GB/hr \\ \hline \end{tabular} - diff --git a/docs/manual/supportedoses.tex b/docs/manual/supportedoses.tex index 97bf1aab..c24d4bca 100644 --- a/docs/manual/supportedoses.tex +++ b/docs/manual/supportedoses.tex @@ -22,7 +22,7 @@ is defective. You must remove this directory prior to running Bacula, or you can simply change the name to {\bf /lib/tls-broken}) then you must reboot your machine (one of the few times Linux must be rebooted). If you are not able to remove/rename /lib/tls, an alternative is to set the environment -variable ``LD\_ASSUME\_KERNEL=2.4.19'' prior to executing Bacula. For this +variable "LD\_ASSUME\_KERNEL=2.4.19" prior to executing Bacula. For this option, you do not need to reboot, and all programs other than Bacula will continue to use /lib/tls. diff --git a/docs/manual/tapetesting.tex b/docs/manual/tapetesting.tex index e8ed0ac0..37e437aa 100644 --- a/docs/manual/tapetesting.tex +++ b/docs/manual/tapetesting.tex @@ -482,7 +482,7 @@ ioctl(MTEOM)} function. Then Bacula uses the {\bf ioctl(MTIOCGET)} function to retrieve the current file position from the {\bf mt\_fileno} field. Some SCSI tape drivers will use a fast means of seeking to the end of the medium and in doing so, they will not know the current file position and hence return a {\bf --1}. As a consequence, if you get {\bf ``This is NOT correct!''} in the +-1}. As a consequence, if you get {\bf "This is NOT correct!"} in the positioning tests, this may be the cause. You must correct this condition in order for Bacula to work. diff --git a/docs/manual/tips.tex b/docs/manual/tips.tex index 6c165016..21d6b832 100644 --- a/docs/manual/tips.tex +++ b/docs/manual/tips.tex @@ -225,7 +225,7 @@ command: \end{verbatim} \normalsize -which runs my ``watchdog'' script. As an example, I have added the Job codes +which runs my "watchdog" script. As an example, I have added the Job codes \%c and \%d which will cause the Client name and the Director's name to be passed to the script. For example, if the Client's name is {\bf Watchdog} and the Director's name is {\bf main-dir} then referencing \$1 in the script would @@ -623,7 +623,7 @@ run the job. \index[general]{Autochanger!Automatic Labeling Using Your } \addcontentsline{toc}{subsection}{Automatic Labeling Using Your Autochanger} -If you have an autochanger but it does not support barcodes, using a ``trick'' +If you have an autochanger but it does not support barcodes, using a "trick" you can make Bacula automatically label all the volumes in your autochanger's magazine. @@ -784,8 +784,8 @@ Include. This tip also comes from Marc Brueckner. (Note, this tip is probably outdated by the addition of {\bf ClientRunBeforJob} and {\bf ClientRunAfterJob} Job -records, but the technique still could be useful.) First I thought the ``Run -Before Job'' statement in the Job-resource is for executing a script on the +records, but the technique still could be useful.) First I thought the "Run +Before Job" statement in the Job-resource is for executing a script on the remote machine(the machine to be backed up). It could be usefull to execute scripts on the remote machine e.g. for stopping databases or other services while doing the backup. (Of course I have to start the services again when the @@ -827,7 +827,7 @@ ssh -i Bacula_key -l root "ls -la" \end{verbatim} \normalsize -This should execute the ``ls -la'' command on the remote machine. +This should execute the "ls -la" command on the remote machine. Now you could add lines like the following to your Director's conf file: @@ -937,8 +937,8 @@ say thank you and let's bacula continue it's backup. So you can schedule and run backups without ever having to log on or see the console. To make the whole thing work you need to create a Device resource which looks -something like this (``Archive Device'', ``Maximum Changer Wait'', ``Media -Type'' and ``Label media'' may have different values): +something like this ("Archive Device", "Maximum Changer Wait", "Media +Type" and "Label media" may have different values): \footnotesize \begin{verbatim} @@ -960,7 +960,7 @@ Device { \normalsize As the script has to emulate the complete wisdom of a mtx-changer it has an -internal ``database'' containing where which tape is stored, you can see this on +internal "database" containing where which tape is stored, you can see this on the following line: \footnotesize @@ -971,8 +971,8 @@ VOL-0007 VOL-0008 VOL-0009 VOL-0010 VOL-0011 VOL-0012" \normalsize The above should be all on one line, and it effectivly tells Bacula that -volume ``VOL-0001'' is located in slot 1 (which is our lowest slot), that -volume ``VOL-0002'' is located in slot 2 and so on.. +volume "VOL-0001" is located in slot 1 (which is our lowest slot), that +volume "VOL-0002" is located in slot 2 and so on.. The script also maintains a logfile (/var/log/mtx.log) where you can monitor its operation. diff --git a/docs/manual/tls.tex b/docs/manual/tls.tex index 1ef94dfc..132fc239 100644 --- a/docs/manual/tls.tex +++ b/docs/manual/tls.tex @@ -18,7 +18,7 @@ Validation \item Forward Secrecy Support via Diffie-Hellman Ephemeral Keying \end{itemize} -This document will refer to both ``server'' and ``client'' contexts. These +This document will refer to both "server" and "client" contexts. These terms refer to the accepting and initiating peer, respectively. Diffie-Hellman anonymous ciphers are not supported by this code. The diff --git a/docs/manual/tutorial.tex b/docs/manual/tutorial.tex index f52cc2a6..b449e7a0 100644 --- a/docs/manual/tutorial.tex +++ b/docs/manual/tutorial.tex @@ -791,9 +791,9 @@ Client { \normalsize Then make sure that the Address parameter in the Storage resource is set to -the fully qualified domain name and not to something like ``localhost''. The +the fully qualified domain name and not to something like "localhost". The address specified is sent to the File daemon (client) and it must be a fully -qualified domain name. If you pass something like ``localhost'' it will not +qualified domain name. If you pass something like "localhost" it will not resolve correctly and will result in a time out when the File daemon fails to connect to the Storage daemon. @@ -894,7 +894,7 @@ The result is that Bacula will continue the previous Job writing the backup to the new Volume. If you have a Pool of volumes and Bacula is cycling through them, instead of -the above message ``Cannot find any appendable volumes.'', Bacula may ask you +the above message "Cannot find any appendable volumes.", Bacula may ask you to mount a specific volume. In that case, you should attempt to do just that. If you do not have the volume any more (for any of a number of reasons), you can simply mount another volume from the same Pool, providing it is @@ -1246,7 +1246,7 @@ recycling, please see the this manual. If you run a Bacula job, and you have no labeled tapes in the Pool, Bacula -will inform you, and you can create them ``on-the-fly'' so to speak. In my +will inform you, and you can create them "on-the-fly" so to speak. In my case, I label my tapes with the date, for example: {\bf DLT-18April02}. See below for the details of using the {\bf label} command. diff --git a/docs/manual/vars.tex b/docs/manual/vars.tex index 69fd1e45..dc01842b 100644 --- a/docs/manual/vars.tex +++ b/docs/manual/vars.tex @@ -28,7 +28,7 @@ controlled loop, support of arithmetic expressions in the loop start, step and end conditions, and recursive expansion. When using variable expansion characters in a Volume Label Format record, the -format should always be enclosed in double quotes ({\bf ``}). +format should always be enclosed in double quotes ({\bf "}). For example, {\bf \$\{HOME\}} will be replaced by your home directory as defined in the environment. If you have defined the variable {\bf xxx} to be @@ -90,7 +90,7 @@ prior to executing Bacula. Environment variables may be either scalar or an array, where the elements of the array are referenced by subscripting the variable name (e.g. {\bf \$\{Months[3]\}}). Environment variable arrays are defined by separating the elements with a vertical bar ({\bf |}), thus {\bf -set Months=''Jan|Feb|Mar|Apr|...``} defines an environment variable named +set Months="Jan|Feb|Mar|Apr|..."} defines an environment variable named {\bf Month} that will be treated as an array, and the reference {\bf \$\{Months[3]\}} will yield {\bf Mar}. The elements of the array can have differing lengths. diff --git a/docs/manual/verify.tex b/docs/manual/verify.tex index 2eb12b36..1c16850f 100644 --- a/docs/manual/verify.tex +++ b/docs/manual/verify.tex @@ -39,7 +39,7 @@ the files on the Client to the last {\bf InitCatalog} that is stored in the catalog and to report any differences. See the example below for the format of the output. -You decide what files you want to form your ``snapshot'' by specifying them in +You decide what files you want to form your "snapshot" by specifying them in a {\bf FileSet} resource, and normally, they will be system files that do not change, or that only certain features change. @@ -371,4 +371,3 @@ Catalog { } \end{verbatim} \normalsize - diff --git a/docs/manual/version.tex b/docs/manual/version.tex index 09612cef..e96ec72d 100644 --- a/docs/manual/version.tex +++ b/docs/manual/version.tex @@ -1 +1 @@ -1.37.32 (26 July 2005) +1.37.34 (03 August 2005) diff --git a/docs/manual/win32.tex b/docs/manual/win32.tex index 836ab161..d0ff1ec3 100644 --- a/docs/manual/win32.tex +++ b/docs/manual/win32.tex @@ -319,7 +319,7 @@ Marc Brueckner for doing the tests: \hline {WinMe } & {Linux } & {Works (SYSTEM permissions) } \\ \hline {\ } & {\ } & {\ } \\ \hline {WinXP } & {WinXP } & {Works } \\ - \hline {WinXP } & {WinNT } & {Works (all files OK, but got ``The data is invalid'' + \hline {WinXP } & {WinNT } & {Works (all files OK, but got "The data is invalid" message) } \\ \hline {WinXP } & {WinMe } & {Error: Win32 data stream not supported. } \\ \hline {WinXP } & {WinMe } & {Works if {\bf Portable=yes} specified during backup.} \\ @@ -412,9 +412,9 @@ JobId 1 Job NightlySave.2005-07-23_13.25.45 is running. SDReadSeqNo=5 fd=352 \end{verbatim} \normalsize -Here, you see under Running Jobs that JobId 1 is ``VSS Backup Job started ...'' +Here, you see under Running Jobs that JobId 1 is "VSS Backup Job started ..." This means that VSS is enabled for that job. If VSS is not enabled, it will -simply show ``Backup Job started ...'' without the letters VSS. +simply show "Backup Job started ..." without the letters VSS. The second way to know that the job was backed up with VSS is to look at the Job Report, which will look something like the following: @@ -546,7 +546,7 @@ The following solution was provided by Dan Langille \lt{}dan at langille in the dot org domain\gt{}. The steps are performed using Windows 2000 Server but they should apply to most Win32 platforms. The procedure outlines how to deal with a problem which arises when a restore creates a top-level new directory. -In this example, ``top-level'' means something like {\bf +In this example, "top-level" means something like {\bf c:\textbackslash{}src}, not {\bf c:\textbackslash{}tmp\textbackslash{}src} where {\bf c:\textbackslash{}tmp} already exists. If a restore job specifies / as the {\bf Where:} value, this problem will arise. @@ -578,12 +578,12 @@ You should see something like this: {\bf SYSTEM} in this example as shown below). \includegraphics{./properties-security-advanced-owner.eps} -\item ensure the ``Replace owner on subcontainers and objects'' box is +\item ensure the "Replace owner on subcontainers and objects" box is checked \item click on OK -\item When the message ``You do not have permission to read the contents of +\item When the message "You do not have permission to read the contents of directory c:\textbackslash{}src\textbackslash{}basis. Do you wish to replace - the directory permissions with permissions granting you Full Control?'', click + the directory permissions with permissions granting you Full Control?", click on Yes. \includegraphics{./confirm.eps} -- 2.39.5