unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



sccs(1)								      sccs(1)



NAME

  sccs - Administration	program	for Source Code	Control	System (SCCS) com-
  mands

SYNOPSIS

  sccs [-r] [-d	pathname] [-p pathname]	command	[command-opts...] [parame-
  ters...]

STANDARDS

  Interfaces documented	on this	reference page conform to industry standards
  as follows:

  sccs:	XCU5.0

  Refer	to the standards(5) reference page for more information	about indus-
  try standards	and associated tags.

OPTIONS

  -d pathname
      Specifies	a root directory for the SCCS files.  The default is the
      current directory. The pathname argument is prepended to the entire
      path name	of a file. This	option takes precedence	over the PROJECTDIR
      variable.

  -p pathname
      Specifies	a path name for	the SCCS files.	The default is the SCCS
      directory.

      The pathname argument associated with the	-d option is inserted before
      the entire path name.  The pathname argument associated with the -p
      option is	inserted before	the final component of the path	name.  For
      example, the command sccs	-d/x -py get a/b converts to get /x/a/y/s.b.

      This can be used to create aliases.  See the first entry in the EXAM-
      PLES section.

  -r  Runs the sccs command as the real	user, rather than as the effective
      user to which the	sccs command is	set. Certain commands (admin, check,
      clean, diffs, info, rmdel, sccsdiff, tell) cannot	be run set-user-ID by
      all users, since this would allow	anyone to change the authorizations.
      These commands are always	run as the real	user.









OPERANDS

  command
      SCCS command or pseudocommand listed in the DESCRIPTION section to be
      executed.

  command-opts
      Options for the specified	command	or pseudocommand.

      All options specified after command are passed to	that command during
      execution.  (For a description of	command	options, see the appropriate
      command description.)

  parameters
      Parameters (usually file or directory path names)	for the	specified
      command or pseudocommand.

      All parameters specified after command are passed	to that	command	dur-
      ing execution.  (For a description of command parameters,	see the
      appropriate command description.)

DESCRIPTION

  The sccs command is an administration	program	that incorporates the set of
  SCCS commands	into the operating system.

  [Tru64 UNIX]	The sccs command can be	used to	assign or reassign file	own-
  ership.

  The sccs command activates a specified command with the specified options
  and arguments.  Each file is placed in a directory named SCCS	and named
  s.filename.  The directory SCCS is assumed to	exist relative to the current
  directory (unless the	-p option is used).

  Two types of commands	can be used in the sccs	command	syntax sentence.

  SCCS Commands


  The first type is the	sccs commands that can be entered at a prompt.	For a
  description of the command, options, and parameters, see the reference page
  with same name as the	command.

  Command
      Function

  admin
      Creates and initializes or changes (administer) SCCS files.

  cdc [Tru64 UNIX]  Changes the	comments in a Source Code Control System
      (SCCS) delta.

  comb
      [Tru64 UNIX]  Combines Source Code Control System	(SCCS) deltas.

  delta
      Saves editing changes in a Source	Code Control System (SCCS) file.

  get Creates a	specified version of a Source Code Control System (SCCS)
      file.

  prs Displays key information in a Source Code	Control	System (SCCS) file.

  rmdel
      Removes a	delta from a Source Code Control System	(SCCS) file.

  sact
      Displays current Source Code Control System (SCCS) file editing status.

  sccsdiff
      [Tru64 UNIX]  Compares two versions of a Source Code Control System
      (SCCS) file.

  sccshelp
      [Tru64 UNIX]  Provides information about a Source	Code Control System
      (SCCS) message or	command.

  unget
      Cancels a	previous get command

  val Validates	Source Code Control System (SCCS) files.

  what
      Displays identifying information for Source Code Control System (SCCS)
      files.

  Pseudocommands


  The second type is called pseudocommands; they can be	used only as part of
  the sccs command syntax. These pseudocommands, the actions they perform,
  options and parameters  are:

  Command
      Description

  check
      Prints all the files being edited. Returns a nonzero exit	status if a
      file is being edited.  The check program puts the	nonzero	status indi-
      cator in an install entry	in a makefile to verify	that the SCCS file is
      complete before installing a version. Equivalent to info except that
      nothing is printed if nothing is being edited.

      Options:

      -b  Ignores branches in determining which	files are being	edited.

      -u [user]
	  Lists	only the files being edited by you or the user named by	user.

      -U  Equivalent to	specifying -u <&lt;your login name>&gt;.

  clean
      Removes from the current directory or the	named directory	all files
      that can be recreated from SCCS files.  Does not remove files that are
      in the process of	being edited.

      Option:

      -b  Ignores branches in determining which	files are being	edited.
	  (Note: branches in the same directory	can be lost.)

  create
      Creates an SCCS file, copying the	initial	contents from a	file of	the
      same name.  If the file creation is successful, the original file	is
      renamed with a comma on the front.  It is	recommended, but not neces-
      sary, that you to	move or	remove the original file (as is	the case with
      the admin	command).

      Options:

      Accepts the same options as the admin command. See the admin(1) refer-
      ence page.

  delget
      Performs a delta command on the named files and then gets	a new ver-
      sion.  The new version of	the files has expanded identification
      keywords,	and cannot be edited.

      Options:

      -m, -p, -r, -s, -y
	  Can be passed	to the delta command.  See the delta(1)	reference
	  page.

      -b, -c, -e, -i, -k, -l, -s, -x
	  Can be passed	to the get command.  See the get(1) reference page.

  deledit
      Equivalent to the	delget pseudocommand, except that the get portion of
      the sentence includes the	-e option. The deledit option is useful	for
      creating a checkpoint in your current editing session.

      Options:

      -m, -p, -r, -s, -y
	  Can be passed	to the delta command.  See the delta(1)	reference
	  page.

      -b, -c, -i, -l, -s, -x
	  Can be passed	to the get command.  See the get(1) reference page.

  diffs
      Shows the	difference between the current version of the files you	are
      editing and the versions in SCCS format.

      Options:

      -r, -c, -i, -x, -t
	  Can be passed	to the get command.  See the get(1) reference page.

      -l, -s, -e, -f, -h, -b
	  Can be passed	to the system diff (not	SCCS) command.	See the
	  diff(1) reference page.

      -C  Can be passed	to the system diff (not	SCCS) command as a -c option.
	  See the diff(1) reference page.

  edit
      Equivalent to the	get -e command.

  enter
      [Tru64 UNIX]  Creates an SCCS file, copying the initial contents from a
      file of the same name.  If the file creation is successful, the origi-
      nal file is renamed with a , (comma) at the beginning of the old file
      name.  This pseudocommand	is similar to create, except that enter	does
      not perform the equivalent of an SCCS get	command, and retrieves a
      read-only	version	of the newly created file. This	pseudocommand is use-
      ful when you want	to use an SCCS edit command immediately	after creat-
      ing an SCCS file.

  fix Removes a	named delta, but leaves	a copy of the delta with changes
      intact.  This copy is useful for fixing small compilation	errors.	 This
      command does not keep a record of	changes	made to	the file.  The fix
      command must include -r SID.

      Option:

      -r SID
	  Specifies the	delta to be removed.

  info
      Lists all	the files being	edited.

      Options:

      -b  Ignores branches in determining which	files are being	edited.

      -u [user]
	  Lists	only the files being edited by you or the user named by	user.

      -U  Equivalent to	specifying -u <&lt;your login name>&gt;.

  print
      Prints information about named files.  This SCCS pseudocommand is
      equivalent to the	SCCS command prs.

  tell
      Lists, on	standard output, all the files being edited, with a newline
      after each entry.

      Options:

      -b  Ignores branches in determining which	files are being	edited.

      -u [user]
	  Lists	only the files being edited by you or the user named by	user.

      -U  Equivalent to	specifying -u <&lt;your login name>&gt;.

  unedit
      Equivalent to the	unget command.	Any changes made since the get com-
      mand was used are	lost.

