dtrebuild(1M)

     NAME
          dtrebuild - ``desktop'' maintenance of AppleShare volumes

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

     DESCRIPTION
          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-to-
          date 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
          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
               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.

          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  (root, all volumes only)  Clean out old File IDs and
               Directory IDs that no longer correspond to real files.
               If large subdirectories have been deleted using 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
               entries for all applications currently on all volumes.

          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.

          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
          ksd(1), opidebug(5), fpovolopts(5), fpod(1m)

     FILES
          /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