[thirdparty/util-linux.git] / disk-utils / mkfs.cramfs.8

.TH MKFS.CRAMFS 8 "April 2013" "util-linux" "System Administration"
.SH NAME
mkfs.cramfs \- make compressed ROM file system
.SH SYNOPSIS
.B mkfs.cramfs
[options]
.I directory file
.SH 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.
.PP
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) to pack files into new cramfs images.
.PP
File sizes are limited to less than 16\ MB.
.PP
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
The
.I directory
is simply the root of the directory tree that we want to generate a
compressed filesystem out of.
.PP
The
.I file
will contain the cram file system, which later can be mounted.
.SH OPTIONS
.TP
\fB\-v\fR
Enable verbose messaging.
.TP
\fB\-E\fR
Treat all warnings as errors, which are reflected as command return value.
.TP
\fB\-b\fR \fIblocksize\fR
Use defined block size, which has to be divisible by page size.
.TP
\fB\-e\fR \fIedition\fR
Use defined file system edition number in superblock.
.TP
\fB\-N\fR \fIbig, little, host\fR
Use defined endianness.  Value defaults to
.IR host .
.TP
\fB\-i\fR \fIfile\fR
Insert a
.I file
to cramfs file system.
.TP
\fB\-n\fR \fIname\fR
Set name of the cramfs file system.
.TP
\fB\-p\fR
Pad by 512 bytes for boot code.
.TP
\fB\-s\fR
This option is ignored.  Originally the \-s turned on directory entry
sorting.
.TP
\fB\-z\fR
Make explicit holes.
.TP
\fB\-h\fR, \fB\-\-help\fR
Display help text and exit.
.TP
\fB\-V\fR, \fB\-\-version\fR
Display version information and exit.
.SH "EXIT STATUS"
.RS
.PD 0
.TP
.B 0
success
.TP
.B 8
operation error, such as unable to allocate memory
.PD
.RE
.SH "SEE ALSO"
.BR fsck.cramfs (8),
.BR mount (8)
.SH AVAILABILITY
The example command is part of the util-linux package and is available from
.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
Linux Kernel Archive
.UE .
Commit	Line	Data
	1	.TH MKFS.CRAMFS 8 "April 2013" "util-linux" "System Administration"
	2	.SH NAME
	3	mkfs.cramfs \- make compressed ROM file system
	4	.SH SYNOPSIS
	5	.B mkfs.cramfs
	6	[options]
	7	.I directory file
	8	.SH DESCRIPTION
	9	Files on cramfs file systems are zlib-compressed one page at a time to
	10	allow random read access. The metadata is not compressed, but is
	11	expressed in a terse representation that is more space-efficient than
	12	conventional file systems.
	13	.PP
	14	The file system is intentionally read-only to simplify its design; random
	15	write access for compressed files is difficult to implement. cramfs
	16	ships with a utility (mkcramfs) to pack files into new cramfs images.
	17	.PP
	18	File sizes are limited to less than 16\ MB.
	19	.PP
	20	Maximum file system size is a little under 272\ MB. (The last file on the
	21	file system must begin before the 256\ MB block, but can extend past it.)
	22	.SH ARGUMENTS
	23	The
	24	.I directory
	25	is simply the root of the directory tree that we want to generate a
	26	compressed filesystem out of.
	27	.PP
	28	The
	29	.I file
	30	will contain the cram file system, which later can be mounted.
	31	.SH OPTIONS
	32	.TP
	33	\fB\-v\fR
	34	Enable verbose messaging.
	35	.TP
	36	\fB\-E\fR
	37	Treat all warnings as errors, which are reflected as command return value.
	38	.TP
	39	\fB\-b\fR \fIblocksize\fR
	40	Use defined block size, which has to be divisible by page size.
	41	.TP
	42	\fB\-e\fR \fIedition\fR
	43	Use defined file system edition number in superblock.
	44	.TP
	45	\fB\-N\fR \fIbig, little, host\fR
	46	Use defined endianness. Value defaults to
	47	.IR host .
	48	.TP
	49	\fB\-i\fR \fIfile\fR
	50	Insert a
	51	.I file
	52	to cramfs file system.
	53	.TP
	54	\fB\-n\fR \fIname\fR
	55	Set name of the cramfs file system.
	56	.TP
	57	\fB\-p\fR
	58	Pad by 512 bytes for boot code.
	59	.TP
	60	\fB\-s\fR
	61	This option is ignored. Originally the \-s turned on directory entry
	62	sorting.
	63	.TP
	64	\fB\-z\fR
	65	Make explicit holes.
	66	.TP
	67	\fB\-h\fR, \fB\-\-help\fR
	68	Display help text and exit.
	69	.TP
	70	\fB\-V\fR, \fB\-\-version\fR
	71	Display version information and exit.
	72	.SH "EXIT STATUS"
	73	.RS
	74	.PD 0
	75	.TP
	76	.B 0
	77	success
	78	.TP
	79	.B 8
	80	operation error, such as unable to allocate memory
	81	.PD
	82	.RE
	83	.SH "SEE ALSO"
	84	.BR fsck.cramfs (8),
	85	.BR mount (8)
	86	.SH AVAILABILITY
	87	The example command is part of the util-linux package and is available from
	88	.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
	89	Linux Kernel Archive
	90	.UE .