https://github.com/kusumi/makefs
FreeBSD makefs(8) + HAMMER2 support + exFAT support for Linux / *BSD
https://github.com/kusumi/makefs
bsd exfat fat filesystem hammer2 iso9660 linux ufs
Last synced: 10 days ago
JSON representation
FreeBSD makefs(8) + HAMMER2 support + exFAT support for Linux / *BSD
- Host: GitHub
- URL: https://github.com/kusumi/makefs
- Owner: kusumi
- License: bsd-2-clause
- Created: 2022-05-01T13:28:08.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-12-02T08:17:50.000Z (over 1 year ago)
- Last Synced: 2025-04-17T09:00:20.378Z (15 days ago)
- Topics: bsd, exfat, fat, filesystem, hammer2, iso9660, linux, ufs
- Language: C
- Homepage:
- Size: 1.29 MB
- Stars: 10
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES
Awesome Lists containing this project
README
[FreeBSD makefs(8)](https://www.freebsd.org/cgi/man.cgi?query=makefs&sektion=8) for Linux / *BSD
========
## About
+ FreeBSD makefs(8) + HAMMER2 support + exFAT support
## Supported platforms
+ Linux, Cygwin, FreeBSD, NetBSD, OpenBSD, DragonFly BSD
## Requirements
+ C compiler
+ libuuid.so and ** on Linux (unless HAMMER2 support is disabled on build)
## Supported file systems
|file system |*-t* option name |original implementation |
|:--------------------------|:----------------|:------------------------------|
|UFS |ffs (default) |FreeBSD makefs(8) |
|FAT |msdos |FreeBSD makefs(8) |
|ISO9660 |cd9660 |FreeBSD makefs(8) |
|Version 7 Unix file system |v7fs |NetBSD makefs(8) |
|HAMMER2 |hammer2 |DragonFly BSD makefs(8) |
|exFAT |exfat |[https://github.com/relan/exfat](https://github.com/relan/exfat)|
## Build
+ By default all supported file systems above are enabled. Use [gmake(1)](https://www.freebsd.org/cgi/man.cgi?query=gmake&sektion=1) on *BSD.
$ cd makefs
$ make
+ Specify *USE_HAMMER2=0* to disable HAMMER2 support.
$ cd makefs
$ make USE_HAMMER2=0
+ Specify *USE_EXFAT=0* to disable exFAT support.
$ cd makefs
$ make USE_EXFAT=0
## Install (optional)
$ cd makefs
$ make && make install
## Uninstall (optional)
$ cd makefs
$ make uninstall
## [Usage](src/usr.sbin/makefs/makefs.8.txt) examples
+ 4.4BSD FFS
$ ./src/makefs -t ffs /path/to/img /path/to/directory
+ FreeBSD UFS2
$ ./src/makefs -t ffs -o version=2 /path/to/img /path/to/directory
+ ISO9660
$ ./src/makefs -t cd9660 /path/to/img /path/to/directory
+ HAMMER2
$ ./src/makefs -t hammer2 /path/to/img /path/to/directory
+ FAT12/16/32 (file size required)
$ ./src/makefs -t msdos -s 1g /path/to/img /path/to/directory
+ exFAT (file size required)
$ ./src/makefs -t exfat -s 1g /path/to/img /path/to/directory
## Notes
+ Build confirmed on Fedora, Ubuntu, Cygwin, FreeBSD, NetBSD, OpenBSD, DragonFly BSD on x86_64.
+ Due to lack of UFS standard among vendors, use an appropriate *"-o ufstype=..."* mount option to mount UFS on Linux.
+ Use *"-o ufstype=44bsd"* (4.4BSD) for an image created with *"-o version=1"* or the default.
+ Use *"-o ufstype=ufs2"* (FreeBSD UFS2) for an image created with *"-o version=2"*.
+ ZFS support which exists in recent FreeBSD makefs(8) is unsupported.
## Bugs
+ mtree(5) related options are currently unsupported.
+ *-F* option, *-N* option, and mtree file input will fail with an error message.
+ v7fs support compiles, but *"-t v7fs"* option is broken.
+ *"-t v7fs"* option is broken on NetBSD makefs(8) as well.
## License
+ Files under [src/gpl](src/gpl) and [src/usr.sbin/makefs/exfat_gpl.c](src/usr.sbin/makefs/exfat_gpl.c) are under [GPL v2](src/gpl/github.com/relan/exfat/COPYING).
+ [HAMMER2](src/usr.sbin/makefs/hammer2) and other files derived from DragonFly BSD are under [BSDL](src/usr.sbin/makefs/hammer2/COPYRIGHT).
+ All other files are under [BSDL](COPYRIGHT).
## Resource
+ FreeBSD makefs(8) [https://www.freebsd.org/cgi/man.cgi?query=makefs&sektion=8](https://www.freebsd.org/cgi/man.cgi?query=makefs&sektion=8)
+ FreeBSD mtree(5) [https://www.freebsd.org/cgi/man.cgi?query=mtree&sektion=5](https://www.freebsd.org/cgi/man.cgi?query=mtree&sektion=5)
+ NetBSD makefs(8) [https://man.netbsd.org/makefs.8](https://man.netbsd.org/makefs.8)
+ DragonFly BSD makefs(8) [https://man.dragonflybsd.org/?command=makefs](https://man.dragonflybsd.org/?command=makefs)
+ "Free exFAT file system implementation" [https://github.com/relan/exfat](https://github.com/relan/exfat)