Added parser for Mac OS com.apple.loginitems.plist Alias data

documentation/Copy in and out (CPIO) archive format.asciidoc

@@ -6,6 +6,7 @@
 :numbered!:
 [abstract]
 == Summary
+
 The copy in and out (CPIO) archive format is an archive format that predates
 TAR but is still being used e.g. in initramfs or rpm.
 
@@ -14,6 +15,7 @@ specification.
 
 [preface]
 == Document information
+
 [cols="1,5"]
 |===
 | Author(s): | Joachim Metz <[email protected]>
@@ -24,8 +26,9 @@ specification.
 
 [preface]
 == License
+
 ....
-Copyright (C) 2016, Joachim Metz <[email protected]>.
+Copyright (C) 2016-2024, Joachim Metz <[email protected]>.
 Permission is granted to copy, distribute and/or modify this document under the
 terms of the GNU Free Documentation License, Version 1.3 or any later version
 published by the Free Software Foundation; with no Invariant Sections, no
@@ -35,17 +38,20 @@ in the section entitled "GNU Free Documentation License".
 
 [preface]
 == Revision history
+
 [cols="1,1,1,5",options="header"]
 |===
 | Version | Author | Date | Comments
 | 0.0.1 | J.B. Metz | February 2016 | Initial version.
+| 0.0.2 | J.B. Metz | February 2024 | Changes for formatting.
 |===
 
 :numbered:
 == Overview
+
 The copy in and out (CPIO) archive format is an archive format that predates
 TAR but is still being used e.g. in initramfs or rpm. There are multiple
-variant of the CPIO format:
+variants of the CPIO format:
 
 * binary CPIO format
 * portable ASCII CPIO format
@@ -65,6 +71,7 @@ A CPIO file consists of:
 |===
 
 == Binary CPIO format
+
 The binary CPIO format (or "bin"), sometimes referred to as the old CPIO
 format, stores the values as either big-endian or little-endian binary data.
 
@@ -98,6 +105,7 @@ Should be set to 0
 |===
 
 == Portable ASCII CPIO format
+
 The portable ASCII CPIO format (or "odc"), sometimes referred to as the old
 character or POSIX.1 format, stores the values are as octal strings.
 
@@ -121,6 +129,7 @@ The size of the path string including the end-of-string character (NUL)
 |===
 
 == New ASCII CPIO format
+
 The new (SVR4) ASCII CPIO format stores the values as hexadecimal strings. The
 new ASCII CPIO format is technically 2 different formats one without ("newc")
 and one with a checksum ("crc"). Both support file systems having more than
@@ -158,6 +167,7 @@ Should be set to 0
 [yellow-background]*TODO: describe checksum*
 
 == Mode (permissions and type)
+
 [yellow-background]*TODO: convert text to table*
 
 ....
@@ -183,6 +193,7 @@ Should be set to 0
 The link target of a symbolic link is stored as file data.
 
 == Notes
+
 Predecessor to CPIO is the PWB/UNIX 1.0 format?
 
 ....
@@ -208,6 +219,7 @@ How do file entries with duplicate path need to be handled?
 
 [appendix]
 == GNU Free Documentation License
+
 Version 1.3, 3 November 2008
 Copyright © 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
 <http://fsf.org/>
@@ -216,6 +228,7 @@ Everyone is permitted to copy and distribute verbatim copies of this license
 document, but changing it is not allowed.
 
 === 0. PREAMBLE
+
 The purpose of this License is to make a manual, textbook, or other functional
 and useful document "free" in the sense of freedom: to assure everyone the
 effective freedom to copy and redistribute it, with or without modifying it,
@@ -236,6 +249,7 @@ recommend this License principally for works whose purpose is instruction or
 reference.
 
 === 1. APPLICABILITY AND DEFINITIONS
+
 This License applies to any manual or other work, in any medium, that contains
 a notice placed by the copyright holder saying it can be distributed under the
 terms of this License. Such a notice grants a world-wide, royalty-free license,
@@ -314,6 +328,7 @@ disclaiming warranties: any other implication that these Warranty Disclaimers
 may have is void and has no effect on the meaning of this License.
 
 === 2. 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
@@ -327,6 +342,7 @@ You may also lend copies, under the same conditions stated above, and you may
 publicly display copies.
 
 === 3. COPYING IN QUANTITY
+
 If you publish printed copies (or copies in media that commonly have printed
 covers) 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,
@@ -360,6 +376,7 @@ well before redistributing any large number of copies, to give them a chance to
 provide you with an updated version of the Document.
 
 === 4. 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
@@ -452,6 +469,7 @@ permission to use their names for publicity for or to assert or imply
 endorsement of any Modified Version.
 
 === 5. 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
@@ -473,6 +491,7 @@ combine any sections Entitled "Acknowledgements", and any sections Entitled
 "Dedications". You must delete all sections Entitled "Endorsements".
 
 === 6. 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,
@@ -485,6 +504,7 @@ into the extracted document, and follow this License in all other respects
 regarding verbatim copying of that document.
 
 === 7. 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, is called an "aggregate" if the copyright resulting from the
@@ -501,6 +521,7 @@ in electronic form. Otherwise they must appear on printed covers that bracket
 the whole aggregate.
 
 === 8. 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
@@ -518,6 +539,7 @@ If a section in the Document is Entitled "Acknowledgements", "Dedications", or
 typically require changing the actual title.
 
 === 9. TERMINATION
+
 You may not copy, modify, sublicense, or distribute the Document except as
 expressly provided under this License. Any attempt otherwise to copy, modify,
 sublicense, or distribute it is void, and will automatically terminate your
@@ -541,6 +563,7 @@ your rights have been terminated and not permanently reinstated, receipt of a
 copy of some or all of the same material does not give you any rights to use it.
 
 === 10. 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
@@ -558,6 +581,7 @@ License can be used, that proxy's public statement of acceptance of a version
 permanently authorizes you to choose that version for the Document.
 
 === 11. RELICENSING
+
 "Massive Multiauthor Collaboration Site" (or "MMC Site") means any World Wide
 Web server that publishes copyrightable works and also provides prominent
 facilities for anybody to edit those works. A public wiki that anybody can edit