.TH EMPIRE 6 .SH NAME empire \- Empire client .SH SYNOPSIS .B empire [\fB\-hkruv\fP] [\fB\-2\fP \fIoutfile\fP] [\fB\-H\fP \fIhistfile\fP] [\fB\-s\fP \fI[host:]port\fP] [\fIcountry\fP [\fIpassword\fP]] .br .SH DESCRIPTION .B empire is a bare bones client to connect to the Empire server. Empire is a global economic/political/military simulation game wherein players, representing national governments, make "real-time" decisions concerning resource allocation, national goals, international diplomatic efforts, etc. Extensive records are kept for all players. .PP WARNING -- This game is not only addictive but often peels back the thin veneer of civilization that hides the maniac within. .SH OPTIONS .TP .B \-h Help. Print brief usage information and exit. .TP .BI \-H " histfile" Load command history from \fIhistfile\fP, and save it back. Default is '~/.empire_history' without \fB\-r\fP, and none with \fB-r\fP. You might want to protect your history file from prying eyes. .IP Only available when compiled the GNU \fBreadline\fP library. .TP .B \-k If someone else is connected to your country, kill their connection. .TP .B \-r Restricted mode: disable redirections and execute command. This is useful when you want to grant somebody access to just Empire, but not to the host system's user account that runs the client. Be careful with \fB\-H\fP and \fB\-2\fP then. .TP .BI \-s " [host:]port" Specify server \fIhost\fR and \fIport\fR. .TP .B \-u Use UTF-8 rather than ASCII character set. .IP This requires server version 4.2.21 or later, and a terminal that understands UTF-8. .TP .B \-v Print version information and exit. .TP .BI \-2 " outfile" Append log of session to \fIoutfile\fR. .SH OPERANDS .TP .I country The name of your country in the game. .TP .I password The password for your country in the game. \fIWarning:\fR the password passed here is visible to other users on the same machine! .SH ENVIRONMENT VARIABLES The following environment variables affect the execution of the client: .TP .I EMPIREHOST Specifies the host to connect to, i.e. where the server runs. Only effective if no host specified via \-s. .TP .I EMPIREPORT Specifies the port number or service name to connect to. Only effective if no port specified via \-s. .TP .I COUNTRY The name of your country in the game. .TP .I PLAYER The password for your country in the game, also known as your representative. .TP .I LOGNAME Your user name. .TP .I INPUTRC The filename for the \fBreadline\fP startup file, overriding the default of \fI~/.inputrc\fP (see \fBREADLINE\fP below). .SH READLINE When compiled with the GNU \fBreadline\fP library, the client supports fancy line editing and persistent history. Its application name for application-specific settings is \fBEmpire\fP. See the readline documentation for details. .SH "SEE ALSO" \fIemp_server\fR(6), \fIreadline\fR(3). .SH FILES .TP .I ~/.inputrc Individual \fBreadline\fP initialization file .SH AUTHORS .nf Primary Author is Dave Pare Secondary authors/contributors may include: James Anderson Jeff Anton Markus Armbruster Phill Everson Steven Grimm Martin Haukeli Lewis R. Jansen Mike St. Johns Ron Koenderink Nick Lai Shelley Louie Steve McClure Chris Metcalf Dave Muir Sharnoff Keith Muller Chuck Musciano Jeff Okamoto Julian Onions Kurt Pires Jim Reuter Peter Vukovich Jeff Wallace John Yockey