DTREBUILD(1M)   K-AShare by Xinet (10/14/99 10.1)	 DTREBUILD(1M)



     NAME    [Toc]    [Back]
	  dtrebuild - ``desktop'' maintenance of AppleShare volumes

     SYNOPSIS    [Toc]    [Back]
	  /usr/etc/appletalk/dtrebuild [ -dlev|-D ] [ -ro ] [ -a ]
	       [ -u user ] [ -chroot rootdir ] [ -OP ... ]
	       [ file|dir|volume ... ]

     DESCRIPTION    [Toc]    [Back]
	  This program may be used to maintain some databases used by
	  the AppleShare server, a la ``Rebuild	Desktop'' on the Mac.
	  FullPress and	WebNative users	may also use it	to (re)create
	  FPO/WEB images.  It performs one or more operations on one
	  or more files, directories and/or AppleShare volumes.
	  Running dtrebuild with no arguments will produce an up-todate
 list of available OPerations.

	  In the absence of the	-a option, most	of the OPerations may
	  be run on a selected subset of AppleShare volumes or
	  directories (or sometimes files), by listing a series	of
	  file,	dir and/or volume arguments.  In the absence of	either
	  the -a option	or named volumes/files,	the operations will be
	  performed on all public volumes if run by root, else all of
	  the user's private volumes.  Dtrebuild will refuse to	work
	  on directories within	KFS volumes.

     OPTIONS    [Toc]    [Back]
	  The following	command-line options control the behaviour of
	  all OPerations done by dtrebuild:

	  -d lev
	       Turns on	debugging for a	subset of items.  lev is a hex
	       bitmask.	 See opidebug(5) for a listing of what bits
	       control what.

	  -D   Turns on	ALL debugging and sends	the messages to
	       standard	error.

	  -ro  Don't actually perform any of the selected OPerations,
	       but print, on standard output, what changes each
	       operation would make.

	  -a   (root only) do all the OPerations on every volume.
	       This means all public volumes as	well as	every user's
	       private volumes.	 If a user only	has a defaulted	home
	       directory volume, and has no desktop file in the	home
	       directory, that volume will be skipped.	WARNING:  on
	       servers using the automount(1m)er, this could cause a
	       number of NFS mounts, possibly waiting indefinitely for
	       some NFS	servers	to respond.  Also, some	OPerations
	       must be run on all available AppleShare volumes,	since
	       they clean out old, unused volume information.  When



     Page 1					     (printed 5/4/100)






     DTREBUILD(1M)   K-AShare by Xinet (10/14/99 10.1)	 DTREBUILD(1M)



	       those operations	are selected, this option is implied.

	  -u user
	       (root only) restricts the volume	list to	ones for the
	       specified user.	This option may	not be used along with
	       the -a option or	OPerations that	must be	done on	all
	       volumes.

	  -chroot rootdir
	       Runs the	entire program with the	root of	the filesystem
	       changed to rootdir.  This option	is useful when working
	       from an installation miniroot.

	  The following	OPerations are supported.  Selecting any OP
	  that must be done on all volumes implies that	all selected
	  OPs will be done on all volumes.

	  nop  Does nothing; however, some Volume and File-searching
	       debug messages are generated only within	the nop
	       operation.

	  clean
	       Delete old Resource forks that don't match existing
	       data forks.  Remove Desktop file	entries	for files that
	       are no longer present.  Set the Type and	Creator	for
	       any file	with creator currently set to ``uxex'' or
	       ``uxtt' (does not re-type files with no type/creator
	       info - see kats(1) for that operation).

	  Trash_Me
	       Irreversibly destroy all	AppleShare-specific
	       information in the specified volumes or directories.
	       This will delete	every .HSResource directory it comes
	       across. Should only be used on directory	trees that
	       will never again	be used	as AppleShare volumes.

	  fid  Clean out old File IDs and Directory IDs	that no	longer
	       correspond to real files.  If large subdirectories have
	       been deleted via	(for example) the Unix ``rm'' command,
	       this operation can free up space	inside the FileID
	       database.

	  icon Update the Icon Database.  Reads	icons referenced by
	       BNDL resources and stores them in the icon database.
	       When run	on all volumes,	the database is	deleted	before
	       anything	is stored.

	  appl Update the Application Database.	 When run on a whole
	       volume (starting	with the volume's top-level
	       directory), every entry for that	volume is deleted
	       first.  When the	-a option is also specified, the
	       entire Application Database is deleted before storing



     Page 2					     (printed 5/4/100)






     DTREBUILD(1M)   K-AShare by Xinet (10/14/99 10.1)	 DTREBUILD(1M)



	       entries for all applications currently on all volumes.

	  rmfpo
	       (Fullpress only)	 Removes any FPOs associated with
	       image files.  This OP can work on files or directories,
	       whether or not they're part of an OPI volume.

	  rmweb
	       (Fullpress only)	 Removes any WEB-specific previews
	       (GIFs and/or JPEGs) associated with image files.	 This
	       operation is independent	of the rmfpo option, but if
	       both are	specified, all FullPress- and Webnativespecific
	additions to a file are	deleted	(this does not
	       include PICT previews or	custom icons).

	  fpo  (Fullpress, root	only)  Rebuild FPOs in the specified
	       volume or directory, or FPO(s) for the given file(s),
	       using current FPO option	settings.  Doesn't actually
	       rebuild them directly, but instructs fpod(1m) to	do it.
	       This can	take a long time on volumes with many image
	       files in	them.

	  epsfpo
	       (Fullpress, root	only)  Differs from the	fpo operation
	       in that it only remakes FPOs that are EPS format.

	  pict (Fullpress, root	only)  Force a remake of PICT previews
	       made by FullPress for any Web or	FPO images.  This can
	       be used with other fpo operations, but forces dtrebuild
	       to work on all images that can have a low-res version.

	  locfpo
	       (Fullpress, root	only)  Do whatever is necessary	to
	       keep FPOs up to date with regard	to their location.  It
	       either updates the location information inside an EPS
	       FPO or, if the FPO is out of date, does a rebuild.

	  web  (root only)  Force a re-make of WebNative volume
	       images.	Unless the fpo option is also specified, only
	       the GIF/JPEG low-resolution images will be made on
	       volumes where WebNative is enabled.

	  newicon
	       (root only)  Convert pre-version-9 custom folder	icons
	       to the version 9	format.	 This may be done any number
	       of times	and will have no effect	if the folder icons
	       are already in version 9	format.

     SEE ALSO    [Toc]    [Back]
	  ksd(1m), opidebug(5),	fpovolopts(5), fpod(1m)

     FILES    [Toc]    [Back]



     Page 3					     (printed 5/4/100)






     DTREBUILD(1M)   K-AShare by Xinet (10/14/99 10.1)	 DTREBUILD(1M)



	  /usr/adm/appletalk/KASPubVols
	       public AppleShare volumes list

	  ~/.KSVols
	       per-user	volumes	list

	  /usr/adm/appletalk/fpovolopts
	       FPO options per AppleTalk volume

	  /usr/adm/appletalk/fiddb.new.*
	       AppleShare Server File/Directory	ID database

	  /usr/adm/appletalk/icons/KASicondt.new.*
	       AppleShare Server Icon Database

	  /usr/adm/appletalk/appldb.new.*
	       AppleShare Server Application Database






































     Page 4					     (printed 5/4/100)