1 findunref(1ONBLD)             illumos Build Tools            findunref(1ONBLD)
   2 
   3 
   4 
   5 findunref - find unused files in a source tree
   6 
   7 SYNOPSIS
   8        findunref [-s subtree] [-t tstampfile] [-S hg|tw|git] srcroot
   9        exceptfile
  10 
  11 DESCRIPTION
  12        The findunref utility lists the files in a source tree which have not
  13        been accessed more recently than a particular timestamp file.  Although
  14        findunref may be used on its own, it is usually invoked by
  15        nightly(1ONBLD) to find files that are never referenced during a given
  16        build (see -f in nightly(1ONBLD)).
  17 
  18        The root of the source tree to examine is specified by srcroot.  To
  19        simplify comparing findunref output from different source trees,
  20        findunref outputs all filenames relative to srcroot.
  21 

  61 NOTES
  62        Since many files are only used when building for a particular ISA
  63        (e.g., Makefiles that are specific to x86 or SPARC), builds must be
  64        done on all applicable ISAs and the results merged.  For instance, if
  65        nightly builds (with -f) are done on both SPARC and x86, usr/src will
  66        be populated with a corresponding unref-isa.out file, which can be
  67        merged with comm(1):
  68 
  69        comm -12 /path/to/unref-i386.out
  70                 /path/to/unref-sparc.out > unref.out
  71 
  72        This merged file can then be compared against the gate's latest
  73        unreferenced file list (e.g. /ws/onnv-gate/usr/src/unrefmaster.out).
  74 
  75        Different gates have different unreferenced file policies.  Any changes
  76        to exceptfile that would define new unreferenced file policies for a
  77        given gate must be cleared with the appropriate gatekeepers.
  78 
  79 
  80 
  81                                October 30, 2012              findunref(1ONBLD)

   1 FINDUNREF(1ONBLD)             illumos Build Tools            FINDUNREF(1ONBLD)
   2 
   3 
   4 
   5 findunref - find unused files in a source tree
   6 
   7 SYNOPSIS
   8        findunref [-s subtree] [-t tstampfile] [-S hg|tw|git] srcroot
   9        exceptfile
  10 
  11 DESCRIPTION
  12        The findunref utility lists the files in a source tree which have not
  13        been accessed more recently than a particular timestamp file.  Although
  14        findunref may be used on its own, it is usually invoked by
  15        nightly(1ONBLD) to find files that are never referenced during a given
  16        build (see -f in nightly(1ONBLD)).
  17 
  18        The root of the source tree to examine is specified by srcroot.  To
  19        simplify comparing findunref output from different source trees,
  20        findunref outputs all filenames relative to srcroot.
  21 

  61 NOTES
  62        Since many files are only used when building for a particular ISA
  63        (e.g., Makefiles that are specific to x86 or SPARC), builds must be
  64        done on all applicable ISAs and the results merged.  For instance, if
  65        nightly builds (with -f) are done on both SPARC and x86, usr/src will
  66        be populated with a corresponding unref-isa.out file, which can be
  67        merged with comm(1):
  68 
  69        comm -12 /path/to/unref-i386.out
  70                 /path/to/unref-sparc.out > unref.out
  71 
  72        This merged file can then be compared against the gate's latest
  73        unreferenced file list (e.g. /ws/onnv-gate/usr/src/unrefmaster.out).
  74 
  75        Different gates have different unreferenced file policies.  Any changes
  76        to exceptfile that would define new unreferenced file policies for a
  77        given gate must be cleared with the appropriate gatekeepers.
  78 
  79 
  80 
  81                                October 30, 2012              FINDUNREF(1ONBLD)