doc/manual.docbook
changeset 252 75acaf1b1216
parent 238 4747f2920666
child 263 9f7ad3a71c90
equal deleted inserted replaced
247:efb4044593ed 252:75acaf1b1216
   418 </listitem>
   418 </listitem>
   419 </itemizedlist>
   419 </itemizedlist>
   420 </section>
   420 </section>
   421 </section>
   421 </section>
   422 <section>
   422 <section>
       
   423 <title>Logging</title>
       
   424 <para>
       
   425 Every successful access is logged in a file called
       
   426 <filename>~hg/repos/<replaceable>repository</replaceable>/.hg/servelog</filename>. The log records the time as a
       
   427 UTC ISO 8601 time, the operation ("push" or "pull"), the path to the key as
       
   428 used in the access rules, and the hex changeset ID.
       
   429 </para>
       
   430 </section>
       
   431 <section>
   423 <title>How mercurial-server works</title>
   432 <title>How mercurial-server works</title>
   424 <para>
   433 <para>
   425 All of the repositories controlled by mercurial-server are owned by a
   434 All of the repositories controlled by mercurial-server are owned by a
   426 single user, the <systemitem
   435 single user, the <systemitem
   427 class="username">hg</systemitem> user, which is why all URLs for
   436 class="username">hg</systemitem> user, which is why all URLs for
   448 class='directory'>hgadmin</filename> repository, creating an entry in
   457 class='directory'>hgadmin</filename> repository, creating an entry in
   449 <filename>~hg/.ssh/authorized_keys</filename> for each one. This is redone
   458 <filename>~hg/.ssh/authorized_keys</filename> for each one. This is redone
   450 automatically whenever a change is pushed to <filename
   459 automatically whenever a change is pushed to <filename
   451 class='directory'>hgadmin</filename>.
   460 class='directory'>hgadmin</filename>.
   452 </para>
   461 </para>
   453 </section>
       
   454 <section>
   462 <section>
   455 <title>Security</title>
   463 <title>Security</title>
   456 <para>
   464 <para>
   457 mercurial-server relies entirely on <command>sshd</command> to grant access to remote users.
   465 mercurial-server relies entirely on <command>sshd</command> to grant access to remote users.
   458 As a result, it runs no daemons, installs no setuid programs, and no part
   466 As a result, it runs no daemons, installs no setuid programs, and no part
   477 mercurial-server contains, the second depends on the relevant code being
   485 mercurial-server contains, the second depends on the relevant code being
   478 correct; though the entire codebase is short, mercurial-server is a fairly
   486 correct; though the entire codebase is short, mercurial-server is a fairly
   479 new program and may harbour bugs. Backups are essential!
   487 new program and may harbour bugs. Backups are essential!
   480 </para>
   488 </para>
   481 </section>
   489 </section>
   482 <section>
   490 </section>
   483 <title>Legalese</title>
   491 <section>
       
   492 <title>License and thanks</title>
   484 <para>
   493 <para>
   485 This program is free software; you can redistribute it and/or modify it
   494 This program is free software; you can redistribute it and/or modify it
   486 under the terms of the GNU General Public License as published by the Free
   495 under the terms of the GNU General Public License as published by the Free
   487 Software Foundation; either version 2 of the License, or (at your option)
   496 Software Foundation; either version 2 of the License, or (at your option)
   488 any later version.
   497 any later version.
   496 <para>
   505 <para>
   497 You should have received a copy of the GNU General Public License along
   506 You should have received a copy of the GNU General Public License along
   498 with this program; if not, write to the Free Software Foundation, Inc., 51
   507 with this program; if not, write to the Free Software Foundation, Inc., 51
   499 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
   508 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
   500 </para>
   509 </para>
   501 </section>
       
   502 <section>
       
   503 <title>Thanks</title>
       
   504 <para>
   510 <para>
   505 Thanks for reading this far. If you use mercurial-server, please tell me about
   511 Thanks for reading this far. If you use mercurial-server, please tell me about
   506 it.
   512 it.
   507 </para>
   513 </para>
   508 <para>
   514 <para>