.TH GENEWEB 1 "2004 Aug 12" "GeneWeb"
.UC 4
.SH NAME
gwd \- Launches the GeneWeb Process
.SH SYNOPSIS
.B gwd
[
.I command-line switches
] 
.br
.SH DESCRIPTION
.I gwd
launches the GeneWeb "daemon" process.  Once this is done,
you can attach to it using a web browser to view your
genealogical data.
.br
Connect to the GeneWeb process using a standard web browser
using the following:
.br
    http://localhost:2317/base
    http://127.0.0.1:2317/base
    http://address:2317/base
    http://address:port/base
.br
where "base" is the name of the database file.
.br
GeneWeb is coded in the functional language Objective CAML, 
and can be extended with byte-code or compiled code written 
in that language.
.PP
The primary documentation of
.I gwd 
is in the
.I HTML
.IR  ,
documentation, which you can find in the documentation directory (/usr/share/doc/geneweb on
Debian systems).
.br
Please look there for complete and up-to-date documentation.
.PP
.SM GeneWeb Options
.PP
.TP 8
.B \-help
Show possible options and switches
.TP 8
.B \-hd <dir>
Path to the 'lang' directory
.TP 8
.B \-dd <dir>
Path to the documentation directory
.TP 8
.B \-bd <dir>
Path to the GeneWeb database.
.TP 8
.B \-wd <dir>
Path to the socket communications (Windows) and access count.
.TP 8
.B \-cgi
Force cgi mode.
.TP 8
.B \-images_url <url>
URL for GeneWeb images (default: gwd send them)
.TP 8
.B \-images_dir <url>
Same than previous but directory name relative to current
.TP 8
.B \-a <ip>
Select a specific address (default = any address of this computer)
.TP 8
.B \-p <number>
Select a port number (default = 2317); > 1024 for normal users.
.TP 8
.B \-setup_link
Display a link to local gwsetup in bottom of pages.
.TP 8
.B \-wizard <passwd>
Set a wizard password: access to all dates and updating.
.TP 8
.B \-friend <passwd>
Set a friend password: access to all dates.
.TP 8
.B \-wjf
Wizard just friend (permanently)
.TP 8
.B \-lang <lang>
Set a default language (default: en).
.TP 8
.B \-blang <lang>
Select the user browser language if any.
.TP 8
.B \-only <address>
Only accept queries from IP address <address>.
.TP 8
.B \-auth <file>
Authorization file to restrict access.  The file must hold lines
of the form "user:password".
.TP 8
.B \-log <file>
Redirect log trace to this file.
.TP 8
.B \-nolock
Do not lock files before writing.
.TP 8
.B \-robot_xcl <cnt>,<sec>
Exclude connections when more than <cnt> requests in <sec> seconds.
.TP 8
.B \-login_tmout <sec>
Login timeout for entries with passwords in CGI mode (default 1800s)
.TP 8
.B \-redirect <addr>
Send a message to say that this service has been redirected to <addr>
.TP 8
.B \-trace_failed_passwd
Print the failed passwords in log
.TP 8
.B \-max_clients <num>
Max number of clients treated at the same time (default: no limit) (daemon only)
.TP 8
.B \-conn_tmout <sec>
Connection timeout (default 120s; 0 means no limit)
.TP 8
.B \-daemon
Unix daemon mode.

.SH "LICENSE"
.PP
Geneweb is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your
option) any later version.
.PP
.B Note
: this copyright does not cover 
.I genealogic data bases 
generated by GeneWeb, nor the use of GeneWeb as Web site server or CGI - this is
merely considered normal use of GeneWeb, and does not fall under the
the heading of "derived work". Also note that the GPL above is
copyrighted by the Free Software Foundation, but the instance of code
that it refers to (the software GeneWeb) is copyrighted by 
.I INRIA.

.\" This manual page was extended extended by Debian developers.