mainconfig.sgml

gnugk软交换产品

Si vous avez besoin d'un autre format, vous pouvez construire votre propre chaîne
de format, en utilisant des r&#232;gles tir&#233;es de la fonction C <tt/strftime/
(voir man strftime ou chercher sur MSDN pour strftime).
En g&#233;n&#233;ral, la cha&#238;ne de format se compose de caract&#232;res normaux
et de codes de formatage, pr&#233;c&#233;d&#233;s d'un signe pourcent. Exemple:
"%Y-%m-%d et pourcent %%" donnera comme r&#233;sultat "2004-11-10 et pourcent %".
Quelques codes de format habituels:
<itemize>
<item><tt/%a/ - nom abr&#233;g&#233; du jour de la semaine
<item><tt/%A/ - nom complet du jour de la semaine
<item><tt/%b/ - nom abr&#233;g&#233; du mois
<item><tt/%B/ - nom complet du mois
<item><tt/%d/ - jour du mois sous la forme d'un nombre
<item><tt/%H/ - heure en format 24-heures
<item><tt/%I/ - heure en format 12-heures
<item><tt/%m/ - mois sous la forme d'un nombre
<item><tt/%M/ - minute sous la forme d'un nombre
<item><tt/%S/ - seconde sous la forme d'un nombre
<item><tt/%y/ - ann&#233;e sans le si&#232;cle
<item><tt/%Y/ - ann&#233;e avec le si&#232;cle
<item><tt/%u/ - microsecondes sous la forme d'un nombre (<bf/extension GnuGk/)
<item><tt/%z/ - abr&#233;viation du fuseau horaire (+0100)
<item><tt/%Z/ - nom du fuseau horaire
<item><tt/%%/ - signe pourcent
</itemize>

<item><tt/EncryptAllPasswords=1/<newline>
D&#233;faut: <tt/0/
<p>
Active le chiffrage de tous les mots de passe dans la configuration (mots de passe
SQL, RADIUS, [Password], [GkStatus::Auth]). Si c'est activ&#233; tous les mots de
passe doivent &#234;tre crypt&#233;s en utilisant l'utilitaire <tt/addpasswd/.
Autrement seuls les mots de passe de [Password] et [GkStatus::Auth] sont crypt&#233;s
(ancien comportement).

<item><tt/KeyFilled=0/<newline>
D&#233;faut: <tt>N/A</tt>
<p>
D&#233;finit un octet de remplissage global &#224; utiliser pendant le cryptage/
d&#233;cryptage de mot de passe. Il peut &#234;tre annul&#233; en positionnant
<tt/KeyFilled/ dans une section de configuration particuli&#232;re.
Habituellement, vous n'avez pas besoin de changer cette option.

</itemize>

La plupart des utilisateurs n'auront jamais besoin de modifier une des valeurs suivantes.
Ils sont principalement utilis&#233;s pour les tests ou pour des applications tr&#232;
sophistiqu&#233;es.

<itemize>
<item><tt/UseBroadcastListener=0/<newline>
D&#233;faut: <tt/1/
<p>
Indique si on doit &#233;couter au requ&#234;tes RAS diffus&#233;es. Ceci implique de
s'attacher &#224; toutes les interfaces sur la machine, donc si vous voulez lancer
plusieurs instances de gatekeepers sur la m&#234;me machine, vous devriez
d&#233;sactiver cette option.

<item><tt/UnicastRasPort=1719/<newline>
D&#233;faut: <tt/1719/
<p>
L'identifiant TSAP du canal RAS pour unicast(?).

<item><tt/MulticastPort=1718/<newline>
D&#233;faut: <tt/1718/
<p>
L'identifiant TSAP du canal RAS pour multicast.

<item><tt/MulticastGroup=224.0.1.41/<newline>
D&#233;faut: <tt/224.0.1.41/
<p>
Le groupe de multicast pour le canal RAS.

<item><tt/EndpointSignalPort=1720/<newline>
D&#233;faut: <tt/1720/
<p>
Default port for call signalling channel of endpoints.

<item><tt/ListenQueueLength=1024/<newline>
D&#233;faut: <tt/1024/
<p>
Longueur de la queue pour les connections entrantes TCP.

<item><tt/SignalReadTimeout=1000/<newline>
D&#233;faut: <tt/1000/
<p>
Temps en millisecondes pour le timeout de lecture sur les canaux de signal d'appel (Q931).

<item><tt/StatusReadTimeout=3000/<newline>
D&#233;faut: <tt/3000/
<p>
Temps en millisecondes pour le timeout de lecture sur le canal d'&#233;tat.

<item><tt/StatusWriteTimeout=5000/<newline>
D&#233;faut: <tt/5000/
<p>
Temps en millisecondes pour le timeout d'&#233;criture sur le canal d'&#233;tat.
</itemize>


