€•	{      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ%/translations/zh_CN/filesystems/romfs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/zh_TW/filesystems/romfs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/it_IT/filesystems/romfs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/ja_JP/filesystems/romfs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/ko_KR/filesystems/romfs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ%/translations/sp_SP/filesystems/romfs”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒ?/var/lib/git/docbuild/linux/Documentation/filesystems/romfs.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒROMFS - ROM File System”h]”hŒROMFS - ROM File System”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ	paragraph”“”)”}”(hXx  This is a quite dumb, read only filesystem, mainly for initial RAM
disks of installation disks.  It has grown up by the need of having
modules linked at boot time.  Using this filesystem, you get a very
similar feature, and even the possibility of a small kernel, with a
file system which doesn't take up useful memory from the router
functions in the basement of your office.”h]”hXz  This is a quite dumb, read only filesystem, mainly for initial RAM
disks of installation disks.  It has grown up by the need of having
modules linked at boot time.  Using this filesystem, you get a very
similar feature, and even the possibility of a small kernel, with a
file system which doesnâ€™t take up useful memory from the router
functions in the basement of your office.”…””}”(hhËhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hXý  For comparison, both the older minix and xiafs (the latter is now
defunct) filesystems, compiled as module need more than 20000 bytes,
while romfs is less than a page, about 4000 bytes (assuming i586
code).  Under the same conditions, the msdos filesystem would need
about 30K (and does not support device nodes or symlinks), while the
nfs module with nfsroot is about 57K.  Furthermore, as a bit unfair
comparison, an actual rescue disk used up 3202 blocks with ext2, while
with romfs, it needed 3079 blocks.”h]”hXý  For comparison, both the older minix and xiafs (the latter is now
defunct) filesystems, compiled as module need more than 20000 bytes,
while romfs is less than a page, about 4000 bytes (assuming i586
code).  Under the same conditions, the msdos filesystem would need
about 30K (and does not support device nodes or symlinks), while the
nfs module with nfsroot is about 57K.  Furthermore, as a bit unfair
comparison, an actual rescue disk used up 3202 blocks with ext2, while
with romfs, it needed 3079 blocks.”…””}”(hhÙhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒyTo create such a file system, you'll need a user program named
genromfs. It is available on http://romfs.sourceforge.net/”h]”(hŒ^To create such a file system, youâ€™ll need a user program named
genromfs. It is available on ”…””}”(hhçhžhhŸNh NubhŒ	reference”“”)”}”(hŒhttp://romfs.sourceforge.net/”h]”hŒhttp://romfs.sourceforge.net/”…””}”(hhñhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”hóuh1hïhhçubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hŒ›As the name suggests, romfs could be also used (space-efficiently) on
various read-only media, like (E)EPROM disks if someone will have the
motivation.. :)”h]”hŒ›As the name suggests, romfs could be also used (space-efficiently) on
various read-only media, like (E)EPROM disks if someone will have the
motivation.. :)”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hX  However, the main purpose of romfs is to have a very small kernel,
which has only this filesystem linked in, and then can load any module
later, with the current module utilities.  It can also be used to run
some program to decide if you need SCSI devices, and even IDE or
floppy drives can be loaded later if you use the "initrd"--initial
RAM disk--feature of the kernel.  This would not be really news
flash, but with romfs, you can even spare off your ext2 or minix or
maybe even affs filesystem until you really know that you need it.”h]”hX  However, the main purpose of romfs is to have a very small kernel,
which has only this filesystem linked in, and then can load any module
later, with the current module utilities.  It can also be used to run
some program to decide if you need SCSI devices, and even IDE or
floppy drives can be loaded later if you use the â€œinitrdâ€--initial
RAM disk--feature of the kernel.  This would not be really news
flash, but with romfs, you can even spare off your ext2 or minix or
maybe even affs filesystem until you really know that you need it.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhÊ)”}”(hXP  For example, a distribution boot disk can contain only the cd disk
drivers (and possibly the SCSI drivers), and the ISO 9660 filesystem
module.  The kernel can be small enough, since it doesn't have other
filesystems, like the quite large ext2fs module, which can then be
loaded off the CD at a later stage of the installation.  Another use
would be for a recovery disk, when you are reinstalling a workstation
from the network, and you will have all the tools/modules available
from a nearby server, so you don't want to carry two disks for this
purpose, just because it won't fit into ext2.”h]”hXV  For example, a distribution boot disk can contain only the cd disk
drivers (and possibly the SCSI drivers), and the ISO 9660 filesystem
module.  The kernel can be small enough, since it doesnâ€™t have other
filesystems, like the quite large ext2fs module, which can then be
loaded off the CD at a later stage of the installation.  Another use
would be for a recovery disk, when you are reinstalling a workstation
from the network, and you will have all the tools/modules available
from a nearby server, so you donâ€™t want to carry two disks for this
purpose, just because it wonâ€™t fit into ext2.”…””}”(hj"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K'hh¶hžhubhÊ)”}”(hX
  romfs operates on block devices as you can expect, and the underlying
structure is very simple.  Every accessible structure begins on 16
byte boundaries for fast access.  The minimum space a file will take
is 32 bytes (this is an empty file, with a less than 16 character
name).  The maximum overhead for any non-empty file is the header, and
the 16 byte padding for the name and the contents, also 16+14+15 = 45
bytes.  This is quite rare however, since most file names are longer
than 3 bytes, and shorter than 15 bytes.”h]”hX
  romfs operates on block devices as you can expect, and the underlying
