nbdst(8) [osx man page]

NBDST(8)						    BSD System Manager's Manual 						  NBDST(8)

NAME

     nbdst -- NetBoot deferred shadow tool

SYNOPSIS

     nbdst [-recycle | -preallocate size] devnode shadowfile

DESCRIPTION

     nbdst is used during NetBoot to associate a shadow file with the disk image being used as the root device. After the shadow file is attached,
     subsequent writes to the root device will be redirected to the shadow file, which normally resides on local storage.  nbdst is invoked by
     /etc/rc.netboot

ARGUMENTS

     The following arguments must be specified:
     devnode	    The device node of the root device, in the form "disk0"
     shadowfile     Path to a shadow file which will be created and associated with the NetBoot root device

OPTIONS

     -recycle  If a shadow file already exists, reset it and use it again.  Otherwise, information written to an existing shadow file will reap-
	       pear.  Reusing a previous shadow file without resetting it requires that the shadow file be created with the same base image.

     -preallocate size
	       Set the shadow file to the given size up front.	This forces a reset of the shadow file (like -recycle).

NOTE

     nbdst can only be run as root.

SEE ALSO

     hdiutil(1), hdik(8)

Mac OS X							    29 Apr 2003 							  Mac OS X

hdik(8) 						    BSD System Manager's Manual 						   hdik(8)

NAME

     hdik -- lightweight tool to attach and mount disk images in-kernel

SYNOPSIS

     hdik imagefile [options]

DESCRIPTION

     hdik is a lightweight tool that can be used to attach disk images in-kernel (i.e. without a user-land process to provide the backing store).
     Only a subset of disk images can be mounted in this manner including read/write disk images, UDIF disk images that use zlib compression,
     shadowed disk images, and sparse disk images.

     hdik is intended for use in situations where linking against the DiskImages framework is problematic or an extremely lightweight mechanism
     for attaching a disk image is needed.

     You can specify that the image should not be processed by Disk Arbitration by specifying the -nomount option.  You can also specify that the
     image be mounted with a shadow file by using the -shadow option.

     The following argument must be specified:

     imagefile	 the disk image to be mounted.

OPTIONS

     -shadow [shadowfile]
		 Use a shadow file in conjunction with the data in the image.  This option prevents modification of the original image and allows
		 read-only images to be used as read/write images.  When blocks are being read from the image, blocks present in the shadow file
		 override blocks in the base image.  When blocks are being written, the writes will be redirected to the shadow file.  If not
		 specified, -shadow defaults to <imagename>.shadow.  If the shadow file does not exist, it is created.
     -nomount	 Suppress automatic mounting of the image or partitions on it.	This will result in /dev entries being created, but will not mount
		 any volumes.
     -drivekey keyname=value
		 Specify a key/value pair for the IOHDIXHDDrive object created (shows up in the IOKit registry of devices which is viewable with
		 ioreg(8)).

SEE ALSO

     hdiutil(1), diskarbitrationd(8), diskutil(8), ioreg(8)

Mac OS X							    29 Apr 2003 							  Mac OS X