The "razor" program

Rather than come up with numerous separate commands, each with differing expectations of what's required on the command line, we've opted to create a single program which can be directed to perform all sorts of tasks.

To get a full list of what the `razor' program can do for you, type...

# razor help

Note that the information resulting from the above command may include more options than what is described here. In case of conflict, refer to the information provided by the command itself. Below are some tables summarizing the command options and a reference to the section containing more detailed information.

In each of the following examples, there are some common themes which are best covered here. Items contained between square brackets ([]) are optional. If not supplied, defaults will be used. The backslash (\) is used below to continue the single-line command on multiple lines. Do not include the backslash when entering commands.

Flag	Meaning
-b	binary flag
-c	command
-d	directory
-f	file name. For issues, it is the issue number
-g	group name
-i	issue number, of the form <issue[:<issue group>]>
-k	disable keyword expansion
-m	allow multiple versions of a file (trunk/branch) to be included in the thread
-n	new file or folder
-o	force overwrite
-p	prose file name
-r	major revision number
-s	state
-t	title
-v	version
-z	for get and get_issue operations, send output to stdout

Parameter	Meaning
<name>	the name of the file/thread you are referring to (including folders where appropriate). Wildcards are not allowed. For files in folders or sub-folders, <name> must include the folder path to the file.
<issue>	a valid issue number, spelled out in either its fully annotated form (I..1-234) or as a simple integer value (1234)
<file>	the Razor file
<group>	the name of the Razor group the file is found in
<dir>	directory name. If this parameter is optional, and you have not supplied it, then the current working directory is assumed
<title>	a quoted text string, often serving as a comment for the effort

Administrative commands1	Purpose
razor [ down | stop ]	Brings the database server down
razor fmt [-width] [file]	Replacement for `fmt -s'
razor info	Displays connections to all db servers
razor id	Displays license id information
razor license	Setup/change license settings
razor license_info	Display license information
razor lm_down	Bring the license manager down
razor [ up | start ]	Brings the database server up
razor version	Display the current version information
razor who	Display list of connected users
razor whoami	Display the login name of effective user

1 See "Administrative functions" on page 155

Password commands1	Purpose
razor add_user [<user> [<user group> [<passwd>]]]	Adds a user to the password file
razor modify_user [<user> [<user group>]]	Modifies a user and optionally the user group in the password file
razor passwd <user>	Change the password for a user
razor passwd_info	Displays the info contained in the password file
razor remove_user [<user>]	Removes a user from the password file
razor user_info <user>	Displays user info from the password file

1 See "Password functions" on page 158.

Issues commands1	Purpose
razor new_issue [<issue group>]	Display a new issue form (must have issues running)
razor popup_issue \ <number[<:issue group>]>	Display an existing issue (must have issues running)
razor -c promote_issue \ -f <issue> -s <state> \ [-g <issue group>]	Promote the <issue> to the specified state2
razor -c rm_issue -f <issue> \ [-g <issue group>]	Remove the specified <issue>3

1 Unless otherwise noted, see "Bringing up issue forms by command line" on page 165 2 See "Changing promotion level / state by command line" on page 165 3 See "Deleting issues" on page 167

File version commands1	Purpose
razor -c branch -f <file> \ -g <group> [-v version] \ -t <title> \ [-i <issue[<:issue group>]>] \ [-p <file>]	Branch the specified <file>2
razor -c bump -f <file> \ -g <group> -t <title> \ [-r <new major>] \ [-i <issue[:<issue group>]>]	Bump the major version of the specified <file>
razor -c ci -f <file> \ -g <group> [-d dir] -t <title> \ [-i <issue[<:issue group>]>] \ [-p <file>]	Check the specified <file> in
razor -c co -f <file> \ -g <group> [-d dir] -t <title> \ [-o] [-p <file>] \ [-i <issue[<:issue group>]>]	Check the specified <file> out
razor compare <file1> <file2> \ <ATTRIBUTE | \ STATE <Attributes file>>	Compare the attributes in file1 to those in file23
razor -c get -f <file> \ -g <group> [-v version] \ [[-d dir] [-o] | [-z]]	Get a read only copy of the specified <file>
razor -c get_issue -f <issue> \ [-v version] [-d dir] \ [-g <issue group>] [-z] [-o]	Get a read only copy of the specified <issue>
razor -c intro -f <file> \ -g <group> [-b] [-k] \ [-d folder] \ [-i <issue[<:issue group>]>]	Introduce the specified <file>
razor -c new_folder \ -f <folder> -g <group>	Create a new <folder>4
razor -c promote -f <file> -v \ <version> -s <state> \ -g <group> \ [-i <issue[<:issue group>]>]	Promote the <file> to the specified state5
razor -c rename -f <file> \ -g <group> -n <new name>	Rename the specified <file> to <new name>6
razor -c rm -f <file> \ -g <group> \ [-i <issue[<:issue group>]>]	Remove the specified <file>7
razor -c rm_folder -f <folder> \ -g <group> \ [-i <issue[<:issue group>]>]	Remove the specified <folder> and all of its files/folders8
razor -c un_co -f <file> \ -g <group>	Un-check out the specified <file>

1 Unless otherwise noted, see "Checking files in and out" on page 160 2 See "Branching a file" on page 164 3 See "Comparing file attributes" on page 164 4 See "Creating a folder" on page 162 5 See "Promoting files and threads" on page 165 6 See "Renaming a file or folder" on page 162 7 See "Deleting files" on page 166 8 See "Deleting folders" on page 167

Threads commands1	Purpose
razor -c dup -f <name> \ -n <new name> -g <group> \ -t <title> \ [-i <issue[<:issue group>]>]	Duplicate the contents of the specified <thread>
razor -c new_thread -f <name> \ -g <group> [-n <file>] \ [-i <issue[<:issue group>]>] [-m]	Create a <thread>
razor -c modify -f <name> \ -g <group> -t <title> \ [-v <ver>] [-p <file>] \ [-n <file>] \ [-i <issue[<:issue group>]>] [-m]	Modify a thread or project
razor -c rm -f <name> \ -g <group>##Threads	Remove a thread.2
razor -c thread -f <name> \ -g <group> [-t top dir] \ [-v version] [-d dir] [-o]	Create thread scripts
razor -c thread_compare \ -f <name1> [-f <name2>] \ -g <group> [-v <v1>] [-v <v2>]	Compare two versions of a <thread> or two different threads

1 Unless otherwise noted, see "Working with threads" on page 168 2 See "Deleting threads" on page 167

Time commands1	Purpose
razor rz_fmt_time <val> <fmt>	Output string time for integer <val> using time format <fmt>
razor rz_time	Output integer value for current time
razor rz_time <string>	Output integer value for time <string> in the format yyyy/mm/dd,HH:MM:SS
razor rz_time_val <string> <fmt>	Output integer value for time <string> of format <fmt>

1 See "Time related functions" on page 172