bstat(1)            UNIX Programmer's Manual             bstat(1)



NAME
     bstat - report statistics on default environment

SYNOPSIS
     bstat
          [bcs_options] [file_options] [rcsstat_options]
          [file...]

     bcs_options:
                 [ -auto -fast -debug -quiet -rc -sb -set -newset
                 -newconfig -path -newpath ]

     file_options:
                 [ -all -wall -nowall -allb -wallb -nowallb -find
                 -wfind -nowfind]

     rcsstat_options:
                     [ -r -R -V]


FLAGS
 bcs_options - Defaults may be modified and/or overridden with
the following switches.

     -auto
          Automatically choose the default answer to any question
          asked by a command.  If the default answer requires
          manual intervention of some sort (e.g. to edit a file),
          then revert to interactive mode for the duration of the
          remaining operations for the current file and only
          return to automatic mode after proceeding to the next
          file in the list.

     -fast
          Always choose the default answer to any question asked
          by a command.  If the default answer requires manual
          intervention of some sort (e.g. to edit a file), then
          abort the operation on the current file instead and
          proceed to the next file in the list.

     -debug
          Enable debugging code.

     -quiet, -q
          Be less verbose about actions taken.

     -rc sandbox_rc_file
          Specifies an alternate sandbox rc file.  The defaults
          is $HOME/.sandboxrc.

     -sb sandbox_name
          Name of the sandbox to use.  If this option is not



Printed 1/23/91              4/25/90                            1

bstat(1)            UNIX Programmer's Manual             bstat(1)



          used, the sandbox will be determined by the environment
          variable SANDBOX or, if that is not set,  by the user's
          default sandbox as specified in the sandbox rc file.

     -sb_rc sandbox-rcfile
          Provides the path and name of the sandbox's rc file to
          use instaed of the default file sandbox/rc_files/local.
          If this option is not used, the default sandbox rc file
          will be used.

     -set set_name
          Performs operation on set_name instead of the  current
          default set.

     -path path
          Use path as the current directory within the shadow
          source area.  Used in conjunction with the -newpath
          option.

     -newpath
          Create and/or update the ./.BCSpath-<user_set_name> to
          contain the current relative path within the shadow
          source area.  This file is used by workon to chdir
          within to the same subdirectory when working on a set
          over an extended period of time.

 file_options - These options cause the list of affected file
names supplied on the command line to be extended.

     -all All files in the current set are operated on.  If this
          option is not chosen, the user must list the files to
          use.  The files in the set are listed in the sandbox's
          source directory in the file .BCSset- user_setname.

     -wall
          The same as -all. but only operates on the files in the
          set that are also writable.

     -nowall
          The same as -all. but only operates on the files in the
          set that are not writable.

     -alls user_set_name
          The same as -all -set user_set_name.

     -walls user_set_name
          The same as -wall -set user_set_name.

     -nowalls user_set_name
          The same as -nowall -set user_set_name.

     -find pattern



Printed 1/23/91              4/25/90                            2

bstat(1)            UNIX Programmer's Manual             bstat(1)



          First use all files found recursively with find(1)
          beginning at the current directory that match pattern,
          then use those on the command line.

     -wfind pattern
          The same as -find except use only writable files.

     -nowfind pattern
          The same as -find except use only non-writable files.
          pattern (with any trailing ",v" suffix stripped from
          all names), then use those on the command line.

rcsstat_options - A number of the regular RCS switches are also
supported

     -rrev
          displays information for rev instead of the default

     -R   returns the path and name of the master RCS file

     -V   returns just the revision number of file


DESCRIPTION
     This command acts as a front-end to the regular rcsstat com-
     mand and displays RCS status information for the current
     branch.

     The RCS -r switch may be used to modify the branch or revi-
     sion to select.  The RCS -V switch may be used to return
     just the revision number of the corresponding revision.


FILES
     ~/.sandboxrc
          rc file that specifies default sandbox

     rcfiles/sets
          list of valid sets in sandbox

     .BCSconfig-<user_set_name>
          RCS configuration definition for branch (base direc-
          tory)

     .BCSpath-<user_set_name>
          relative directory for branch within shadow area

     .BCSset-<user_set_name>
          list of files in branch (base directory)

     .BCSlog-<user_set_name>
          record of log messages for branch (base directory)



Printed 1/23/91              4/25/90                            3

bstat(1)            UNIX Programmer's Manual             bstat(1)



     /tmp/b-$USER/*
          temporary files


SEE ALSO
     bcs(1), bci(1), bco(1), bmerge(1), bcreate(1), blog(1),
     rcsstat(1), rcs(1), rcsintro(1),
     the RCS Cookbook.















































Printed 1/23/91              4/25/90                            4