From 0ab3e99332537bdae87da7e742ee35bda3602260 Mon Sep 17 00:00:00 2001 From: "Jason S. Evans" Date: Wed, 24 Feb 2016 15:10:00 +0100 Subject: [PATCH] removed temp file and added Revision History to Linux-Complete-Backup-and-Recovery-HOWTO-REWRITE.adoc --- .../Linux-Complete-Backup-HTML.adoc | 243 --------- ...ete-Backup-and-Recovery-HOWTO-REWRITE.adoc | 482 ++---------------- 2 files changed, 37 insertions(+), 688 deletions(-) delete mode 100644 LDP/users/Jason-Evans/Linux-Complete-Backup-HTML.adoc diff --git a/LDP/users/Jason-Evans/Linux-Complete-Backup-HTML.adoc b/LDP/users/Jason-Evans/Linux-Complete-Backup-HTML.adoc deleted file mode 100644 index 782fc1eb..00000000 --- a/LDP/users/Jason-Evans/Linux-Complete-Backup-HTML.adoc +++ /dev/null @@ -1,243 +0,0 @@ -[[linux-complete-backup-and-recovery-howto]] -link:[]Linux Complete Backup and Recovery HOWTO ------------------------------------------------ - -[[charles-curley]] -link:[Charles Curley] -^^^^^^^^^^^^^^^^^^^^^ - -           `` + -         - -*Revision History* - -Revision 2.1 - -2006-03-28 - -Revised by: c^2 - -Added notes for NTFS. Edited the To Do list. Started work on LVM and -using http://www.finnix.org/[finnix]. - -Revision 2.0 - -2005-10-12 - -Revised by: c^2 - -Notes for Fedora Core 4. Removed notes for older versions of FC and Red -Hat. Also, changes in the writeup and scripts to reflect using -http://www.knoppix.org/[Knoppix] instead of -http://www.toms.net/rb[tomsrtbt]. See the scripts for change notes. -Changed some scripts so that long lines don't fall off the right side of -printed pages (oops). - -Revision 1.8 - -2005-02-19 - -Revised by: c^2 - -Added notes for Fedora Core 3 - -Revision 1.7 - -2004-05-11 - -Revised by: c^2 - -Adjusted copyright language. - -Revision 1.6 - -2004-04-29 - -Revised by: c^2 - -Added http://www.knoppix.org/[Knoppix] notes, Syslinux, PPART, QtParted, -some other rescue CDs, and made some fixes. - -Revision 1.5 - -2003-12-19 - -Revised by: c^2 - -Fedora 1 and GRUB notes. - -Revision 1.4 - -2003-08-17 - -Revised by: c^2 - -Some notes on burning CD-ROMs, and more on files to exclude. - -Revision 1.3 - -2003-04-24 - -Revised by: c^2 - -Substituted new email address and URL for old. - -Revision 1.2 - -2003-02-12 - -Revised by: c^2 - -Added Red Hat 8.0 notes, support for FAT32, split the first stage -restore scripts, and other minor changes. Notes on -link:applicationspecificnotes.html#AMANDA[Amanda]. - -Revision 1.1 - -2002-09-10 - -Revised by: c^2 - -New code to handle ext3 partitions in -link:thescripts.html#MAKE.FDISK[`make.fdisk`], and a note on -link:creatingthestage1backup.html#INITRD[`initrd`]. - -Revision 1.0 - -2002-07-24 - -Revised by: c^2 - -We now use bz2 compression in the first stage, have the run time option -to check for bad blocks, and have a script that runs the entire first -stage. - -link:[] - -Imagine your disk drive has just become a very expensive hockey puck. -Imagine you have had a fire, and your computer case now looks like -something Salvador Dalĩ would like to paint. Now what? - -Total restore, sometimes called bare metal recovery, is the process of -rebuilding a computer after a catastrophic failure. In order to make a -total restoration, you must have complete backups, not only of your file -system, but of partition information and other data. This HOWTO is a -step-by-step tutorial on how to back up a Linux computer so as to be -able to make a bare metal recovery, and how to make that bare metal -recovery. It includes some related scripts. - -''''' - -*Table of Contents* - -1. link:intro.html[Introduction] - -1.1. link:intro.html#COPYRIGHT[Copyright Information] - -1.2. link:intro.html#DISCLAIMERS[Disclaimers] - -1.3. link:intro.html#NEWVERSIONS[New Versions] - -1.4. link:intro.html#CREDITS[Credits] - -1.5. link:intro.html#FEEDBACK[Feedback] - -1.6. link:intro.html#TRANSLATIONS[Translations] - -2. link:overview.html[Overview] - -2.1. link:overview.html#LIMITATIONS[Limitations] - -3. link:preparation.html[Preparation] - -3.1. link:preparation.html#INSTALLINGZIPDRIVE[Installing the ZIP Drive] - -4. link:creatingthestage1backup.html[Creating the Stage 1 Back Up] - -4.1. link:creatingthestage1backup.html#THEMEANDVARIATIONS[Theme And -Variations] - -5. link:firststagerestore.html[First Stage Restore] - -5.1. link:firststagerestore.html#BOOTING[Booting] - -5.2. link:firststagerestore.html#RESTORATION[Restoration] - -6. link:secondstagerestoration.html[Second Stage Restoration] - -7. link:distributionspecificnotes.html[Distribution Specific Notes] - -7.1. link:distributionspecificnotes.html#FEDORA3[Fedora Core 3 and 4] - -7.2. link:distributionspecificnotes.html#KNOPPIX[Knoppix] - -7.3. link:distributionspecificnotes.html#AEN583[finnix] - -8. link:applicationspecificnotes.html[Application Specific Notes] - -8.1. link:applicationspecificnotes.html#LVM[Logical Volume Manager] - -8.2. link:applicationspecificnotes.html#SELINUX[Selinux] - -8.3. link:applicationspecificnotes.html#GRUB[GRUB] - -8.4. link:applicationspecificnotes.html#TRIPWIRE[Tripwire] - -8.5. link:applicationspecificnotes.html#SQUID[Squid] - -8.6. link:applicationspecificnotes.html#ARKEIA[Arkeia] - -8.7. link:applicationspecificnotes.html#AMANDA[Amanda] - -8.8. link:applicationspecificnotes.html#NTFS[NTFS] - -9. link:someadvicefordisasterrecovery.html[Some Advice for Disaster -Recovery] - -10. link:whatnow.html[What Now?] - -10.1. link:whatnow.html#TODO[To Do] - -11. link:thescripts.html[The Scripts] - -11.1. link:thescripts.html#FIRSTSTAGE[First Stage] - -11.2. link:thescripts.html#SECONDSTAGE[Second Stage] - -11.3. link:thescripts.html#BACKUPSERVERSCRIPTS[Backup Server Scripts] - -12. link:resources.html[Resources] - -A. link:appendix1gfdl.html[GNU Free Documentation License] - -0. link:gfdl02.html[PREAMBLE] - -1. link:gfdl03.html[APPLICABILITY AND DEFINITIONS] - -2. link:gfdl04.html[VERBATIM COPYING] - -3. link:gfdl05.html[COPYING IN QUANTITY] - -4. link:gfdl06.html[MODIFICATIONS] - -5. link:gfdl07.html[COMBINING DOCUMENTS] - -6. link:gfdl08.html[COLLECTIONS OF DOCUMENTS] - -7. link:gfdl09.html[AGGREGATION WITH INDEPENDENT WORKS] - -8. link:gfdl10.html[TRANSLATION] - -9. link:gfdl11.html[TERMINATION] - -10. link:gfdl12.html[FUTURE REVISIONS OF THIS LICENSE] - -11. link:gfdl13.html[How to use this License for your documents] - -''''' - -[cols=",,",] -|=========================== -|  |  |link:intro.html[Next] -|  |  |Introduction -|=========================== diff --git a/LDP/users/Jason-Evans/Linux-Complete-Backup-and-Recovery-HOWTO-REWRITE.adoc b/LDP/users/Jason-Evans/Linux-Complete-Backup-and-Recovery-HOWTO-REWRITE.adoc index eb0797b7..de48983c 100755 --- a/LDP/users/Jason-Evans/Linux-Complete-Backup-and-Recovery-HOWTO-REWRITE.adoc +++ b/LDP/users/Jason-Evans/Linux-Complete-Backup-and-Recovery-HOWTO-REWRITE.adoc @@ -3,9 +3,9 @@ Outline: * Backups Strategies ** File level *** Scripts - *** Applications i.e. Bakula, NetBackup + *** Applications i.e. Bakula, NetBackup -- http://blog.bacula.org/documentation/documentation/ *** Cloud Storage -- https://en.wikipedia.org/wiki/Comparison_of_online_backup_services - **** Dropbox + **** Dropbox -- https://www.dropbox.com/en_GB/install?os=lnx **** Google -- https://cloud.google.com/storage/docs/gsutil_install **** AWS -- http://s3tools.org/s3cmd **** Specialty Storage @@ -38,46 +38,24 @@ Outline: +== Revision History +[cols="<,<,<,<",options="header",] +|========================================================================================================================================================== +|Revision |Date |Person |Note +|Revision 3.0 |2016-02-24 |Revised by: Jason Evans |Complete rewrite +|Revision 2.1 |2006-03-28 |Revised by: c^2 |Added notes for NTFS. Edited the To Do list. Started work on LVM and using http://www.finnix.org/[finnix]. +|Revision 2.0 |2005-10-12 |Revised by: c^2 |Notes for Fedora Core 4. Removed notes for older versions of FC and Red Hat. Also, changes in the writeup and scripts to reflect using http://www.knoppix.org/[Knoppix] instead of http://www.toms.net/rb[tomsrtbt]. See the scripts for change notes. Changed some scripts so that long lines don't fall off the right side of printed pages (oops). +|Revision 1.8 |2005-02-19 |Revised by: c^2 |Added notes for Fedora Core 3 +|Revision 1.7 |2004-05-11 |Revised by: c^2 |Adjusted copyright language. +|Revision 1.6 |2004-04-29 |Revised by: c^2 |Added http://www.knoppix.org/[Knoppix] notes, Syslinux, PPART, QtParted, some other rescue CDs, and made some fixes. +|Revision 1.5 |2003-12-19 |Revised by: c^2 |Fedora 1 and GRUB notes. +|Revision 1.4 |2003-08-17 |Revised by: c^2 |Some notes on burning CD-ROMs, and more on files to exclude. +|Revision 1.3 |2003-04-24 |Revised by: c^2 |Substituted new email address and URL for old. +|Revision 1.2 |2003-02-12 |Revised by: c^2 |Added Red Hat 8.0 notes, support for FAT32, split the first stage restore scripts, and other minor changes. Notes on link:applicationspecificnotes.html#AMANDA[Amanda]. +|Revision 1.1 |2002-09-10 |Revised by: c^2 |New code to handle ext3 partitions in link:thescripts.html#MAKE.FDISK[`make.fdisk`], and a note on link:creatingthestage1backup.html#INITRD[`initrd`]. +|Revision 1.0 |2002-07-24 |Revised by: c^2 |We now use bz2 compression in the first stage, have the run time option to check for bad blocks, and have a script that runs the entire first stage. +|========================================================================================================================================================== - - - - - - - - - - -* Bare metal - -** LVM - -** File Level Backup - -** Network and Cloud Storage (NAS/File server) -*** Scripts -*** Backula -**** https://help.ubuntu.com/lts/serverguide/bacula.html -*** Ubuntu/Debian -**** https://help.ubuntu.com/lts/serverguide/backup-shellscripts.html -*** CentOS 7 - -** Physical Storage - - -** VM Cloning -*** Ubuntu/Debian -*** CentOS 7 - -* VM -** VirtualBox -** Xen/KVM - -* Docker - - - [[intro]] Introduction ------------ @@ -90,18 +68,7 @@ The process and scripts explained in this HOWTO will save re-installing the oper Copyright Information ~~~~~~~~~~~~~~~~~~~~~ -Copyright © 2001 through last date of modification Charles Curley and -distributed under the terms of the GNU Free Documentation License (GFDL) -license, stated below. Permission is granted to copy, distribute and/or -modify this document under the terms of the GNU Free Documentation -License, Version 1.1 or any later version published by the Free Software -Foundation; with no Invariant Sections, with no Front-Cover Texts, and -with no Back-Cover Texts. A copy of the license is included in the -section entitled link:#appendix1gfdl[``GNU Free Documentation -License'']. - -If you have any questions, please contact -mailto:linux-howto at metalab.unc.edu[linux-howto at metalab.unc.edu]. +This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/4.0/. [[disclaimers]] Disclaimers @@ -126,34 +93,29 @@ major installation and backups at regular intervals. In addition, you are strongly recommended to use a sacrificial experimental computer when mucking with the material, especially the scripts, in this HOWTO. + + [[newversions]] New Versions ~~~~~~~~~~~~ -You can find this document at its link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO.html[home page] or -at the http://www.tldp.org/[Linux Documentation Project] web site in -many formats. Please comment to +[cols="^,^,^",] +|============================================================================= +|15.1.2016 |v1.0 Converted and edited for TLDP |Jason Evans +|15.2.2016 |v1.1 Changed format to asciidoc and made corrections |Jason Evans +|============================================================================= -Depending on your browser, you may have to hold down the shift button -while you click on these in order to get them to download. +You can find this document at its link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO.html[home page] or at the http://www.tldp.org/[Linux Documentation Project] web site in many formats. Please comment to -* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.chunky.html.tar.bz2[bzip2 -compressed chunky (lots of small pages. Faster reading.) HTML]. -* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.smooth.html.tar.bz2[bzip2 -compressed smooth (one monster page -- no chunks. Easier to search.) -HTML]. -* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.ps.bz2[bzip2 -compressed postscript (US letter format)]. -* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.pdf.bz2[bzip2 -compressed PDF (US letter format)]. -* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.txt.bz2[bzip2 -compressed raw ASCII text]. -* Use the -link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.tar.bz2[source], -Luke. -* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/md5sums[MD5] and -link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/sha1sums[SHA1] -sums. +Depending on your browser, you may have to hold down the shift button while you click on these in order to get them to download. + +* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.chunky.html.tar.bz2[bzip2 compressed chunky (lots of small pages. Faster reading.) HTML]. +* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.smooth.html.tar.bz2[bzip2 compressed smooth (one monster page -- no chunks. Easier to search.) HTML]. +* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.ps.bz2[bzip2 compressed postscript (US letter format)]. +* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.pdf.bz2[bzip2 compressed PDF (US letter format)]. +* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.txt.bz2[bzip2 compressed raw ASCII text]. +* Use the link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.tar.bz2[source], Luke. +* link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/md5sums[MD5] and link:&myurl;/Linux-Complete-Backup-and-Recovery-HOWTO/sha1sums[SHA1] sums. To ensure that you got a good download, validate the files against the checksums above. The easiest way to do this is to pull in the sha1sum or @@ -1803,373 +1765,3 @@ debian system on cd.'' ** The http://www.frozentech.com/content/livecd.php[List of Live CDs] has more CD based disties. -[[appendix1gfdl]] -GNU Free Documentation License ------------------------------- - -Version 1.1, March 2000 - -____________________________________________________________________________________________________________________________________________________________________________________________________________________________________ -Copyright (C) 2000 Free Software Foundation, Inc. 51 Franklin Street, -Fifth Floor, Boston, MA 02110-1301, USA Everyone is permitted to copy -and distribute verbatim copies of this license document, but changing it -is not allowed. -____________________________________________________________________________________________________________________________________________________________________________________________________________________________________ - -[[gfdl02]] -PREAMBLE --------- - -The purpose of this License is to make a manual, textbook, or other -written document "free" in the sense of freedom: to assure everyone the -effective freedom to copy and redistribute it, with or without modifying -it, either commercially or noncommercially. Secondarily, this License -preserves for the author and publisher a way to get credit for their -work, while not being considered responsible for modifications made by -others. - -This License is a kind of "copyleft", which means that derivative works -of the document must themselves be free in the same sense. It -complements the GNU General Public License, which is a copyleft license -designed for free software. - -We have designed this License in order to use it for manuals for free -software, because free software needs free documentation: a free program -should come with manuals providing the same freedoms that the software -does. But this License is not limited to software manuals; it can be -used for any textual work, regardless of subject matter or whether it is -published as a printed book. We recommend this License principally for -works whose purpose is instruction or reference. - -[[gfdl03]] -APPLICABILITY AND DEFINITIONS ------------------------------ - -This License applies to any manual or other work that contains a notice -placed by the copyright holder saying it can be distributed under the -terms of this License. The "Document", below, refers to any such manual -or work. Any member of the public is a licensee, and is addressed as -"you". - -A "Modified Version" of the Document means any work containing the -Document or a portion of it, either copied verbatim, or with -modifications and/or translated into another language. - -A "Secondary Section" is a named appendix or a front-matter section of -the Document that deals exclusively with the relationship of the -publishers or authors of the Document to the Document's overall subject -(or to related matters) and contains nothing that could fall directly -within that overall subject. (For example, if the Document is in part a -textbook of mathematics, a Secondary Section may not explain any -mathematics.) The relationship could be a matter of historical -connection with the subject or with related matters, or of legal, -commercial, philosophical, ethical or political position regarding them. - -The "Invariant Sections" are certain Secondary Sections whose titles are -designated, as being those of Invariant Sections, in the notice that -says that the Document is released under this License. - -The "Cover Texts" are certain short passages of text that are listed, as -Front-Cover Texts or Back-Cover Texts, in the notice that says that the -Document is released under this License. - -A "Transparent" copy of the Document means a machine-readable copy, -represented in a format whose specification is available to the general -public, whose contents can be viewed and edited directly and -straightforwardly with generic text editors or (for images composed of -pixels) generic paint programs or (for drawings) some widely available -drawing editor, and that is suitable for input to text formatters or for -automatic translation to a variety of formats suitable for input to text -formatters. A copy made in an otherwise Transparent file format whose -markup has been designed to thwart or discourage subsequent modification -by readers is not Transparent. A copy that is not "Transparent" is -called "Opaque". - -Examples of suitable formats for Transparent copies include plain ASCII -without markup, Texinfo input format, LaTeX input format, SGML or XML -using a publicly available DTD, and standard-conforming simple HTML -designed for human modification. Opaque formats include PostScript, PDF, -proprietary formats that can be read and edited only by proprietary word -processors, SGML or XML for which the DTD and/or processing tools are -not generally available, and the machine-generated HTML produced by some -word processors for output purposes only. - -The "Title Page" means, for a printed book, the title page itself, plus -such following pages as are needed to hold, legibly, the material this -License requires to appear in the title page. For works in formats which -do not have any title page as such, "Title Page" means the text near the -most prominent appearance of the work's title, preceding the beginning -of the body of the text. - -[[gfdl04]] -VERBATIM COPYING ----------------- - -You may copy and distribute the Document in any medium, either -commercially or noncommercially, provided that this License, the -copyright notices, and the license notice saying this License applies to -the Document are reproduced in all copies, and that you add no other -conditions whatsoever to those of this License. You may not use -technical measures to obstruct or control the reading or further copying -of the copies you make or distribute. However, you may accept -compensation in exchange for copies. If you distribute a large enough -number of copies you must also follow the conditions in section 3. - -You may also lend copies, under the same conditions stated above, and -you may publicly display copies. - -[[gfdl05]] -COPYING IN QUANTITY -------------------- - -If you publish printed copies of the Document numbering more than 100, -and the Document's license notice requires Cover Texts, you must enclose -the copies in covers that carry, clearly and legibly, all these Cover -Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the -back cover. Both covers must also clearly and legibly identify you as -the publisher of these copies. The front cover must present the full -title with all words of the title equally prominent and visible. You may -add other material on the covers in addition. Copying with changes -limited to the covers, as long as they preserve the title of the -Document and satisfy these conditions, can be treated as verbatim -copying in other respects. - -If the required texts for either cover are too voluminous to fit -legibly, you should put the first ones listed (as many as fit -reasonably) on the actual cover, and continue the rest onto adjacent -pages. - -If you publish or distribute Opaque copies of the Document numbering -more than 100, you must either include a machine-readable Transparent -copy along with each Opaque copy, or state in or with each Opaque copy a -publicly-accessible computer-network location containing a complete -Transparent copy of the Document, free of added material, which the -general network-using public has access to download anonymously at no -charge using public-standard network protocols. If you use the latter -option, you must take reasonably prudent steps, when you begin -distribution of Opaque copies in quantity, to ensure that this -Transparent copy will remain thus accessible at the stated location -until at least one year after the last time you distribute an Opaque -copy (directly or through your agents or retailers) of that edition to -the public. - -It is requested, but not required, that you contact the authors of the -Document well before redistributing any large number of copies, to give -them a chance to provide you with an updated version of the Document. - -[[gfdl06]] -MODIFICATIONS -------------- - -You may copy and distribute a Modified Version of the Document under the -conditions of sections 2 and 3 above, provided that you release the -Modified Version under precisely this License, with the Modified Version -filling the role of the Document, thus licensing distribution and -modification of the Modified Version to whoever possesses a copy of it. -In addition, you must do these things in the Modified Version: - -A. Use in the Title Page (and on the covers, if any) a title distinct -from that of the Document, and from those of previous versions (which -should, if there were any, be listed in the History section of the -Document). You may use the same title as a previous version if the -original publisher of that version gives permission. -B. List on the Title Page, as authors, one or more persons or entities -responsible for authorship of the modifications in the Modified Version, -together with at least five of the principal authors of the Document -(all of its principal authors, if it has less than five). -C. State on the Title page the name of the publisher of the Modified -Version, as the publisher. -D. Preserve all the copyright notices of the Document. -E. Add an appropriate copyright notice for your modifications adjacent -to the other copyright notices. -F. Include, immediately after the copyright notices, a license notice -giving the public permission to use the Modified Version under the terms -of this License, in the form shown in the Addendum below. -G. Preserve in that license notice the full lists of Invariant Sections -and required Cover Texts given in the Document's license notice. -H. Include an unaltered copy of this License. -I. Preserve the section entitled "History", and its title, and add to -it an item stating at least the title, year, new authors, and publisher -of the Modified Version as given on the Title Page. If there is no -section entitled "History" in the Document, create one stating the -title, year, authors, and publisher of the Document as given on its -Title Page, then add an item describing the Modified Version as stated -in the previous sentence. -J. Preserve the network location, if any, given in the Document for -public access to a Transparent copy of the Document, and likewise the -network locations given in the Document for previous versions it was -based on. These may be placed in the "History" section. You may omit a -network location for a work that was published at least four years -before the Document itself, or if the original publisher of the version -it refers to gives permission. -K. In any section entitled "Acknowledgements" or "Dedications", -preserve the section's title, and preserve in the section all the -substance and tone of each of the contributor acknowledgements and/or -dedications given therein. -L. Preserve all the Invariant Sections of the Document, unaltered in -their text and in their titles. Section numbers or the equivalent are -not considered part of the section titles. -M. Delete any section entitled "Endorsements". Such a section may not -be included in the Modified Version. -N. Do not retitle any existing section as "Endorsements" or to conflict -in title with any Invariant Section. - -If the Modified Version includes new front-matter sections or appendices -that qualify as Secondary Sections and contain no material copied from -the Document, you may at your option designate some or all of these -sections as invariant. To do this, add their titles to the list of -Invariant Sections in the Modified Version's license notice. These -titles must be distinct from any other section titles. - -You may add a section entitled "Endorsements", provided it contains -nothing but endorsements of your Modified Version by various -parties--for example, statements of peer review or that the text has -been approved by an organization as the authoritative definition of a -standard. - -You may add a passage of up to five words as a Front-Cover Text, and a -passage of up to 25 words as a Back-Cover Text, to the end of the list -of Cover Texts in the Modified Version. Only one passage of Front-Cover -Text and one of Back-Cover Text may be added by (or through arrangements -made by) any one entity. If the Document already includes a cover text -for the same cover, previously added by you or by arrangement made by -the same entity you are acting on behalf of, you may not add another; -but you may replace the old one, on explicit permission from the -previous publisher that added the old one. - -The author(s) and publisher(s) of the Document do not by this License -give permission to use their names for publicity for or to assert or -imply endorsement of any Modified Version. - -[[gfdl07]] -COMBINING DOCUMENTS -------------------- - -You may combine the Document with other documents released under this -License, under the terms defined in section 4 above for modified -versions, provided that you include in the combination all of the -Invariant Sections of all of the original documents, unmodified, and -list them all as Invariant Sections of your combined work in its license -notice. - -The combined work need only contain one copy of this License, and -multiple identical Invariant Sections may be replaced with a single -copy. If there are multiple Invariant Sections with the same name but -different contents, make the title of each such section unique by adding -at the end of it, in parentheses, the name of the original author or -publisher of that section if known, or else a unique number. Make the -same adjustment to the section titles in the list of Invariant Sections -in the license notice of the combined work. - -In the combination, you must combine any sections entitled "History" in -the various original documents, forming one section entitled "History"; -likewise combine any sections entitled "Acknowledgements", and any -sections entitled "Dedications". You must delete all sections entitled -"Endorsements." - -[[gfdl08]] -COLLECTIONS OF DOCUMENTS ------------------------- - -You may make a collection consisting of the Document and other documents -released under this License, and replace the individual copies of this -License in the various documents with a single copy that is included in -the collection, provided that you follow the rules of this License for -verbatim copying of each of the documents in all other respects. - -You may extract a single document from such a collection, and distribute -it individually under this License, provided you insert a copy of this -License into the extracted document, and follow this License in all -other respects regarding verbatim copying of that document. - -[[gfdl09]] -AGGREGATION WITH INDEPENDENT WORKS ----------------------------------- - -A compilation of the Document or its derivatives with other separate and -independent documents or works, in or on a volume of a storage or -distribution medium, does not as a whole count as a Modified Version of -the Document, provided no compilation copyright is claimed for the -compilation. Such a compilation is called an "aggregate", and this -License does not apply to the other self-contained works thus compiled -with the Document, on account of their being thus compiled, if they are -not themselves derivative works of the Document. - -If the Cover Text requirement of section 3 is applicable to these copies -of the Document, then if the Document is less than one quarter of the -entire aggregate, the Document's Cover Texts may be placed on covers -that surround only the Document within the aggregate. Otherwise they -must appear on covers around the whole aggregate. - -[[gfdl10]] -TRANSLATION ------------ - -Translation is considered a kind of modification, so you may distribute -translations of the Document under the terms of section 4. Replacing -Invariant Sections with translations requires special permission from -their copyright holders, but you may include translations of some or all -Invariant Sections in addition to the original versions of these -Invariant Sections. You may include a translation of this License -provided that you also include the original English version of this -License. In case of a disagreement between the translation and the -original English version of this License, the original English version -will prevail. - -[[gfdl11]] -TERMINATION ------------ - -You may not copy, modify, sublicense, or distribute the Document except -as expressly provided for under this License. Any other attempt to copy, -modify, sublicense or distribute the Document is void, and will -automatically terminate your rights under this License. However, parties -who have received copies, or rights, from you under this License will -not have their licenses terminated so long as such parties remain in -full compliance. - -[[gfdl12]] -FUTURE REVISIONS OF THIS LICENSE --------------------------------- - -The Free Software Foundation may publish new, revised versions of the -GNU Free Documentation License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. See http://www.gnu.org/copyleft/. - -Each version of the License is given a distinguishing version number. If -the Document specifies that a particular numbered version of this -License "or any later version" applies to it, you have the option of -following the terms and conditions either of that specified version or -of any later version that has been published (not as a draft) by the -Free Software Foundation. If the Document does not specify a version -number of this License, you may choose any version ever published (not -as a draft) by the Free Software Foundation. - -[[gfdl13]] -How to use this License for your documents ------------------------------------------- - -To use this License in a document you have written, include a copy of -the License in the document and put the following copyright and license -notices just after the title page: - -________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________ -Copyright (c) YEAR YOUR NAME. Permission is granted to copy, distribute -and/or modify this document under the terms of the GNU Free -Documentation License, Version 1.1 or any later version published by the -Free Software Foundation; with the Invariant Sections being LIST THEIR -TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover -Texts being LIST. A copy of the license is included in the section -entitled "GNU Free Documentation License". -________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________ - -If you have no Invariant Sections, write "with no Invariant Sections" -instead of saying which ones are invariant. If you have no Front-Cover -Texts, write "no Front-Cover Texts" instead of "Front-Cover Texts being -LIST"; likewise for Back-Cover Texts. - -If your document contains nontrivial examples of program code, we -recommend releasing these examples in parallel under your choice of free -software license, such as the GNU General Public License, to permit -their use in free software.