15978408cSSascha Wildner.\" $NetBSD: makefs.8,v 1.33 2011/05/22 21:51:39 christos Exp $ 25978408cSSascha Wildner.\" 35978408cSSascha Wildner.\" Copyright (c) 2001-2003 Wasabi Systems, Inc. 45978408cSSascha Wildner.\" All rights reserved. 55978408cSSascha Wildner.\" 65978408cSSascha Wildner.\" Written by Luke Mewburn for Wasabi Systems, Inc. 75978408cSSascha Wildner.\" 85978408cSSascha Wildner.\" Redistribution and use in source and binary forms, with or without 95978408cSSascha Wildner.\" modification, are permitted provided that the following conditions 105978408cSSascha Wildner.\" are met: 115978408cSSascha Wildner.\" 1. Redistributions of source code must retain the above copyright 125978408cSSascha Wildner.\" notice, this list of conditions and the following disclaimer. 135978408cSSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright 145978408cSSascha Wildner.\" notice, this list of conditions and the following disclaimer in the 155978408cSSascha Wildner.\" documentation and/or other materials provided with the distribution. 165978408cSSascha Wildner.\" 3. All advertising materials mentioning features or use of this software 175978408cSSascha Wildner.\" must display the following acknowledgement: 185978408cSSascha Wildner.\" This product includes software developed for the NetBSD Project by 195978408cSSascha Wildner.\" Wasabi Systems, Inc. 205978408cSSascha Wildner.\" 4. The name of Wasabi Systems, Inc. may not be used to endorse 215978408cSSascha Wildner.\" or promote products derived from this software without specific prior 225978408cSSascha Wildner.\" written permission. 235978408cSSascha Wildner.\" 245978408cSSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND 255978408cSSascha Wildner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 265978408cSSascha Wildner.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 275978408cSSascha Wildner.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL WASABI SYSTEMS, INC 285978408cSSascha Wildner.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 295978408cSSascha Wildner.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 305978408cSSascha Wildner.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 315978408cSSascha Wildner.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 325978408cSSascha Wildner.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 335978408cSSascha Wildner.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 345978408cSSascha Wildner.\" POSSIBILITY OF SUCH DAMAGE. 355978408cSSascha Wildner.\" 365978408cSSascha Wildner.\" $FreeBSD: head/usr.sbin/makefs/makefs.8 331843 2018-03-31 15:04:41Z benno $ 375978408cSSascha Wildner.\" 38*917508cdSTomohiro Kusumi.Dd June 8, 2023 395978408cSSascha Wildner.Dt MAKEFS 8 405978408cSSascha Wildner.Os 415978408cSSascha Wildner.Sh NAME 425978408cSSascha Wildner.Nm makefs 435978408cSSascha Wildner.Nd create a file system image from a directory tree or a mtree manifest 445978408cSSascha Wildner.Sh SYNOPSIS 455978408cSSascha Wildner.Nm 465978408cSSascha Wildner.Op Fl DxZ 475978408cSSascha Wildner.Op Fl B Ar endian 485978408cSSascha Wildner.Op Fl b Ar free-blocks 495978408cSSascha Wildner.Op Fl d Ar debug-mask 505978408cSSascha Wildner.Op Fl F Ar mtree-specfile 515978408cSSascha Wildner.Op Fl f Ar free-files 525978408cSSascha Wildner.Op Fl M Ar minimum-size 535978408cSSascha Wildner.Op Fl m Ar maximum-size 545978408cSSascha Wildner.Op Fl N Ar userdb-dir 555978408cSSascha Wildner.Op Fl O Ar offset 565978408cSSascha Wildner.Op Fl o Ar fs-options 575978408cSSascha Wildner.Op Fl R Ar roundup-size 585978408cSSascha Wildner.Op Fl S Ar sector-size 595978408cSSascha Wildner.Op Fl s Ar image-size 605978408cSSascha Wildner.Op Fl T Ar timestamp 615978408cSSascha Wildner.Op Fl t Ar fs-type 625978408cSSascha Wildner.Ar image-file 635978408cSSascha Wildner.Ar directory | manifest 645978408cSSascha Wildner.Op Ar extra-directory ... 655978408cSSascha Wildner.Sh DESCRIPTION 665978408cSSascha WildnerThe utility 675978408cSSascha Wildner.Nm 685978408cSSascha Wildnercreates a file system image into 695978408cSSascha Wildner.Ar image-file 705978408cSSascha Wildnerfrom the directory tree 715978408cSSascha Wildner.Ar directory 725978408cSSascha Wildneror from the mtree manifest 735978408cSSascha Wildner.Ar manifest . 745978408cSSascha WildnerIf any optional directory trees are passed in the 755978408cSSascha Wildner.Ar extra-directory 765978408cSSascha Wildnerarguments, then the directory tree of each argument will be merged 775978408cSSascha Wildnerinto the 785978408cSSascha Wildner.Ar directory 795978408cSSascha Wildneror 805978408cSSascha Wildner.Ar manifest 815978408cSSascha Wildnerfirst before creating 825978408cSSascha Wildner.Ar image-file . 835978408cSSascha WildnerNo special devices or privileges are required to perform this task. 845978408cSSascha Wildner.Pp 855978408cSSascha WildnerThe options are as follows: 865978408cSSascha Wildner.Bl -tag -width flag 875978408cSSascha Wildner.It Fl B Ar endian 885978408cSSascha WildnerSet the byte order of the image to 895978408cSSascha Wildner.Ar endian . 905978408cSSascha WildnerValid byte orders are 915978408cSSascha Wildner.Ql 4321 , 925978408cSSascha Wildner.Ql big , 935978408cSSascha Wildneror 945978408cSSascha Wildner.Ql be 955978408cSSascha Wildnerfor big endian, and 965978408cSSascha Wildner.Ql 1234 , 975978408cSSascha Wildner.Ql little , 985978408cSSascha Wildneror 995978408cSSascha Wildner.Ql le 1005978408cSSascha Wildnerfor little endian. 1015978408cSSascha WildnerSome file systems may have a fixed byte order; in those cases this 1025978408cSSascha Wildnerargument will be ignored. 1035978408cSSascha Wildner.It Fl b Ar free-blocks 1045978408cSSascha WildnerEnsure that a minimum of 1055978408cSSascha Wildner.Ar free-blocks 1065978408cSSascha Wildnerfree blocks exist in the image. 1075978408cSSascha WildnerAn optional 1085978408cSSascha Wildner.Ql % 1095978408cSSascha Wildnersuffix may be provided to indicate that 1105978408cSSascha Wildner.Ar free-blocks 1115978408cSSascha Wildnerindicates a percentage of the calculated image size. 1125978408cSSascha Wildner.It Fl D 1135978408cSSascha WildnerTreat duplicate paths in an mtree manifest as warnings not error. 1145978408cSSascha Wildner.It Fl d Ar debug-mask 1155978408cSSascha WildnerEnable various levels of debugging, depending upon which bits are 1165978408cSSascha Wildnerset in 1175978408cSSascha Wildner.Ar debug-mask . 1185978408cSSascha WildnerXXX: document these 1195978408cSSascha Wildner.It Fl F Ar mtree-specfile 1205978408cSSascha Wildner.Em This is almost certainly not the option you are looking for. 1215978408cSSascha WildnerTo create an image from a list of files in an mtree format manifest, 1225978408cSSascha Wildnerspecify it as the last argument on the commandline, not as a the 1235978408cSSascha Wildnerargument to 1245978408cSSascha Wildner.Fl F . 1255978408cSSascha Wildner.Pp 1265978408cSSascha WildnerUse 1275978408cSSascha Wildner.Ar mtree-specfile 1285978408cSSascha Wildneras an 1295978408cSSascha Wildner.Xr mtree 8 1305978408cSSascha Wildner.Sq specfile 1315978408cSSascha Wildnerspecification. 1325978408cSSascha WildnerThis option has no effect when the image is created from a mtree manifest 1335978408cSSascha Wildnerrather than a directory. 1345978408cSSascha Wildner.Pp 1355978408cSSascha WildnerIf a specfile entry exists in the underlying file system, its 1365978408cSSascha Wildnerpermissions and modification time will be used unless specifically 1375978408cSSascha Wildneroverridden by the specfile. 1385978408cSSascha WildnerAn error will be raised if the type of entry in the specfile 1395978408cSSascha Wildnerconflicts with that of an existing entry. 1405978408cSSascha Wildner.Pp 1415978408cSSascha WildnerIn the opposite case (where a specfile entry does not have an entry 1425978408cSSascha Wildnerin the underlying file system) the following occurs: 1435978408cSSascha WildnerIf the specfile entry is marked 1445978408cSSascha Wildner.Sy optional , 1455978408cSSascha Wildnerthe specfile entry is ignored. 1465978408cSSascha WildnerOtherwise, the entry will be created in the image, and it is 1475978408cSSascha Wildnernecessary to specify at least the following parameters in the 1485978408cSSascha Wildnerspecfile: 1495978408cSSascha Wildner.Sy type , 1505978408cSSascha Wildner.Sy mode , 1515978408cSSascha Wildner.Sy gname , 1525978408cSSascha Wildneror 1535978408cSSascha Wildner.Sy gid , 1545978408cSSascha Wildnerand 1555978408cSSascha Wildner.Sy uname 1565978408cSSascha Wildneror 1575978408cSSascha Wildner.Sy uid , 1585978408cSSascha Wildnerand 1595978408cSSascha Wildner.Sy link 1605978408cSSascha Wildner(in the case of symbolic links). 1615978408cSSascha WildnerIf 1625978408cSSascha Wildner.Sy time 1635978408cSSascha Wildnerisn't provided, the current time will be used. 1645978408cSSascha WildnerIf 1655978408cSSascha Wildner.Sy flags 1665978408cSSascha Wildnerisn't provided, the current file flags will be used. 1675978408cSSascha WildnerMissing regular file entries will be created as zero-length files. 1685978408cSSascha Wildner.It Fl f Ar free-files 1695978408cSSascha WildnerEnsure that a minimum of 1705978408cSSascha Wildner.Ar free-files 1715978408cSSascha Wildnerfree files (inodes) exist in the image. 1725978408cSSascha WildnerAn optional 1735978408cSSascha Wildner.Ql % 1745978408cSSascha Wildnersuffix may be provided to indicate that 1755978408cSSascha Wildner.Ar free-files 1765978408cSSascha Wildnerindicates a percentage of the calculated image size. 1775978408cSSascha Wildner.It Fl M Ar minimum-size 1785978408cSSascha WildnerSet the minimum size of the file system image to 1795978408cSSascha Wildner.Ar minimum-size . 1805978408cSSascha Wildner.It Fl m Ar maximum-size 1815978408cSSascha WildnerSet the maximum size of the file system image to 1825978408cSSascha Wildner.Ar maximum-size . 1835978408cSSascha WildnerAn error will be raised if the target file system needs to be larger 1845978408cSSascha Wildnerthan this to accommodate the provided directory tree. 1855978408cSSascha Wildner.It Fl N Ar userdb-dir 1865978408cSSascha WildnerUse the user database text file 1875978408cSSascha Wildner.Pa master.passwd 1885978408cSSascha Wildnerand group database text file 1895978408cSSascha Wildner.Pa group 1905978408cSSascha Wildnerfrom 1915978408cSSascha Wildner.Ar userdb-dir , 1925978408cSSascha Wildnerrather than using the results from the system's 1935978408cSSascha Wildner.Xr getpwnam 3 1945978408cSSascha Wildnerand 1955978408cSSascha Wildner.Xr getgrnam 3 1965978408cSSascha Wildner(and related) library calls. 1975978408cSSascha Wildner.It Fl O Ar offset 1985978408cSSascha WildnerInstead of creating the filesystem at the beginning of the file, start 1995978408cSSascha Wildnerat offset. 2005978408cSSascha WildnerValid only for 2012f999113SSascha Wildner.Sy ffs 2022f999113SSascha Wildnerand 2032f999113SSascha Wildner.Sy msdos . 2045978408cSSascha Wildner.It Fl o Ar fs-options 2055978408cSSascha WildnerSet file system specific options. 2065978408cSSascha Wildner.Ar fs-options 2075978408cSSascha Wildneris a comma separated list of options. 2085978408cSSascha WildnerValid file system specific options are detailed below. 2095978408cSSascha Wildner.It Fl p 2105978408cSSascha WildnerDeprecated. 2115978408cSSascha WildnerSee the 2125978408cSSascha Wildner.Fl Z 2135978408cSSascha Wildnerflag. 2145978408cSSascha Wildner.It Fl R Ar roundup-size 2155978408cSSascha WildnerRound the image up to 2165978408cSSascha Wildner.Ar roundup-size . 2175978408cSSascha Wildner.Ar roundup-size 2185978408cSSascha Wildnershould be a multiple of the file system block size. 2195978408cSSascha WildnerThis option only applies to the 2205978408cSSascha Wildner.Sy ffs 2215978408cSSascha Wildnerfile system type. 2225978408cSSascha Wildner.It Fl S Ar sector-size 2235978408cSSascha WildnerSet the file system sector size to 2245978408cSSascha Wildner.Ar sector-size . 2255978408cSSascha Wildner.\" XXX: next line also true for cd9660? 2265978408cSSascha WildnerDefaults to 512. 2275978408cSSascha Wildner.It Fl s Ar image-size 2285978408cSSascha WildnerSet the size of the file system image to 2295978408cSSascha Wildner.Ar image-size . 2305978408cSSascha Wildner.It Fl T Ar timestamp 2315978408cSSascha WildnerSpecify a timestamp to be set for all filesystem files and directories 2325978408cSSascha Wildnercreated so that repeatable builds are possible. 2335978408cSSascha WildnerThe 2345978408cSSascha Wildner.Ar timestamp 2355978408cSSascha Wildnercan be a 2365978408cSSascha Wildner.Pa pathname , 2375978408cSSascha Wildnerwhere the timestamps are derived from that file, or an integer 2385978408cSSascha Wildnervalue interpreted as the number of seconds from the Epoch. 2395978408cSSascha WildnerNote that timestamps specified in an 2405978408cSSascha Wildner.Xr mtree 5 2415978408cSSascha Wildnerspec file, override the default timestamp. 2425978408cSSascha Wildner.It Fl t Ar fs-type 2435978408cSSascha WildnerCreate an 2445978408cSSascha Wildner.Ar fs-type 2455978408cSSascha Wildnerfile system image. 2465978408cSSascha WildnerThe following file system types are supported: 2475978408cSSascha Wildner.Bl -tag -width cd9660 -offset indent 2485978408cSSascha Wildner.It Sy ffs 2495978408cSSascha WildnerBSD fast file system (default). 2505978408cSSascha Wildner.It Sy cd9660 2515978408cSSascha WildnerISO 9660 file system. 2522f999113SSascha Wildner.It Sy msdos 2532f999113SSascha WildnerFAT12, FAT16, or FAT32 file system. 2542d60b848STomohiro Kusumi.It Sy hammer2 2552d60b848STomohiro KusumiHAMMER2 file system. 2565978408cSSascha Wildner.El 2575978408cSSascha Wildner.It Fl x 2585978408cSSascha WildnerExclude file system nodes not explicitly listed in the specfile. 2595978408cSSascha Wildner.It Fl Z 2605978408cSSascha WildnerCreate a sparse file for 2612d60b848STomohiro Kusumi.Sy ffs 2622d60b848STomohiro Kusumiand 2632d60b848STomohiro Kusumi.Sy hammer2 . 2645978408cSSascha WildnerThis is useful for virtual machine images. 2655978408cSSascha Wildner.El 2665978408cSSascha Wildner.Pp 2675978408cSSascha WildnerWhere sizes are specified, a decimal number of bytes is expected. 2685978408cSSascha WildnerTwo or more numbers may be separated by an 2695978408cSSascha Wildner.Dq x 2705978408cSSascha Wildnerto indicate a product. 2715978408cSSascha WildnerEach number may have one of the following optional suffixes: 2725978408cSSascha Wildner.Bl -tag -width 3n -offset indent -compact 2735978408cSSascha Wildner.It b 2745978408cSSascha WildnerBlock; multiply by 512 2755978408cSSascha Wildner.It k 2765978408cSSascha WildnerKibi; multiply by 1024 (1 KiB) 2775978408cSSascha Wildner.It m 2785978408cSSascha WildnerMebi; multiply by 1048576 (1 MiB) 2795978408cSSascha Wildner.It g 2805978408cSSascha WildnerGibi; multiply by 1073741824 (1 GiB) 2815978408cSSascha Wildner.It t 2825978408cSSascha WildnerTebi; multiply by 1099511627776 (1 TiB) 2835978408cSSascha Wildner.It w 2845978408cSSascha WildnerWord; multiply by the number of bytes in an integer 2855978408cSSascha Wildner.El 2865978408cSSascha Wildner.\" 2875978408cSSascha Wildner.\" 2885978408cSSascha Wildner.Ss FFS-specific options 2895978408cSSascha Wildner.Sy ffs 2905978408cSSascha Wildnerimages have ffs-specific optional parameters that may be provided. 2915978408cSSascha WildnerEach of the options consists of a keyword, an equal sign 2925978408cSSascha Wildner.Pq Ql = , 2935978408cSSascha Wildnerand a value. 2945978408cSSascha WildnerThe following keywords are supported: 2955978408cSSascha Wildner.Pp 2965978408cSSascha Wildner.Bl -tag -width optimization -offset indent -compact 2975978408cSSascha Wildner.It Sy avgfilesize 2985978408cSSascha WildnerExpected average file size. 2995978408cSSascha Wildner.It Sy avgfpdir 3005978408cSSascha WildnerExpected number of files per directory. 3015978408cSSascha Wildner.It Sy bsize 3025978408cSSascha WildnerBlock size. 3035978408cSSascha Wildner.It Sy density 3047660903bSTomohiro KusumiBytes per inode. If unset, will allocate the minimum number of inodes to 3057660903bSTomohiro Kusumirepresent the filesystem if no free space has been requested (free blocks 3067660903bSTomohiro Kusumior minimum size set); otherwise the larger of the newfs defaults or what 3077660903bSTomohiro Kusumiis required by the free inode parameters if set. 3085978408cSSascha Wildner.It Sy fsize 3095978408cSSascha WildnerFragment size. 3105978408cSSascha Wildner.It Sy label 3115978408cSSascha WildnerLabel name of the image. 3125978408cSSascha Wildner.It Sy maxbpg 3135978408cSSascha WildnerMaximum blocks per file in a cylinder group. 3145978408cSSascha Wildner.It Sy minfree 3155978408cSSascha WildnerMinimum % free. 3165978408cSSascha Wildner.It Sy optimization 3175978408cSSascha WildnerOptimization preference; one of 3185978408cSSascha Wildner.Ql space 3195978408cSSascha Wildneror 3205978408cSSascha Wildner.Ql time . 321811c2036SSascha Wildner.\".It Sy extent 322811c2036SSascha Wildner.\"Maximum extent size. 3235978408cSSascha Wildner.It Sy maxbpcg 3245978408cSSascha WildnerMaximum total number of blocks in a cylinder group. 3255978408cSSascha Wildner.It Sy version 3265978408cSSascha WildnerUFS version. 327811c2036SSascha Wildner1 for FFS (default and the only supported value). 328811c2036SSascha Wildner.\", 2 for UFS2. 3295978408cSSascha Wildner.It Sy softupdates 3305978408cSSascha Wildner0 for disable (default), 1 for enable 3315978408cSSascha Wildner.El 3325978408cSSascha Wildner.Ss CD9660-specific options 3335978408cSSascha Wildner.Sy cd9660 3345978408cSSascha Wildnerimages have ISO9660-specific optional parameters that may be 3355978408cSSascha Wildnerprovided. 3365978408cSSascha WildnerThe arguments consist of a keyword and, optionally, an equal sign 3375978408cSSascha Wildner.Pq Ql = , 3385978408cSSascha Wildnerand a value. 3395978408cSSascha WildnerThe following keywords are supported: 3405978408cSSascha Wildner.Pp 3415978408cSSascha Wildner.Bl -tag -width omit-trailing-period -offset indent -compact 3425978408cSSascha Wildner.It Sy allow-deep-trees 3435978408cSSascha WildnerAllow the directory structure to exceed the maximum specified in 3445978408cSSascha Wildnerthe spec. 3455978408cSSascha Wildner.It Sy allow-illegal-chars 3465978408cSSascha WildnerAllow illegal characters in filenames. This option is not implemented. 3475978408cSSascha Wildner.It Sy allow-lowercase 3485978408cSSascha WildnerAllow lowercase characters in filenames. This option is not implemented. 3495978408cSSascha Wildner.It Sy allow-max-name 3505978408cSSascha WildnerAllow 37 instead of 33 characters for filenames by omitting the 3515978408cSSascha Wildnerversion id. 3525978408cSSascha Wildner.It Sy allow-multidot 3535978408cSSascha WildnerAllow multiple dots in a filename. 3545978408cSSascha Wildner.It Sy applicationid 3555978408cSSascha WildnerApplication ID of the image. 3565978408cSSascha Wildner.It Sy archimedes 3575978408cSSascha WildnerUse the 3585978408cSSascha Wildner.Ql ARCHIMEDES 3595978408cSSascha Wildnerextension to encode 3605978408cSSascha Wildner.Tn RISC OS 3615978408cSSascha Wildnermetadata. 3625978408cSSascha Wildner.It Sy bootimagedir 3635978408cSSascha WildnerBoot image directory. This option is not implemented. 3645978408cSSascha Wildner.It Sy chrp-boot 3655978408cSSascha WildnerWrite an MBR partition table to the image to allow older CHRP hardware to 3665978408cSSascha Wildnerboot. 3675978408cSSascha Wildner.It Sy boot-load-segment 3685978408cSSascha WildnerSet load segment for the boot image. 3695978408cSSascha Wildner.It Sy bootimage 3705978408cSSascha WildnerFilename of a boot image in the format 3715978408cSSascha Wildner.Dq sysid;filename , 3725978408cSSascha Wildnerwhere 3735978408cSSascha Wildner.Dq sysid 3745978408cSSascha Wildneris one of 3755978408cSSascha Wildner.Ql i386 , 3765978408cSSascha Wildner.Ql mac68k , 3775978408cSSascha Wildner.Ql macppc , 3785978408cSSascha Wildneror 3795978408cSSascha Wildner.Ql powerpc . 3805978408cSSascha Wildner.It Sy generic-bootimage 3815978408cSSascha WildnerLoad a generic boot image into the first 32K of the cd9660 image. 3825978408cSSascha Wildner.It Sy hard-disk-boot 3835978408cSSascha WildnerBoot image is a hard disk image. 3845978408cSSascha Wildner.It Sy isolevel 3855978408cSSascha WildnerAn integer representing the ISO 9660 interchange level where 3865978408cSSascha Wildner.Dq level 3875978408cSSascha Wildneris either 3885978408cSSascha Wildner.Ql 1 3895978408cSSascha Wildneror 3905978408cSSascha Wildner.Ql 2 . 3915978408cSSascha Wildner.Dq level 3925978408cSSascha Wildner.Ql 3 3935978408cSSascha Wildneris not implemented. 3945978408cSSascha Wildner.It Sy keep-bad-images 3955978408cSSascha WildnerDo not discard images whose write was aborted due to an error. 3965978408cSSascha WildnerFor debugging purposes. 3975978408cSSascha Wildner.It Sy label 3985978408cSSascha WildnerLabel name of the image. 3995978408cSSascha Wildner.It Sy no-boot 4005978408cSSascha WildnerBoot image is not bootable. 4015978408cSSascha Wildner.It Sy no-emul-boot 4025978408cSSascha WildnerBoot image is a 4035978408cSSascha Wildner.Dq no emulation 4045978408cSSascha WildnerElTorito image. 4055978408cSSascha Wildner.It Sy no-trailing-padding 4065978408cSSascha WildnerDo not pad the image (apparently Linux needs the padding). 4075978408cSSascha Wildner.It Sy omit-trailing-period 4085978408cSSascha WildnerOmit trailing periods in filenames. 4095978408cSSascha Wildner.It Sy platformid 4105978408cSSascha WildnerSet platform ID of section header entry of the boot image. 4115978408cSSascha Wildner.It Sy preparer 4125978408cSSascha WildnerPreparer ID of the image. 4135978408cSSascha Wildner.It Sy publisher 4145978408cSSascha WildnerPublisher ID of the image. 4155978408cSSascha Wildner.It Sy rockridge 4165978408cSSascha WildnerUse RockRidge extensions (for longer filenames, etc.). 4175978408cSSascha Wildner.It Sy verbose 4185978408cSSascha WildnerTurns on verbose output. 4195978408cSSascha Wildner.It Sy volumeid 4205978408cSSascha WildnerVolume set identifier of the image. 4215978408cSSascha Wildner.El 4222f999113SSascha Wildner.Ss msdos-specific options 4232f999113SSascha Wildner.Sy msdos 4242f999113SSascha Wildnerimages have MS-DOS-specific optional parameters that may be 4252f999113SSascha Wildnerprovided. 4262f999113SSascha WildnerThe arguments consist of a keyword, an equal sign 4272f999113SSascha Wildner.Pq Ql = , 4282f999113SSascha Wildnerand a value. 4292f999113SSascha WildnerThe following keywords are supported (see 4302f999113SSascha Wildner.Xr newfs_msdos 8 4312f999113SSascha Wildnerfor more details): 4322f999113SSascha Wildner.Pp 4332f999113SSascha Wildner.Bl -tag -width omit-trailing-period -offset indent -compact 4342f999113SSascha Wildner.It Cm backup_sector 4352f999113SSascha WildnerLocation of the backup boot sector. 4362f999113SSascha Wildner.It Cm block_size 4372f999113SSascha WildnerBlock size. 4382f999113SSascha Wildner.It Cm bootstrap 4392f999113SSascha WildnerBootstrap file. 4402f999113SSascha Wildner.It Cm bytes_per_sector 4412f999113SSascha WildnerBytes per sector. 4422f999113SSascha Wildner.It Cm create_size 4432f999113SSascha WildnerCreate file size. 4442f999113SSascha Wildner.It Cm directory_entries 4452f999113SSascha WildnerDirectory entries. 4462f999113SSascha Wildner.It Cm drive_heads 4472f999113SSascha WildnerDrive heads. 4482f999113SSascha Wildner.It Cm fat_type 4492f999113SSascha WildnerFAT type (12, 16, or 32). 4502f999113SSascha Wildner.It Cm floppy 4512f999113SSascha WildnerPreset drive parameters for standard format floppy disks 4522f999113SSascha Wildner(160, 180, 320, 360, 640, 720, 1200, 1232, 1440, or 2880). 4532f999113SSascha Wildner.It Cm hidden_sectors 4542f999113SSascha WildnerHidden sectors. 4552f999113SSascha Wildner.It Cm info_sector 4562f999113SSascha WildnerLocation of the info sector. 4572f999113SSascha Wildner.It Cm media_descriptor 4582f999113SSascha WildnerMedia descriptor. 4592f999113SSascha Wildner.It Cm num_FAT 4602f999113SSascha WildnerNumber of FATs. 4612f999113SSascha Wildner.It Cm OEM_string 4622f999113SSascha WildnerOEM string. 4632f999113SSascha Wildner.It Cm offset 4642f999113SSascha WildnerOffset in device. 4652f999113SSascha WildnerThis option will be ignored if 4662f999113SSascha Wildner.Fl O 4672f999113SSascha Wildneris set to a positive number. 4682f999113SSascha Wildner.It Cm reserved_sectors 4692f999113SSascha WildnerReserved sectors. 4702f999113SSascha Wildner.It Cm sectors_per_cluster 4712f999113SSascha WildnerSectors per cluster. 4722f999113SSascha Wildner.It Cm sectors_per_fat 4732f999113SSascha WildnerSectors per FAT. 4742f999113SSascha Wildner.It Cm sectors_per_track 4752f999113SSascha WildnerSectors per track. 4762f999113SSascha Wildner.It Cm size 4772f999113SSascha WildnerFile System size. 4782f999113SSascha Wildner.It Cm volume_id 4792f999113SSascha WildnerVolume ID. 4802f999113SSascha Wildner.It Cm volume_label 4812f999113SSascha WildnerVolume Label. 4822f999113SSascha Wildner.El 4832d60b848STomohiro Kusumi.Ss hammer2-specific options 4842d60b848STomohiro Kusumi.Sy hammer2 4852d60b848STomohiro Kusumiimages have HAMMER2-specific optional parameters that may be 4862d60b848STomohiro Kusumiprovided. 4879309ae04STomohiro KusumiThe arguments consist of a keyword, an equal sign 4882d60b848STomohiro Kusumi.Pq Ql = , 4892d60b848STomohiro Kusumiand a value. 4902d60b848STomohiro KusumiThe following keywords are supported: 4912d60b848STomohiro Kusumi.Pp 4922d60b848STomohiro Kusumi.Bl -tag -width omit-trailing-period -offset indent -compact 4932d60b848STomohiro Kusumi.It Cm b 4942d60b848STomohiro KusumiBoot area size. 4952d60b848STomohiro KusumiSee 4962d60b848STomohiro Kusumi.Xr newfs_hammer2 8 4972d60b848STomohiro Kusumifor details. 4982d60b848STomohiro Kusumi.It Cm r 4992d60b848STomohiro KusumiAux area size. 5002d60b848STomohiro KusumiSee 5012d60b848STomohiro Kusumi.Xr newfs_hammer2 8 5022d60b848STomohiro Kusumifor details. 5032d60b848STomohiro Kusumi.It Cm V 5042d60b848STomohiro KusumiFile system version. 5052d60b848STomohiro KusumiSee 5062d60b848STomohiro Kusumi.Xr newfs_hammer2 8 5072d60b848STomohiro Kusumifor details. 5082d60b848STomohiro Kusumi.It Cm L 5092d60b848STomohiro KusumiPFS Label. 5102d60b848STomohiro KusumiSee 5112d60b848STomohiro Kusumi.Xr newfs_hammer2 8 5122d60b848STomohiro Kusumifor details. 5132d60b848STomohiro KusumiUnlike 5142d60b848STomohiro Kusumi.Xr newfs_hammer2 8 , 5152d60b848STomohiro Kusumialways defaults to "DATA". 5162d60b848STomohiro Kusumi.It Cm v 5172d60b848STomohiro KusumiNumber of volume headers (1, 2, 3, or 4). 5182d60b848STomohiro KusumiDefaults to 4, and the image size will be at least 4 * 2 = 8 GiB. 5192d60b848STomohiro Kusumi.It Cm m 5202d60b848STomohiro KusumiThe PFS label to which to create file system contents. 5212d60b848STomohiro KusumiDefaults to "DATA". 5222d60b848STomohiro Kusumi.It Cm d 5232d60b848STomohiro Kusumisysctl vfs.hammer2.debug compatible tunable for debug prints. 5242d60b848STomohiro KusumiSpecify 0xffffffff to enable all debug prints. 5252d60b848STomohiro KusumiDefaults to 0. 526a63188c8STomohiro Kusumi.It Cm B 527a63188c8STomohiro KusumiRun offline bulkfree and exit. 528a63188c8STomohiro Kusumi.Ar image-file 529a63188c8STomohiro Kusumihas to be a valid HAMMER2 image file or block device. 530a63188c8STomohiro Kusumi.Ar directory 531a63188c8STomohiro Kusumiis unused, but it needs to be either a valid path or `--'. 532*917508cdSTomohiro Kusumi.It Cm D 533*917508cdSTomohiro KusumiRun offline destroy via file path or inode number. 534*917508cdSTomohiro Kusumi.Ar image-file 535*917508cdSTomohiro Kusumihas to be a valid HAMMER2 image file or block device. 536*917508cdSTomohiro Kusumi.Ar directory 537*917508cdSTomohiro Kusumiis unused, but it needs to be either a valid path or `--'. 538afa5234bSTomohiro Kusumi.It Cm G 539afa5234bSTomohiro KusumiRun offline growfs and exit. 540afa5234bSTomohiro Kusumi.Ar image-file 541afa5234bSTomohiro Kusumihas to be a valid HAMMER2 image file or block device. 542afa5234bSTomohiro Kusumi.Ar directory 543afa5234bSTomohiro Kusumiis unused, but it needs to be either a valid path or `--'. 544afa5234bSTomohiro KusumiBy default expands to 545afa5234bSTomohiro Kusumi.Ar image-file 546afa5234bSTomohiro Kusumifile or device size, unless size is specified by 547afa5234bSTomohiro Kusumi.Fl s 548afa5234bSTomohiro Kusumioption. 5492d60b848STomohiro Kusumi.El 5505978408cSSascha Wildner.Sh SEE ALSO 5515978408cSSascha Wildner.Xr mtree 5 , 5525978408cSSascha Wildner.Xr mtree 8 , 5535978408cSSascha Wildner.Xr newfs 8 5545978408cSSascha Wildner.Sh HISTORY 5555978408cSSascha WildnerThe 5565978408cSSascha Wildner.Nm 5575978408cSSascha Wildnerutility appeared in 5585978408cSSascha Wildner.Nx 1.6 . 5595978408cSSascha Wildner.Sh AUTHORS 5605978408cSSascha Wildner.An Luke Mewburn 5615978408cSSascha Wildner.Aq Mt lukem@NetBSD.org 5625978408cSSascha Wildner(original program), 5635978408cSSascha Wildner.An Daniel Watt , 5645978408cSSascha Wildner.An Walter Deignan , 5655978408cSSascha Wildner.An Ryan Gabrys , 5665978408cSSascha Wildner.An Alan Perez-Rathke , 5675978408cSSascha Wildner.An Ram Vedam 5682d60b848STomohiro Kusumi(cd9660 support), 5692f999113SSascha Wildner.An Christos Zoulas 5702d60b848STomohiro Kusumi(msdos support), 5712d60b848STomohiro Kusumi.An Tomohiro Kusumi 5722d60b848STomohiro Kusumi(hammer2 support). 573