REFRESHBUG(1)

     NAME
          refreshbug - refresh ClearDDTS defect records from home
          system

     SYNOPSIS
          refreshbug [-p project] [-P project] [-b bugbox | id ...]

     DESCRIPTION
          The refreshbug utility can be used to resynchronize
          defects in a ClearDDTS  system  with those on the owning
          ClearDDTS system(s).  The ownership of a defect is
          determined  by  the project to which it belongs. Defects
          may go out-of-sync due to inconsistent mail links.  In
          normal operation, locally submitted  defects  and  those
          associated  with  subscribed projects are automatically kept
          in  sync  on  the  ClearDDTS network  via  email. However if
          mailers go down and mail is lost, refreshbug can be used to
          resynchronize the databases.


          This utility sends a list of defect identifiers and their
          associated  timestamps  to  the  owning  system.  The owning
          system uses the timestamps to determine if a defect is  out-
          of-sync.   It  is  assumed  that  the defect with the larger
          timestamp is newer and the owning  system  makes  sure  both
          sites have the same copy.

          The ids of the defect record(s) to be refreshed can
          be supplied  on the command line, or read from a specified
          bugbox file by specifying the -b option. If no
          ids are on the command line and no -b option is given,
          the list of bugs to be refreshed is read from the  standard
          input. However when  the  -P  option  is  specified, the
          refreshbug program generates the list of ids on its
          own.

          The -P option specifies that the bugs for the named
          project are to be refreshed instead of individual
          bugs.  This refreshes all bugs associated with the selected
          project. With this option, the owning system also sends copies
          of the bugs it has, that are not present on the local
          system. Refreshing a project only works if the local system
          subscribes to that project. You cannot specify the -p or -b
          options with this option.  Also any individual bugs specified
          via stdin will be ignored.

          The -p option specifies that the bugs for the named
          project are to be refreshed in addition to individual
          bugs specified on the command line.  Although the -p option,
          when correctly used, can be made to emulate the -P option, it
          does not have certain performance benefits that the -P option
          comes  with. The  -p option has been superceded by the -P option
          and is available for backward compatibility only.

          The refreshbug program is invoked daily by ddtsclean(1) to
          make sure that all subscribed projects on the local system
          are in sync with the system that owns the project.

     EXAMPLES
          The following command refreshes the subscription to project
          compiler:

               refreshbug -P compiler

          To refresh all bugs the invoking user has submitted from
          this machine:

               findbug -e -s | refreshbug

          To refresh individual bugs:

               refreshbug XXXaa00055 XXXaa00122

     SEE ALSO
          adminbug(1), findbug(1)