structure is very simple.  Every accessible structure begins on 16
byte boundaries for fast access.  The minimum space a file will take
is 32 bytes (this is an empty file, with a less than 16 character
name).  The maximum overhead for any non-empty file is the header, and
the 16 byte padding for the name and the contents, also 16+14+15 = 45
bytes.  This is quite rare however, since most file names are longer
than 3 bytes, and shorter than 15 bytes.”…””}”(hj0  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K1hh¶hžhubhÊ)”}”(hŒ/The layout of the filesystem is the following::”h]”hŒ.The layout of the filesystem is the following:”…””}”(hj>  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K:hh¶hžhubhŒliteral_block”“”)”}”(hXf  offset     content

       +---+---+---+---+
 0     | - | r | o | m |  \
       +---+---+---+---+       The ASCII representation of those bytes
 4     | 1 | f | s | - |  /    (i.e. "-rom1fs-")
       +---+---+---+---+
 8     |   full size   |       The number of accessible bytes in this fs.
       +---+---+---+---+
12     |    checksum   |       The checksum of the FIRST 512 BYTES.
       +---+---+---+---+
16     | volume name   |       The zero terminated name of the volume,
       :               :       padded to 16 byte boundary.
       +---+---+---+---+
xx     |     file      |
       :    headers    :”h]”hXf  offset     content

       +---+---+---+---+
 0     | - | r | o | m |  \
       +---+---+---+---+       The ASCII representation of those bytes
 4     | 1 | f | s | - |  /    (i.e. "-rom1fs-")
       +---+---+---+---+
 8     |   full size   |       The number of accessible bytes in this fs.
       +---+---+---+---+
12     |    checksum   |       The checksum of the FIRST 512 BYTES.
       +---+---+---+---+
16     | volume name   |       The zero terminated name of the volume,
       :               :       padded to 16 byte boundary.
       +---+---+---+---+
