Adding upstream version 2.38.1.upstream/2.38.1upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

2 files changed, 217 insertions, 0 deletions

diff --git a/disk-utils/mkfs.cramfs.8 b/disk-utils/mkfs.cramfs.8
new file mode 100644
index 0000000..560619b
--- /dev/null
+++ b/disk-utils/mkfs.cramfs.8
@@ -0,0 +1,132 @@
+'\" t
+.\"     Title: mkfs.cramfs
+.\"    Author: [see the "AUTHOR(S)" section]
+.\" Generator: Asciidoctor 2.0.15
+.\"      Date: 2022-05-11
+.\"    Manual: System Administration
+.\"    Source: util-linux 2.38.1
+.\"  Language: English
+.\"
+.TH "MKFS.CRAMFS" "8" "2022-05-11" "util\-linux 2.38.1" "System Administration"
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.ss \n[.ss] 0
+.nh
+.ad l
+.de URL
+\fI\\$2\fP <\\$1>\\$3
+..
+.als MTO URL
+.if \n[.g] \{\
+.  mso www.tmac
+.  am URL
+.    ad l
+.  .
+.  am MTO
+.    ad l
+.  .
+.  LINKSTYLE blue R < >
+.\}
+.SH "NAME"
+mkfs.cramfs \- make compressed ROM file system
+.SH "SYNOPSIS"
+.sp
+\fBmkfs.cramfs\fP [options] \fIdirectory file\fP
+.SH "DESCRIPTION"
+.sp
+Files on cramfs file systems are zlib\-compressed one page at a time to allow random read access. The metadata is not compressed, but is expressed in a terse representation that is more space\-efficient than conventional file systems.
+.sp
+The file system is intentionally read\-only to simplify its design; random write access for compressed files is difficult to implement. cramfs ships with a utility (\fBmkcramfs\fP(8)) to pack files into new cramfs images.
+.sp
+File sizes are limited to less than 16 MB.
+.sp
+Maximum file system size is a little under 272 MB. (The last file on the file system must begin before the 256 MB block, but can extend past it.)
+.SH "ARGUMENTS"
+.sp
+The \fIdirectory\fP is simply the root of the directory tree that we want to generate a compressed filesystem out of.
+.sp
+The \fIfile\fP will contain the cram file system, which later can be mounted.
+.SH "OPTIONS"
+.sp
+\fB\-v\fP
+.RS 4
+Enable verbose messaging.
+.RE
+.sp
+\fB\-E\fP
+.RS 4
+Treat all warnings as errors, which are reflected as command exit status.
+.RE
+.sp
+\fB\-b\fP \fIblocksize\fP
+.RS 4
+Use defined block size, which has to be divisible by page size.
+.RE
+.sp
+\fB\-e\fP \fIedition\fP
+.RS 4
+Use defined file system edition number in superblock.
+.RE
+.sp
+\fB\-N\fP \fIbig, little, host\fP
+.RS 4
+Use defined endianness. Value defaults to \fIhost\fP.
+.RE
+.sp
+\fB\-i\fP \fIfile\fP
+.RS 4
+Insert a \fIfile\fP to cramfs file system.
+.RE
+.sp
+\fB\-n\fP \fIname\fP
+.RS 4
+Set name of the cramfs file system.
+.RE
+.sp
+\fB\-p\fP
+.RS 4
+Pad by 512 bytes for boot code.
+.RE
+.sp
+\fB\-s\fP
+.RS 4
+This option is ignored. Originally the \fB\-s\fP turned on directory entry sorting.
+.RE
+.sp
+\fB\-z\fP
+.RS 4
+Make explicit holes.
+.RE
+.sp
+\fB\-h\fP, \fB\-\-help\fP
+.RS 4
+Display help text and exit.
+.RE
+.sp
+\fB\-V\fP, \fB\-\-version\fP
+.RS 4
+Print version and exit.
+.RE
+.SH "EXIT STATUS"
+.sp
+\fB0\fP
+.RS 4
+success
+.RE
+.sp
+\fB8\fP
+.RS 4
+operation error, such as unable to allocate memory
+.RE
+.SH "SEE ALSO"
+.sp
+\fBfsck.cramfs\fP(8),
+\fBmount\fP(8)
+.SH "REPORTING BUGS"
+.sp
+For bug reports, use the issue tracker at \c
+.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
+.SH "AVAILABILITY"
+.sp
+The \fBmkfs.cramfs\fP command is part of the util\-linux package which can be downloaded from \c
+.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."
\ No newline at end of file
diff --git a/disk-utils/mkfs.cramfs.8.adoc b/disk-utils/mkfs.cramfs.8.adoc
new file mode 100644
index 0000000..67f0e62
--- /dev/null
+++ b/disk-utils/mkfs.cramfs.8.adoc
@@ -0,0 +1,85 @@
+//po4a: entry man manual
+= mkfs.cramfs(8)
+:doctype: manpage
+:man manual: System Administration
+:man source: util-linux {release-version}
+:page-layout: base
+:command: mkfs.cramfs
+
+== NAME
+
+mkfs.cramfs - make compressed ROM file system
+
+== SYNOPSIS
+
+*mkfs.cramfs* [options] _directory file_
+
+== DESCRIPTION
+
+Files on cramfs file systems are zlib-compressed one page at a time to allow random read access. The metadata is not compressed, but is expressed in a terse representation that is more space-efficient than conventional file systems.
+
+The file system is intentionally read-only to simplify its design; random write access for compressed files is difficult to implement. cramfs ships with a utility (*mkcramfs*(8)) to pack files into new cramfs images.
+
+File sizes are limited to less than 16 MB.
+
+Maximum file system size is a little under 272 MB. (The last file on the file system must begin before the 256 MB block, but can extend past it.)
+
+== ARGUMENTS
+
+The _directory_ is simply the root of the directory tree that we want to generate a compressed filesystem out of.
+
+The _file_ will contain the cram file system, which later can be mounted.
+
+== OPTIONS
+
+*-v*::
+Enable verbose messaging.
+
+*-E*::
+Treat all warnings as errors, which are reflected as command exit status.
+
+*-b* _blocksize_::
+Use defined block size, which has to be divisible by page size.
+
+*-e* _edition_::
+Use defined file system edition number in superblock.
+
+*-N* _big, little, host_::
+Use defined endianness. Value defaults to _host_.
+
+*-i* _file_::
+Insert a _file_ to cramfs file system.
+
+*-n* _name_::
+Set name of the cramfs file system.
+
+*-p*::
+Pad by 512 bytes for boot code.
+
+*-s*::
+This option is ignored. Originally the *-s* turned on directory entry sorting.
+
+*-z*::
+Make explicit holes.
+
+include::man-common/help-version.adoc[]
+
+== EXIT STATUS
+
+*0*::
+success
+*8*::
+operation error, such as unable to allocate memory
+
+== SEE ALSO
+
+*fsck.cramfs*(8),
+*mount*(8)
+
+include::man-common/bugreports.adoc[]
+
+include::man-common/footer.adoc[]
+
+ifdef::translation[]
+include::man-common/translation.adoc[]
+endif::[]