| makefs.8 (ec3c01ae7233088057395aa50be2439d1abde828) | makefs.8 (240afd8c1fcc8c5f29dbd4ff0c915795d414405d) |
|---|---|
| 1.\" $NetBSD: makefs.8,v 1.33 2011/05/22 21:51:39 christos Exp $ 2.\" 3.\" Copyright (c) 2001-2003 Wasabi Systems, Inc. 4.\" All rights reserved. 5.\" 6.\" Written by Luke Mewburn for Wasabi Systems, Inc. 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 21 unchanged lines hidden (view full) --- 30.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 31.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 32.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 33.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 34.\" POSSIBILITY OF SUCH DAMAGE. 35.\" 36.\" $FreeBSD$ 37.\" | 1.\" $NetBSD: makefs.8,v 1.33 2011/05/22 21:51:39 christos Exp $ 2.\" 3.\" Copyright (c) 2001-2003 Wasabi Systems, Inc. 4.\" All rights reserved. 5.\" 6.\" Written by Luke Mewburn for Wasabi Systems, Inc. 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 21 unchanged lines hidden (view full) --- 30.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 31.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 32.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 33.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 34.\" POSSIBILITY OF SUCH DAMAGE. 35.\" 36.\" $FreeBSD$ 37.\" |
| 38.Dd September 17, 2020 | 38.Dd August 5, 2022 |
| 39.Dt MAKEFS 8 40.Os 41.Sh NAME 42.Nm makefs 43.Nd create a file system image from a directory tree or a mtree manifest 44.Sh SYNOPSIS 45.Nm 46.Op Fl DxZ --- 214 unchanged lines hidden (view full) --- 261The following file system types are supported: 262.Bl -tag -width cd9660 -offset indent 263.It Sy ffs 264BSD fast file system (default). 265.It Sy cd9660 266ISO 9660 file system. 267.It Sy msdos 268FAT12, FAT16, or FAT32 file system. | 39.Dt MAKEFS 8 40.Os 41.Sh NAME 42.Nm makefs 43.Nd create a file system image from a directory tree or a mtree manifest 44.Sh SYNOPSIS 45.Nm 46.Op Fl DxZ --- 214 unchanged lines hidden (view full) --- 261The following file system types are supported: 262.Bl -tag -width cd9660 -offset indent 263.It Sy ffs 264BSD fast file system (default). 265.It Sy cd9660 266ISO 9660 file system. 267.It Sy msdos 268FAT12, FAT16, or FAT32 file system. |
| 269.It Sy zfs 270ZFS pool containing one or more file systems. |
|
| 269.El 270.It Fl x 271Exclude file system nodes not explicitly listed in the specfile. 272.It Fl Z 273Create a sparse file for 274.Sy ffs . 275This is useful for virtual machine images. 276.El --- 212 unchanged lines hidden (view full) --- 489Sectors per track. 490.It Cm size 491File System size. 492.It Cm volume_id 493Volume ID. 494.It Cm volume_label 495Volume Label. 496.El | 271.El 272.It Fl x 273Exclude file system nodes not explicitly listed in the specfile. 274.It Fl Z 275Create a sparse file for 276.Sy ffs . 277This is useful for virtual machine images. 278.El --- 212 unchanged lines hidden (view full) --- 491Sectors per track. 492.It Cm size 493File System size. 494.It Cm volume_id 495Volume ID. 496.It Cm volume_label 497Volume Label. 498.El |
| 499.Ss zfs-specific options 500Note: ZFS support is currently considered experimental. 501Do not use it for anything critical. 502.Pp 503The image created by 504.Nm 505contains a ZFS pool with a single vdev of type 506.Ql disk . 507The root dataset is always created implicitly and contains the entire input 508directory tree unless additional datasets are specified using the options 509described below. 510.Pp 511The arguments consist of a keyword, an equal sign 512.Pq Ql = , 513and a value. 514The following keywords are supported: 515.Pp 516.Bl -tag -width omit-trailing-period -offset indent -compact 517.It ashift 518The base-2 logarithm of the minimum block size. 519Typical values are 9 (512B blocks) and 12 (4KB blocks). 520The default value is 12. 521.It bootfs 522The name of the bootable dataset for the pool. 523Specifying this option causes the 524.Ql bootfs 525property to be set in the created pool. 526.It mssize 527The size of metaslabs in the created pool. 528By default, 529.Nm 530allocates large (up to 512MB) metaslabs with the expectation that 531the image will be auto-expanded upon first use. 532This option allows the default heuristic to be overridden. 533.It poolname 534The name of the ZFS pool. 535This option must be specified. 536.It rootpath 537An implicit path prefix added to dataset mountpoints. 538By default it is 539.Pa /<poolname> . 540For creating bootable pools, the 541.Va rootpath 542should be set to 543.Pa / . 544At least one dataset must have a mountpoint equal to 545.Va rootpath . 546.It fs 547Create an additional dataset. 548This option may be specified multiple times. 549The argument value must be of the form 550.Ar <dataset>[;<prop1=v1>[;<prop2=v2>[;...]]] , 551where 552.Ar dataset 553is the name of the dataset and must belong to the pool's namespace. 554For example, with a pool name of 555.Ql test 556all dataset names must be prefixed by 557.Ql test/ . 558A dataset must exist at each level of the pool's namespace. 559For example, to create 560.Ql test/foo/bar , 561.Ql test/foo 562must be created as well. 563.Pp 564The dataset mountpoints determine how the datasets are populated with 565files from the staged directory tree. 566Conceptually, all datasets are mounted before any are populated with files. 567The root of the staged directory tree is mapped to 568.Va rootpath . 569.Pp 570Dataset properties, as described in 571.Xr zfsprops 8 , 572may be specified following the dataset name. 573The following properties may be set for a dataset: 574.Pp 575.Bl -tag -compact -offset indent 576.It atime 577.It canmount 578.It exec 579.It mountpoint 580.It setuid 581.El 582.El |
|
| 497.Sh SEE ALSO 498.Xr mtree 5 , 499.Xr mtree 8 , | 583.Sh SEE ALSO 584.Xr mtree 5 , 585.Xr mtree 8 , |
| 500.Xr newfs 8 | 586.Xr newfs 8 , 587.Xr zfsconcepts 8 , 588.Xr zfsprops 8 , 589.Xr zpoolprops 8 |
| 501.Sh HISTORY 502The 503.Nm 504utility appeared in 505.Nx 1.6 . 506It was ported to 507.Fx 508and first appeared in --- 4 unchanged lines hidden (view full) --- 513(original program), 514.An Daniel Watt , 515.An Walter Deignan , 516.An Ryan Gabrys , 517.An Alan Perez-Rathke , 518.An Ram Vedam 519(cd9660 support), 520.An Christos Zoulas | 590.Sh HISTORY 591The 592.Nm 593utility appeared in 594.Nx 1.6 . 595It was ported to 596.Fx 597and first appeared in --- 4 unchanged lines hidden (view full) --- 602(original program), 603.An Daniel Watt , 604.An Walter Deignan , 605.An Ryan Gabrys , 606.An Alan Perez-Rathke , 607.An Ram Vedam 608(cd9660 support), 609.An Christos Zoulas |
| 521(msdos support). | 610(msdos support), 611.An Mark Johnston 612(zfs support). |