xx     |     file      |
       :    headers    :”…””}”hjN  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jL  hŸh³h K<hh¶hžhubhÊ)”}”(hŒkEvery multi byte value (32 bit words, I'll use the longwords term from
now on) must be in big endian order.”h]”hŒmEvery multi byte value (32 bit words, Iâ€™ll use the longwords term from
now on) must be in big endian order.”…””}”(hj\  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KMhh¶hžhubhÊ)”}”(hX`  The first eight bytes identify the filesystem, even for the casual
inspector.  After that, in the 3rd longword, it contains the number of
bytes accessible from the start of this filesystem.  The 4th longword
is the checksum of the first 512 bytes (or the number of bytes
accessible, whichever is smaller).  The applied algorithm is the same
as in the AFFS filesystem, namely a simple sum of the longwords
(assuming bigendian quantities again).  For details, please consult
the source.  This algorithm was chosen because although it's not quite
reliable, it does not require any tables, and it is very simple.”h]”hXb  The first eight bytes identify the filesystem, even for the casual
inspector.  After that, in the 3rd longword, it contains the number of
bytes accessible from the start of this filesystem.  The 4th longword
is the checksum of the first 512 bytes (or the number of bytes
accessible, whichever is smaller).  The applied algorithm is the same
as in the AFFS filesystem, namely a simple sum of the longwords
(assuming bigendian quantities again).  For details, please consult
the source.  This algorithm was chosen because although itâ€™s not quite
reliable, it does not require any tables, and it is very simple.”…””}”(hjj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KPhh¶hžhubhÊ)”}”(hŒhThe following bytes are now part of the file system; each file header
must begin on a 16 byte boundary::”h]”hŒgThe following bytes are now part of the file system; each file header
must begin on a 16 byte boundary:”…””}”(hjx  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KZhh¶hžhubjM  )”}”(hX¥  offset     content

       +---+---+---+---+
 0     | next filehdr|X|       The offset of the next file header
       +---+---+---+---+         (zero if no more files)
 4     |   spec.info   |       Info for directories/hard links/devices
       +---+---+---+---+
 8     |     size      |       The size of this file in bytes
       +---+---+---+---+
12     |   checksum    |       Covering the meta data, including the file
       +---+---+---+---+         name, and padding
16     | file name     |       The zero terminated name of the file,
       :               :       padded to 16 byte boundary
       +---+---+---+---+
xx     | file data     |
       :               :”h]”hX¥  offset     content

       +---+---+---+---+
 0     | next filehdr|X|       The offset of the next file header
       +---+---+---+---+         (zero if no more files)
 4     |   spec.info   |       Info for directories/hard links/devices
       +---+---+---+---+
 8     |     size      |       The size of this file in bytes
       +---+---+---+---+
12     |   checksum    |       Covering the meta data, including the file
       +---+---+---+---+         name, and padding
16     | file name     |       The zero terminated name of the file,
       :               :       padded to 16 byte boundary
       +---+---+---+---+
xx     | file data     |
       :               :”…””}”hj†  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jL  hŸh³h K]hh¶hžhubhÊ)”}”(hXz  Since the file headers begin always at a 16 byte boundary, the lowest
4 bits would be always zero in the next filehdr pointer.  These four
bits are used for the mode information.  Bits 0..2 specify the type of
the file; while bit 4 shows if the file is executable or not.  The
permissions are assumed to be world readable, if this bit is not set,
and world executable if it is; except the character and block devices,
they are never accessible for other than owner.  The owner of every
file is user and group 0, this should never be a problem for the
intended use.  The mapping of the 8 possible values to file types is
the following:”h]”hXz  Since the file headers begin always at a 16 byte boundary, the lowest
4 bits would be always zero in the next filehdr pointer.  These four
bits are used for the mode information.  Bits 0..2 specify the type of
the file; while bit 4 shows if the file is executable or not.  The
permissions are assumed to be world readable, if this bit is not set,
and world executable if it is; except the character and block devices,
they are never accessible for other than owner.  The owner of every
file is user and group 0, this should never be a problem for the
intended use.  The mapping of the 8 possible values to file types is
the following:”…””}”(hj”  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Knhh¶hžhubhŒtable”“”)”}”(hhh]”hŒtgroup”“”)”}”(hhh]”(hŒcolspec”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”Kuh1j¬  hj©  ubj­  )”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”Kuh1j¬  hj©  ubj­  )”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”Œcolwidth”K,uh1j¬  hj©  ubhŒthead”“”)”}”(hhh]”hŒrow”“”)”}”(hhh]”(hŒentry”“”)”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjÓ  ubj×  )”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjÓ  ubj×  )”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjÓ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑ  hjÎ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÌ  hj©  ubhŒtbody”“”)”}”(hhh]”(jÒ  )”}”(hhh]”(j×  )”}”(hhh]”hÊ)”}”(hŒ0”h]”hŒ0”…””}”(hj
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K|hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj  ubj×  )”}”(hhh]”hÊ)”}”(hŒ	hard link”h]”hŒ	hard link”…””}”(hj!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K|hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj  ubj×  )”}”(hhh]”hÊ)”}”(hŒlink destination [file header]”h]”hŒlink destination [file header]”…””}”(hj8  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K|hj5  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑ  hj  ubjÒ  )”}”(hhh]”(j×  )”}”(hhh]”hÊ)”}”(hŒ1”h]”hŒ1”…””}”(hjX  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K}hjU  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjR  ubj×  )”}”(hhh]”hÊ)”}”(hŒ	directory”h]”hŒ	directory”…””}”(hjo  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K}hjl  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjR  ubj×  )”}”(hhh]”hÊ)”}”(hŒfirst file's header”h]”hŒfirst fileâ€™s header”…””}”(hj†  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K}hjƒ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjR  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑ  hj  ubjÒ  )”}”(hhh]”(j×  )”}”(hhh]”hÊ)”}”(hŒ2”h]”hŒ2”…””}”(hj¦  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K~hj£  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj   ubj×  )”}”(hhh]”hÊ)”}”(hŒregular file”h]”hŒregular file”…””}”(hj½  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K~hjº  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj   ubj×  )”}”(hhh]”hÊ)”}”(hŒunused, must be zero [MBZ]”h]”hŒunused, must be zero [MBZ]”…””}”(hjÔ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K~hjÑ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj   ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑ  hj  ubjÒ  )”}”(hhh]”(j×  )”}”(hhh]”hÊ)”}”(hŒ3”h]”hŒ3”…””}”(hjô  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khjñ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjî  ubj×  )”}”(hhh]”hÊ)”}”(hŒsymbolic link”h]”hŒsymbolic link”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjî  ubj×  )”}”(hhh]”hÊ)”}”(hŒ+unused, MBZ (file data is the link content)”h]”hŒ+unused, MBZ (file data is the link content)”…””}”(hj"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjî  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑ  hj  ubjÒ  )”}”(hhh]”(j×  )”}”(hhh]”hÊ)”}”(hŒ4”h]”hŒ4”…””}”(hjB  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K€hj?  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj<  ubj×  )”}”(hhh]”hÊ)”}”(hŒblock device”h]”hŒblock device”…””}”(hjY  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K€hjV  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj<  ubj×  )”}”(hhh]”hÊ)”}”(hŒ16/16 bits major/minor number”h]”hŒ16/16 bits major/minor number”…””}”(hjp  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K€hjm  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj<  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑ  hj  ubjÒ  )”}”(hhh]”(j×  )”}”(hhh]”hÊ)”}”(hŒ5”h]”hŒ5”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjŠ  ubj×  )”}”(hhh]”hÊ)”}”(hŒchar device”h]”hŒchar device”…””}”(hj§  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj¤  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjŠ  ubj×  )”}”(hhh]”hŒbullet_list”“”)”}”(hhh]”hŒ	list_item”“”)”}”(hŒ" -”h]”hÊ)”}”(hjÇ  h]”hŒâ€œ -”…””}”(hjÉ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhjÅ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÃ  hjÀ  ubah}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j¾  hŸh³h Khj»  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjŠ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑ  hj  ubjÒ  )”}”(hhh]”(j×  )”}”(hhh]”hÊ)”}”(hŒ6”h]”hŒ6”…””}”(hjö  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K‚hjó  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjð  ubj×  )”}”(hhh]”hÊ)”}”(hŒsocket”h]”hŒsocket”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K‚hj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjð  ubj×  )”}”(hhh]”hÊ)”}”(hŒunused, MBZ”h]”hŒunused, MBZ”…””}”(hj$  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K‚hj!  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hjð  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑ  hj  ubjÒ  )”}”(hhh]”(j×  )”}”(hhh]”hÊ)”}”(hŒ7”h]”hŒ7”…””}”(hjD  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KƒhjA  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj>  ubj×  )”}”(hhh]”hÊ)”}”(hŒfifo”h]”hŒfifo”…””}”(hj[  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KƒhjX  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj>  ubj×  )”}”(hhh]”hÊ)”}”(hŒunused, MBZ”h]”hŒunused, MBZ”…””}”(hjr  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kƒhjo  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÖ  hj>  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÑ  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÿ  hj©  ubeh}”(h]”h ]”h"]”h$]”h&]”Œcols”Kuh1j§  hj¤  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¢  hh¶hžhhŸh³h NubhÊ)”}”(hX‘  Note that hard links are specifically marked in this filesystem, but
they will behave as you can expect (i.e. share the inode number).
Note also that it is your responsibility to not create hard link
loops, and creating all the . and .. links for directories.  This is
normally done correctly by the genromfs program.  Please refrain from
using the executable bits for special purposes on the socket and fifo
special files, they may have other uses in the future.  Additionally,
please remember that only regular files, and symlinks are supposed to
have a nonzero size field; they contain the number of bytes available
directly after the (padded) file name.”h]”hX‘  Note that hard links are specifically marked in this filesystem, but
they will behave as you can expect (i.e. share the inode number).
Note also that it is your responsibility to not create hard link
loops, and creating all the . and .. links for directories.  This is
normally done correctly by the genromfs program.  Please refrain from
using the executable bits for special purposes on the socket and fifo
special files, they may have other uses in the future.  Additionally,
please remember that only regular files, and symlinks are supposed to
have a nonzero size field; they contain the number of bytes available
directly after the (padded) file name.”…””}”(hjŸ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K†hh¶hžhubhÊ)”}”(hX7  Another thing to note is that romfs works on file headers and data
aligned to 16 byte boundaries, but most hardware devices and the block
device drivers are unable to cope with smaller than block-sized data.
To overcome this limitation, the whole size of the file system must be
padded to an 1024 byte boundary.”h]”hX7  Another thing to note is that romfs works on file headers and data
aligned to 16 byte boundaries, but most hardware devices and the block
device drivers are unable to cope with smaller than block-sized data.
To overcome this limitation, the whole size of the file system must be
padded to an 1024 byte boundary.”…””}”(hj­  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K‘hh¶hžhubhÊ)”}”(hX¢  If you have any problems or suggestions concerning this file system,
please contact me.  However, think twice before wanting me to add
features and code, because the primary and most important advantage of
this file system is the small code.  On the other hand, don't be
alarmed, I'm not getting that much romfs related mail.  Now I can
understand why Avery wrote poems in the ARCnet docs to get some more
feedback. :)”h]”hX¦  If you have any problems or suggestions concerning this file system,
please contact me.  However, think twice before wanting me to add
features and code, because the primary and most important advantage of
this file system is the small code.  On the other hand, donâ€™t be
alarmed, Iâ€™m not getting that much romfs related mail.  Now I can
understand why Avery wrote poems in the ARCnet docs to get some more
feedback. :)”…””}”(hj»  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K—hh¶hžhubhÊ)”}”(hŒƒromfs has also a mailing list, and to date, it hasn't received any
traffic, so you are welcome to join it to discuss your ideas. :)”h]”hŒ…romfs has also a mailing list, and to date, it hasnâ€™t received any
traffic, so you are welcome to join it to discuss your ideas. :)”…””}”(hjÉ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KŸhh¶hžhubhÊ)”}”(hŒIt's run by ezmlm, so you can subscribe to it by sending a message
to romfs-subscribe@shadow.banki.hu, the content is irrelevant.”h]”(hŒHItâ€™s run by ezmlm, so you can subscribe to it by sending a message
to ”…””}”(hj×  hžhhŸNh Nubhð)”}”(hŒromfs-subscribe@shadow.banki.hu”h]”hŒromfs-subscribe@shadow.banki.hu”…””}”(hjß  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ&mailto:romfs-subscribe@shadow.banki.hu”uh1hïhj×  ubhŒ, the content is irrelevant.”…””}”(hj×  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K¢hh¶hžhubhÊ)”}”(hŒPending issues:”h]”hŒPending issues:”…””}”(hjù  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K¥hh¶hžhubj¿  )”}”(hhh]”(jÄ  )”}”(hŒ¾Permissions and owner information are pretty essential features of a
Un*x like system, but romfs does not provide the full possibilities.
I have never found this limiting, but others might.
”h]”hÊ)”}”(hŒ½Permissions and owner information are pretty essential features of a
Un*x like system, but romfs does not provide the full possibilities.
I have never found this limiting, but others might.”h]”hŒ½Permissions and owner information are pretty essential features of a
Un*x like system, but romfs does not provide the full possibilities.
I have never found this limiting, but others might.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K§hj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÃ  hj  hžhhŸh³h NubjÄ  )”}”(hXE  The file system is read only, so it can be very small, but in case
one would want to write _anything_ to a file system, he still needs
a writable file system, thus negating the size advantages.  Possible
solutions: implement write access as a compile-time option, or a new,
similarly small writable filesystem for RAM disks.
”h]”hÊ)”}”(hXD  The file system is read only, so it can be very small, but in case
one would want to write _anything_ to a file system, he still needs
a writable file system, thus negating the size advantages.  Possible
solutions: implement write access as a compile-time option, or a new,
similarly small writable filesystem for RAM disks.”h]”hXD  The file system is read only, so it can be very small, but in case
one would want to write _anything_ to a file system, he still needs
a writable file system, thus negating the size advantages.  Possible
solutions: implement write access as a compile-time option, or a new,
similarly small writable filesystem for RAM disks.”…””}”(hj&  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K«hj"  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÃ  hj  hžhhŸh³h NubjÄ  )”}”(hX„  Since the files are only required to have alignment on a 16 byte
boundary, it is currently possibly suboptimal to read or execute files
from the filesystem.  It might be resolved by reordering file data to
have most of it (i.e. except the start and the end) laying at "natural"
boundaries, thus it would be possible to directly map a big portion of
the file contents to the mm subsystem.
”h]”hÊ)”}”(hXƒ  Since the files are only required to have alignment on a 16 byte
boundary, it is currently possibly suboptimal to read or execute files
from the filesystem.  It might be resolved by reordering file data to
have most of it (i.e. except the start and the end) laying at "natural"
boundaries, thus it would be possible to directly map a big portion of
the file contents to the mm subsystem.”h]”hX‡  Since the files are only required to have alignment on a 16 byte
boundary, it is currently possibly suboptimal to read or execute files
from the filesystem.  It might be resolved by reordering file data to
have most of it (i.e. except the start and the end) laying at â€œnaturalâ€
boundaries, thus it would be possible to directly map a big portion of
the file contents to the mm subsystem.”…””}”(hj>  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K±hj:  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÃ  hj  hžhhŸh³h NubjÄ  )”}”(hŒZCompression might be an useful feature, but memory is quite a
limiting factor in my eyes.
”h]”hÊ)”}”(hŒYCompression might be an useful feature, but memory is quite a
limiting factor in my eyes.”h]”hŒYCompression might be an useful feature, but memory is quite a
limiting factor in my eyes.”…””}”(hjV  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K¸hjR  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÃ  hj  hžhhŸh³h NubjÄ  )”}”(hŒWhere it is used?
”h]”hÊ)”}”(hŒWhere it is used?”h]”hŒWhere it is used?”…””}”(hjn  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K»hjj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÃ  hj  hžhhŸh³h NubjÄ  )”}”(hŒ>Does it work on other architectures than intel and motorola?

”h]”hÊ)”}”(hŒ<Does it work on other architectures than intel and motorola?”h]”hŒ<Does it work on other architectures than intel and motorola?”…””}”(hj†  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K½hj‚  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÃ  hj  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”jâ  jã  uh1j¾  hŸh³h K§hh¶hžhubhÊ)”}”(hŒ	Have fun,”h]”hŒ	Have fun,”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KÀhh¶hžhubhÊ)”}”(hŒ%Janos Farkas <chexum@shadow.banki.hu>”h]”(hŒJanos Farkas <”…””}”(hj®  hžhhŸNh Nubhð)”}”(hŒchexum@shadow.banki.hu”h]”hŒchexum@shadow.banki.hu”…””}”(hj¶  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:chexum@shadow.banki.hu”uh1hïhj®  ubhŒ>”…””}”(hj®  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KÂhh¶hžhubeh}”(h]”Œromfs-rom-file-system”ah ]”h"]”Œromfs - rom file system”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”jÖ  Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jú  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”jÕ  jÒ  sŒ	nametypes”}”jÕ  ‰sh}”jÒ  h¶sŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.