unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 sccs(1)							     sccs(1)




 NAME
      sccs - front-end utility program for SCCS commands

 SYNOPSIS
      sccs [-r] [-d rootpath] [-p dirpath] command [options] [file ...]

 DESCRIPTION
      The sccs command is a straightforward front end to the various
      programs comprising the Source Code Control System.  It includes the
      capability of running set-user-id to another user to allow shared
      access to the SCCS files.	 sccs reduces the need to explicitly
      reference the SCCS filenames.  The SCCS filenames are generated by
      prepending the string SCCS/s. to the working files specified.  The
      default SCCS subdirectory name can be overridden with the -p dirpath
      option.

      The command supplied to the sccs command can either be an SCCS program
      or a pseudo command.  The SCCS programs that sscs handles include
      admin, cdc, comb, delta, get, help, prs, rmdel, sact, unget, val, what
      and sccsdiff.  The pseudo commands are:

	   check       Prints a list of all files being edited.	 Returns a
		       non-zero exit status if a file is being edited.	The
		       intent is to allow an 'install' entry in a makefile
		       to verify that everything is included in the SCCS
		       file before a version is installed.  See the info
		       pseudo command for a description of the -b, -u user
		       and -U options.

	   clean       Removes all files from the current directory or the
		       named directory that can be recreated from the SCCS
		       files.  Does not remove files that are in the process
		       of being edited.	 If -b is given, branches (i.e.
		       SID's with three or more components) are ignored in
		       determining which files are being edited.  Therefore,
		       any edits on branches can be lost.

	   create      Creates the initial SCCS file, taking the contents
		       from file.  Any options to admin are accepted.  If
		       the files are created successfully, the original
		       files are renamed with a , (comma) on the front.
		       Read-only copies are retrieved with get.	 The renamed
		       files should be removed after you have verified that
		       the SCCS files have been created successfully.

	   delget      Runs delta on the named files and then get the new
		       versions.  The new versions of the files have
		       expanded identification keywords, and cannot be
		       edited.	The [-mprsy] options are passed to delta,
		       and the [-bceiklsx] options are passed to get.




 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 sccs(1)							     sccs(1)




	   deledit     Equivalent to delget, except that the get phase
		       includes the -e option.

	   diffs       Gives a diff listing between the current version of
		       the files being edited and the versions in SCCS
		       format.	The [-rcixt] options are passed to get.	 The
		       [-lsefhb] options are passed to diff.  The -C option
		       is passed to diff as -c.

	   edit	       Equivalent to get -e.

	   enter       Equivalent to create, except get is omitted.  This
		       pseudo command is useful when you want to run the
		       edit command immediately after creating the SCCS
		       file.

	   fix	       Removes a named delta, but leaves a copy of the delta
		       in the current directory.  The -r SID option is
		       required and must point to a leaf in the source tree.
		       Since a record of the changes is not preserved, fix
		       should be used carefully.

	   info	       Lists all the files being edited.  The -b option
		       ignores branches in determining which files are being
		       edited.	The -u user option lists only the files
		       being edited by user.  The -U option is equivalent to
		       -u current_user.

	   print       Prints information about named files.  Equivalent to
		       prs -a followed by get -p -m -s.

	   tell	       Lists all the files being edited, with a newline
		       after each entry.  See the info section for a
		       description of the -b, -u user and -U options.

	   unedit      Equivalent to unget.  Any changes made since the last
		       get are lost.  Use with caution.

      Certain commands, admin, cdc, check, clean, diffs, info, rmdel,
      sccsdiff, and tell cannot use the set-user-id feature, as this would
      allow anyone to change the authorizations.  These commands are always
      run as the real user.

    Options
      The options supplied to the SCCS commands are documented in the
      corresponding SCCS man pages.  The options supplied to the pseudo
      commands are documented in the above section.  All other options
      preceding command are documented as follows:

	   -r		  Runs sccs as the real user rather than the
			  effective user sccs is set-user-id to.



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 sccs(1)							     sccs(1)




	   -d rootpath	  Gives the pathname to be used as the root
			  directory for the SCCS files.	 rootpath defaults
			  to the current directory.  This flag takes
			  precedence over the PROJECTDIR environment
			  variable.

	   -p dirpath	  Specifies the pathname for the SCCS files.  The
			  default is the SCCS directory.  dirpath is
			  appended to rootpath and is inserted before the
			  final component of the pathname.

      The command sccs -d /usr -p cmd get src/b converts to
      get/usr/src/cmd/s.b.  This can be used to create aliases.	 For
      example, the command alias syssccs="sccs -p /usr/src/cmd" makes
      syssccs an alias that can be used in commands like syssccsgetb.

 EXTERNAL INFLUENCES
    Environment Variables
      If the PROJECTDIR environment variable is set, its value is used to
      determine the -d rootpath option value for rootpath.  If PROJECTDIR
      begins with a / (slash), the value is used directly; otherwise, the
      value is assume to be a login name and the home directory
      corresponding to login name is examined for a subdirectory named src
      or source.  If found, this directory path is used. Otherwise, the
      value is used as a relative path name.

      LC_CTYPE determines the interpretation of text within file as single-
      and/or multi-byte characters.

      LC_MESSAGES determines the language in which messages are displayed.

      If LC_CTYPE or LC_MESSAGES is not specified in the environment or is
      set to the empty string, the value of LANG is used as a default for
      each unspecified or empty variable.  If LANG is not specified or is
      set to the empty string, a default of "C" (see lang(5)) is used
      instead of LANG.

      If any internationalization variable contains an invalid setting, sccs
      behaves as if all internationalization variables are set to "C".	See
      environ(5).

    International Code Set Support
      Single-byte and multi-byte character code sets are supported.

 EXAMPLES
      To create a new SCCS file:

	   sccs create file

      To get a file for editing, edit it, create a new delta and get file
      for editing:



 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 sccs(1)							     sccs(1)




	   sccs edit file.c
	   ex file.c
	   sccs deledit file.c

      To get a file from another directory (/usr/src/cmd/SCCS/s.cc.c):

	   sccs -d /usr/src get cmd/cc.c

      To make a delta of a large number of files in the current directory,
      enter:

	   sccs delta *.c

      To get a list of files being edited that are not on branches, enter:

	   sccs info -b

      To get a list of files being edited by you, enter:

	   sccs tell -u

      In a makefile, to get source files from an SCCS file if it does not
      already exist, enter:

	   SRCS = <&lt&lt&lt;list of source files>&gt&gt&gt;
	   $ (SRCS) :
		sccs get $(REL) $@

 RETURN VALUE
      A successful completion returns 0.  On error, sccs exists with a value
      from <sysexits.h> or the exit value from the command that was invoked.
      The only exception is the check pseudo command which returns a non-
      zero exit status if a file is being edited.

 SEE ALSO
      admin(1), cdc(1), comb(1), delta(1), get(1), prs(1), rmdel(1),
      sact(1), sccsdiff(1), sccshelp(1), unget(1), val(1), vc(1), what(1),
      sccsfile(4).

 STANDARDS CONFORMANCE
      sccs: XPG4













 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000