Command Line

From PC2wiki
Revision as of 07:13, 31 August 2017 by Doug Lane (talk | contribs) (--load option: add examples for remoteSserver and proxyme)
Jump to: navigation, search

The command line options for PC² for Version 9

These are options that can be used with the PC² scripts


All PC² scripts print usage using the --help command line option, for example:

pc2server --help

Login/Password options

Option Description Example
--login Login Login name --login server1
--login team2
--password Password Password --password Password


This will attempt to login account team3 with the password passone.

pc2team --login team3 --password passone

This will attempt to login account team3 with the password team3 (A joe account)

pc2team --login team3

Primary server Options

Primary server only
Option Description Example
--contestpassword Contest password --contestpassword pass


This will attempt to start a Primary server with contest password contest33 login account site1 with the password site1.

pc2server --login site1 --contestpassword contest33

This will attempt to login account site2 with the password sitepass2.

pc2server --login site2 --password sitepass2

-F option

Loading command line options from a properties file.

The -F option is a security feature. Under most Unix systems the complete command line is listed when using a ps or similar command revealing login ids and passwords. Using the -F option, login ids and passwords can be stored in a text file. Note that the command line options are not limited to login and password options; any command line option can be stored in the specified text file.

The -F can be used with any pc2 program (See PC² scripts for list of programs).


If this command line was used:

pc2server --nogui --contestpassword cpass --login site1 --password site1pass

One could alternatively use the -F option:

pc2server -F

where contains

# Command line for non GUI server
--contestpassword cpass
--login site1
--password site1pass

In the file blank lines and lines starting with a # are ignored. Each command line option must be on a different line.

--load option

The server --load option will load a configuration from a CDP. The --load option will only load the CDP into an "empty" server (a server that has not been previously loaded or configured).

See Load Contest Configuration article for more details about --load option.


 pc2server --nogui --contestpassword cpass --login site1 --password site1pass --load /home/pc2/cdp

--remoteServer option

Example that uses as the primary server

pc2server --nogui --contestpassword cpass --login site3 --password site1pass --remoteServer

--proxyme option

Example that uses as the primary server and proxy for this site

pc2server --nogui --contestpassword cpass --login site3 --password site1pass --remoteServer --proxyme

See Also