freebsd-dev/include
Kirk McKusick c7996ddf80 Create a new GEOM utility, gunion(8).
The gunion(8) utility is used to track changes to a read-only disk on
a writable disk. Logically, a writable disk is placed over a read-only
disk. Write requests are intercepted and stored on the writable
disk. Read requests are first checked to see if they have been
written on the top (writable disk) and if found are returned. If
they have not been written on the top disk, then they are read from
the lower disk.

The gunion(8) utility can be especially useful if you have a large
disk with a corrupted filesystem that you are unsure of how to
repair. You can use gunion(8) to place another disk over the corrupted
disk and then attempt to repair the filesystem. If the repair fails,
you can revert all the changes in the upper disk and be back to the
unchanged state of the lower disk thus allowing you to try another
approach to repairing it. If the repair is successful you can commit
all the writes recorded on the top disk to the lower disk.

Another use of the gunion(8) utility is to try out upgrades to your
system. Place the upper disk over the disk holding your filesystem
that is to be upgraded and then run the upgrade on it. If it works,
commit it; if it fails, revert the upgrade.

Further details can be found in the gunion(8) manual page.

Reviewed by: Chuck Silvers, kib (earlier version)
tested by:   Peter Holm
Differential Revision: https://reviews.freebsd.org/D32697
2022-02-28 16:36:08 -08:00
..
arpa
gssapi
protocols
rpc
rpcsvc
xlocale Remove 'All Rights Reserved' from xlocale FreeBSD Foundation copyrights 2021-12-16 14:29:12 -05:00
_ctype.h
a.out.h
ar.h
assert.h
bitstring.h
complex.h Implementations of cexpl() 2021-11-05 13:51:42 +02:00
cpio.h
ctype.h
db.h
dirent.h
dlfcn.h
elf-hints.h
elf.h
err.h
fmtmsg.h
fnmatch.h
fstab.h
fts.h
ftw.h
getopt.h
glob.h
grp.h
gssapi.h
hesiod.h
iconv.h
ieeefp.h
ifaddrs.h
inttypes.h
iso646.h
kenv.h
langinfo.h
libgen.h
limits.h
link.h
locale.h
Makefile Create a new GEOM utility, gunion(8). 2022-02-28 16:36:08 -08:00
Makefile.depend
malloc_np.h
malloc.h
memory.h
mk-osreldate.sh
monetary.h
mpool.h
mqueue.h
ndbm.h
netconfig.h
netdb.h
nl_types.h
nlist.h
nss.h
nsswitch.h
paths.h Add search of LOCALBASE/share/calendar for calendars supplied by a port. 2020-10-23 09:22:23 +00:00
printf.h
proc_service.h
pthread_np.h
pthread.h Reduce code duplication in machine/_types.h 2021-06-14 16:30:16 +01:00
pwd.h
ranlib.h
readpassphrase.h
regex.h <regex.h>: reserve a regcomp field for REG_POSIX 2020-07-31 12:40:31 +00:00
res_update.h
resolv.h
runetype.h Remove __NO_TLS. 2021-02-23 20:08:10 +02:00
sched.h sched.h: Use pid_t type for pid argument 2021-12-17 08:22:21 +02:00
search.h
semaphore.h
setjmp.h
signal.h
spawn.h posix_spawn: add closefrom non-portable action 2021-11-30 03:43:54 +02:00
stab.h
stdalign.h
stdbool.h Remove obsolete check for GCC < 3 and support for Intel Compiler 2020-10-24 23:21:06 +00:00
stddef.h
stdio.h
stdlib.h libc: add clearenv function 2021-11-07 16:20:15 +01:00
stdnoreturn.h
string.h libc: add mempcpy(3) and wmempcpy(3) 2021-07-15 19:40:28 +03:00
stringlist.h
strings.h
sysexits.h
tar.h
termios.h Add tcgetwinsize(3) and tcsetwinsize(3) to termios 2020-12-25 20:43:09 +02:00
tgmath.h
time.h time.h: reduce CLOCK_ namespace pollution, move to _clock_id.h 2021-07-30 17:20:22 -06:00
timeconv.h
timers.h
ttyent.h
uchar.h
ulimit.h
unistd.h swapoff: add one more variant of the syscall 2021-12-09 02:48:46 +02:00
utime.h
utmpx.h
uuid.h
varargs.h
wchar.h libc: add mempcpy(3) and wmempcpy(3) 2021-07-15 19:40:28 +03:00
wctype.h
wordexp.h
xlocale.h