genromfs - create a romfs image


SYNOPSIS

       genromfs  -f  device  [ -d source ] [ -V volumename ] [ -a
       alignment ] [ -A alignment,pattern ] [ -v ]


DESCRIPTION

       genromfs is used to create a romfs file system image, usu­
       ally  directly on a block device, or for test purposes, in
       a plain file.  It is the mkfs equivalent of other filesys­
       tems.

       genromfs will scan the current directory and its subdirec­
       tories, build a romfs image from the files found, and out­
       put it to the file or device you specified.


OPTIONS

       -f output
              Specifies the file to output the image to.  It must
              be specified.

       -d source
              Use the specified directory as the source, not  the
              current directory.

       -V volumename
              Build  the  image  with  the specified volume name.
              Currently it is not used by the kernel, but it will
              be recorded in the image.

       -a alignment
              Align  regular  files to alignment bytes.  genromfs
              will align data of each regular file in the result­
              ing image to the specified alignment, while keeping
              the image compatible with the original romfs  defi­
              nition  (by  adding  pad  bytes  between  last node
              before the file and file's  header).   By  default,
              genromfs  will  guarantee  only  an alignment of 16
              bytes.

       -A alignment,pattern
              Align objects matching shell  wildcard  pattern  to
              alignment  bytes.   If one object matches more pat­
              terns,  then  the  highest  alignment  is   chosen.
              Alignment has to be a power of two. Patterns either
              don't contain any  slashes,  in  which  case  files
              matching those patterns are matched in all directo­
              ries, or start with a leading slash, in which  case
              they  are  matched against absolute paths inside of
              the romfs filesystem (that is, as if  you  chrooted
              into the rom filesystem).

       -v     Verbose  operation,  genromfs will print every file

              offset.


EXAMPLES

          genromfs  -d  root  -f /dev/fd0 -V 'Secret labs install
       disk'

       All files  in  the  root  directory  will  be  written  to
       /dev/fd0 as a new romfs filesystem image.

          genromfs   -d   root   -f   /dev/fd0   -A  2048,/..  -A
       '4096,*.boot' -a 512 -V 'Bootable floppy'

       Generate the image and place  file  data  of  all  regular
       files on 512 bytes boundaries or on 4K boundaries, if they
       have the .boot extension. Also, align the root directories
       '..' romfs header on 2K boundary.

       You  can  use  the  generated image (if you have the romfs
       module loaded, or compiled into the kernel) via:

          mount -t romfs /dev/fd0 /mnt


AUTHOR

       This manual page was initially written by Christoph  Lame­
       ter  <clameter@debian.org>,  for the Debian GNU/Linux sys­
       tem.


SEE ALSO

       mkfs(8), mount(8), mkisofs(8)


Man(1) output converted with man2html