<sect2>Section &lsqb;GkStatus::Auth&rsqb;
<p>
D&#233;finit un nombre de r&#232;gles pour indiquer qui est autoris&#233; &#224; se
connecter au port d'&#233;tat.
Chacun ayant acc&#232;s au port d'&#233;tat a le contr&#244;le total sur votre
gatekeeper. Assurez vous de le d&#233;finir correctement.
<itemize>
<item><tt/rule=allow/<newline>
D&#233;faut: <tt/forbid/
<p>
Les valeurs possibles sont
<itemize>
<item><tt/forbid/ - interdit toute connexion.
<item><tt/allow/ - autorise toute connexion.
<item><tt/explicit/ - lit le param&#232;tre <tt>ip=value</tt>
o&#249; <tt/ip/ est l'adresse IP i du client observateur,
<tt/value/ est <tt/1,0/ ou <tt/allow,forbid/ ou <tt/yes,no/.
Si <tt/ip/ n'est pas list&#233;e le param&#232;tre <tt/default/ est utilis&#233;.
<item><tt/regex/ - l'IP du client est compar&#233;e &#224; l'expression
r&#233;guli&#232;re.
<p><descrip>
<tag/Exemple:/
Pour autoriser les clients de 195.71.129.0/24 et 195.71.131.0/24:
<quote><tt>regex=^195\.71\.(129|131)\.[0-9]+$</tt></quote>
</descrip>
<item><tt/password/ - l'utilisateur doit saisir le nom d'utilisateur et le mot de passe
appropri&#233;s pour se connecter. Le format. Le format de username/password est le
m&#234;me que pour la section <ref id="password" name="[SimplePasswordAuth]">.

</itemize>

De plus, ces r&#232;gles peuvent &#234;tre combin&#233;es avec "|" ou "&amp;".
Par exemple,
<itemize>
<item><tt>rule=explicit | regex</tt><newline>
L'IP du client doit correspondre &#224; la r&#232;gle <tt/explicit/ <bf/ou/ <tt/regex/.
<p>
<item><tt>rule=regex & password</tt><newline>
L'IP du client doit correspondre &#224; la r&#232;gle <tt/regex/, <bf/et/ l'utilisateur
doit saisir son nom d'utilisateur et son mot de passe.
</itemize>

<item><tt/default=allow/<newline>
D&#233;faut: <tt/forbid/
<p>
Utilis&#233; uniquement quand <tt/rule=explicit/.

<item><tt/Shutdown=forbid/<newline>
D&#233;faut: <tt/allow/
<p>
Indique si on peut arr&#234;ter le gatekeeper par le port d'&#233;tat.

<item><tt/DelayReject=5/<newline>
D&#233;faut: <tt/0/
<p>
Combien de temps (en secondes) avant de rejeter un usernam/password invalide pour
l'acc&#232;s &#224; la ligne d'&#233;tat.
</itemize>


<sect2>Section &lsqb;LogFile&rsqb;
<label id="logfile">
<p>
Cette section d&#233;finit les param&#232;tres li&#233;s aux fichiers de log.
Actuellement, ceci permet aux utilisateurs de pr&#233;ciser les options de rotation
des fichiers de log.

<itemize>
<item><tt/Rotate=Hourly | Daily | Weekly | Monthly/<newline>
D&#233;faut: <tt>N/A</tt>
<p>
Si pr&#233;cis&#233;, le fichier de log tournera en se basant sur ce param&#232;tre.
La rotation Hourly effectue une rotation par heure, daily - un par jour, weekly - une
par semaine et monthly - une par mois. Le moment pr&#233;cis de rotation est
d&#233;fini par une combinaison des variables <tt/RotateDay/ et <tt/RotateTime/.
Pendant la rotation, un fichier existant est renomm&#233; en
CURRENT_FILENAME.YYYYMMDD-HHMMSS, o&#249; YYYYMMDD-HHMMSS est remplac&#233; par
l'horodate courant, et les nouvelles lignes sont &#233;crites dans un fichier vide.
Pour d&#233;sactiver cette rotation, ne pr&#233;cisez pas ce param&#232;tre ou fixez
le &#224; 0.

<descrip>
<tag/Exemple 1 - rotation chaque heure (00:45, 01:45, ..., 23:45):/
<tt/&lsqb;LogFile&rsqb;/<newline>
<tt>Rotate=Hourly</tt><newline>
<tt>RotateTime=45</tt><newline>
</descrip>

<descrip>
<tag/Exemple 2 - rotation chaque jour &#224; 23:00 (11PM):/
<tt/&lsqb;LogFile&rsqb;/<newline>
<tt>Rotate=Daily</tt><newline>
<tt>RotateTime=23:00</tt><newline>
</descrip>

<descrip>
<tag/Exemple 3 - rotation chaque Dimanche &#224; 00:59:/
<tt/&lsqb;LogFile&rsqb;/<newline>
<tt>Rotate=Weekly</tt><newline>
<tt>RotateDay=Sun</tt><newline>
<tt>RotateTime=00:59</tt><newline>
</descrip>

<descrip>
<tag/Exemple 4 - rotation le dernier jour de chaque mois:/
<tt/&lsqb;LogFile&rsqb;/<newline>
<tt>Rotate=Monthly</tt><newline>
<tt>RotateDay=31</tt><newline>
<tt>RotateTime=23:00</tt><newline>
</descrip>
</itemize>