MKFS(8)                                                   MKFS(8)

     NAME
          mkfs, mkext - archive or update a file system

     SYNOPSIS
          disk/mkfs [-aprvoxU] [-d root] [-s source] [-z n] proto ...

          disk/mkext [-d name] [-u] [-h] [-v] [-x] [-T] file ...

     DESCRIPTION
          Mkfs copies files from the file tree source (default /) to a
          new file system root (default /n/newfs).  The proto files
          are read (see proto(2) for their format) and any files spec-
          ified in them that are out of date are copied.

          Mkfs copies only those files that are out of date.  Such a
          file is first copied into a temporary file in the appropri-
          ate destination directory and then moved to the destination
          file.  Files that are not specified in the proto file are
          not updated and not removed.

          The options to mkfs are:

          a         Instead of writing to new file system, write an
                    archive file to standard output, suitable for
                    mkext. All files in proto, not just those out of
                    date, are archived.
          x         For use with -a, this option writes a list of file
                    names, dates, and sizes to standard output rather
                    than producing an archive file.
          o         Similar to -x above, but produces a list of source
                    file names to standard output rather than produc-
                    ing an archive file.
          d root    Copy files into the tree rooted at root (default
                    /n/newfs).  This option suppresses setting the uid
                    and gid fields when copying files.  Use -U to
                    reenable it.
          p         Update the permissions of a file even if it is up
                    to date.
          U         Update of uid and gid of the target files.
          r         Copy all files.
          s source  Copy from files rooted at the tree source.
          v         Print the names of all of the files as they are
                    copied.
          z n       Copy files assuming block size n (default 1024)
                    bytes long.  If a block contains only 0-valued
                    bytes, it is not copied.

          Mkext unpacks archive files made by the -a option of mkfs.
          Each file on the command line is unpacked in one pass
          through the archive.  If the file is a directory, all files

     Page 1                       Plan 9             (printed 3/28/24)

     MKFS(8)                                                   MKFS(8)

          and subdirectories of that directory are also unpacked.
          When a file is unpacked, the entire path is created if it
          does not exist.  If no files are specified, the entire
          archive is unpacked; in this case, missing intermediate
          directories are not created.  The options are:

          d    specifies a directory (default /) to serve as the root
               of the unpacked file system.

          u    sets the owners of the files created to correspond to
               those in the archive and restores the modification
               times of the files.

          T    restores only the modification times of the files.

          v    prints the names and sizes of files as they are
               extracted.

          h    prints headers for the files on standard output instead
               of unpacking the files.

     EXAMPLES
          Make an archive to establish a new file system:

               disk/mkfs -a -s dist proto > arch

          Unpack that archive onto a new file system:

               srv newfs
               mount -c /srv/newfs /n/newfs
               disk/mkext -u -d /n/newfs < arch

     SOURCE
          /sys/src/cmd/disk/mkfs.c
          /sys/src/cmd/disk/mkext.c

     SEE ALSO
          prep(8), sd(3), tar(1)

     Page 2                       Plan 9             (printed 3/28/24)