RESTRICTIONS

  [Tru64 UNIX]	In some	other versions of the utility, the command runs	with
  the UID of a pseudo-user named sccs.	This difference	can create compati-
  bility problems with permissions, especially in networked environments.

EXIT STATUS

  The following	exit values are	returned:

  0   Successful completion.

  >&gt;0  An error occurred.

EXAMPLES

   1.  Enter the command:
	    alias syssccs sccs -d/usr/abc/sccs

       This makes syssccs an alias that	can be used in commands	like:
	    syssccs get	cmd/who.c

   2.  To get a	file for editing, edit it, and produce a new delta, enter:
	    $ sccs get -e file.c
	    $ ex file.c
	    $ sccs delta file.c

   3.  To get a	file from another directory, enter:
	    sccs -p/usr/abc/sccs get cc.c

   4.  To make a delta of a large number of files in the current directory,
       enter:
	    sccs delta *.c

   5.  To get a	list of	files being edited that	are not	on branches, enter:
	    sccs info -b

   6.  To make a delta of everything being edited by you, enter:
	    sccs delta `sccs tell -u`

   7.  In a makefile, to get source files from an SCCS file if it does not
       already exist, enter:
	    REL	= 1.7
	    SRCS = <&lt;list of source files>&gt;
	    $(SRCS):
		   sccs	get $(REL) $@



ENVIRONMENT VARIABLES

  The following	environment variables affect the execution of sccs:

  LANG
      Provides a default value for the internationalization variables that
      are unset	or null. If LANG is unset or null, the corresponding value
      from the default locale is used.	If any of the internationalization
      variables	contain	an invalid setting, the	utility	behaves	as if none of
      the variables had	been defined.

  LC_ALL
      If set to	a non-empty string value, overrides the	values of all the
      other internationalization variables.

  LC_CTYPE
      Determines the locale for	the interpretation of sequences	of bytes of
      text data	as characters (for example, single-byte	as opposed to multi-
      byte characters in arguments and input files).

  LC_MESSAGES
      Determines the locale for	the format and contents	of diagnostic mes-
      sages written to standard	error.

  NLSPATH
      Determines the location of message catalogs for the processing of
      LC_MESSAGES.

  PROJECTDIR
      If this is set, its value	is used	to determine the -d option value. If
      PROJECTDIR begins	with a / (slash), the value is used directly; other-
      wise, the	home directory of a user of that name is examined for a	sub-
      directory	named src or source. If	found, that subdirectory is used.
      The -d option takes precedence over this variable.

SEE ALSO

  Commands:  admin(1), cdc(1), comb(1),	delta(1), get(1), make(1), make(1p),
  make(1u), prs(1), rmdel(1), sact(1), sccsdiff(1), sccshelp(1), unget(1),
  val(1), what(1)

  Files:  sccsfile(4)

  Standards:  standards(5)


  Programming Support Tools