mirrors/cgit
0
0
Fork 0
mirror of https://git.zx2c4.com/cgit synced 2024-11-26 18:38:42 +00:00
Code Issues Packages Projects Releases Wiki Activity
v0.9.0.3
cgit/README

86 lines
2.3 KiB
Plaintext
Raw Permalink Normal View History

Add caching infrastructure This enables internal caching of page output. Page requests are split into four groups: 1) repo listing (front page) 2) repo summary 3) repo pages w/symbolic references in query string 4) repo pages w/constant sha1's in query string Each group has a TTL specified in minutes. When a page is requested, a cached filename is stat(2)'ed and st_mtime is compared to time(2). If TTL has expired (or the file didn't exist), the cached file is regenerated. When generating a cached file, locking is used to avoid parallell processing of the request. If multiple processes tries to aquire the same lock, the ones who fail to get the lock serves the (expired) cached file. If the cached file don't exist, the process instead calls sched_yield(2) before restarting the request processing. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2006-12-10 21:31:36 +00:00
Remove implementation details from README Let README describe the "bigger picture" instead. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2006-12-13 01:06:29 +00:00
cgit - cgi for git
Update README with install/config information Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-01-28 12:18:23 +00:00
This is an attempt to create a fast web interface for the git scm, using a
builtin cache to decrease server io-pressure.
Remove implementation details from README Let README describe the "bigger picture" instead. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2006-12-13 01:06:29 +00:00
Update README with install/config information Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-01-28 12:18:23 +00:00
Installation
Update README Add new build instructions, extend the "Missing features" section and add a note about patches/email address of the author. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-09-04 09:49:40 +00:00
Building cgit involves building a proper version of git. How to do this
depends on how you obtained the cgit sources:
a) If you're working in a cloned cgit repository, you first need to
initialize and update the git submodule:
$ git submodule init # register the git submodule in .git/config
$ $EDITOR .git/config # if you want to specify a different url for git
$ git submodule update # clone/fetch and checkout correct git version
b) If you're building from a cgit tarball, you can download a proper git
version like this:
Update README with install/config information Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-01-28 12:18:23 +00:00
Update README Add new build instructions, extend the "Missing features" section and add a note about patches/email address of the author. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-09-04 09:49:40 +00:00
$ make get-git
Add support for prefix and gitsrc arguments to 'make' This should improve the installation a little, especially since the new options are mentioned in the README. Also, add a make-rule to build the git binaries if necessary + a dependency between cgit and libgit.a. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-02-04 22:57:34 +00:00
Update README Add new build instructions, extend the "Missing features" section and add a note about patches/email address of the author. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-09-04 09:49:40 +00:00
When either a) or b) has been performed, you can build and install cgit like
this:
Add support for prefix and gitsrc arguments to 'make' This should improve the installation a little, especially since the new options are mentioned in the README. Also, add a make-rule to build the git binaries if necessary + a dependency between cgit and libgit.a. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-02-04 22:57:34 +00:00
Update README Add new build instructions, extend the "Missing features" section and add a note about patches/email address of the author. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-09-04 09:49:40 +00:00
$ make
$ sudo make install
Update README with submodule build info Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-05-11 10:13:15 +00:00
Update README Add new build instructions, extend the "Missing features" section and add a note about patches/email address of the author. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-09-04 09:49:40 +00:00
This will install cgit.cgi and cgit.css into "/var/www/htdocs/cgit". You can
configure this location (and a few other things) by providing a "cgit.conf"
file (see the Makefile for details).
Update README with submodule build info Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-05-11 10:13:15 +00:00
Update README Add new build instructions, extend the "Missing features" section and add a note about patches/email address of the author. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-09-04 09:49:40 +00:00
Dependencies:
Update README
2011-03-05 13:21:47 +00:00
-git 1.7.4
Update README with submodule build info Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-05-11 10:13:15 +00:00
-zip lib
-crypto lib
-openssl lib
Apache configuration
A new Directory-section must probably be added for cgit, possibly something
like this:
Add support for prefix and gitsrc arguments to 'make' This should improve the installation a little, especially since the new options are mentioned in the README. Also, add a make-rule to build the git binaries if necessary + a dependency between cgit and libgit.a. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-02-04 22:57:34 +00:00
<Directory "/var/www/htdocs/cgit/">
AllowOverride None
Fix a typo in README, s/ExecCGI/+ExecCGI Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2010-10-11 04:58:30 +00:00
Options +ExecCGI
Add support for prefix and gitsrc arguments to 'make' This should improve the installation a little, especially since the new options are mentioned in the README. Also, add a make-rule to build the git binaries if necessary + a dependency between cgit and libgit.a. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-02-04 22:57:34 +00:00
Order allow,deny
Allow from all
</Directory>
Update README with install/config information Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-01-28 12:18:23 +00:00
Remove implementation details from README Let README describe the "bigger picture" instead. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2006-12-13 01:06:29 +00:00
Update README with install/config information Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-01-28 12:18:23 +00:00
Runtime configuration
Remove implementation details from README Let README describe the "bigger picture" instead. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2006-12-13 01:06:29 +00:00
Add support for prefix and gitsrc arguments to 'make' This should improve the installation a little, especially since the new options are mentioned in the README. Also, add a make-rule to build the git binaries if necessary + a dependency between cgit and libgit.a. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-02-04 22:57:34 +00:00
The file /etc/cgitrc is read by cgit before handling a request. In addition
README: update some stale information/add some new Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2011-06-13 13:24:46 +00:00
to runtime parameters, this file may also contain a list of repositories
displayed by cgit (see cgitrc.5.txt for further details).
Remove implementation details from README Let README describe the "bigger picture" instead. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2006-12-13 01:06:29 +00:00
Update README with install/config information Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-01-28 12:18:23 +00:00
The cache
Update README with submodule build info Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-05-11 10:13:15 +00:00
When cgit is invoked it looks for a cachefile matching the request and
returns it to the client. If no such cachefile exist (or if it has expired),
Update README with install/config information Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-01-28 12:18:23 +00:00
the content for the request is written into the proper cachefile before the
file is returned.
Update README with submodule build info Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-05-11 10:13:15 +00:00
If the cachefile has expired but cgit is unable to obtain a lock for it, the
Update README with install/config information Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-01-28 12:18:23 +00:00
stale cachefile is returned to the client. This is done to favour page
throughput over page freshness.
Remove implementation details from README Let README describe the "bigger picture" instead. Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2006-12-13 01:06:29 +00:00
Update README with install/config information Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-01-28 12:18:23 +00:00
The generated content contains the complete response to the client, including
the http-headers "Modified" and "Expires".
Update README with submodule build info Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-05-11 10:13:15 +00:00
README: update some stale information/add some new Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2011-06-13 13:24:46 +00:00
Online presence
Update README with submodule build info Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-05-11 10:13:15 +00:00
README: update some stale information/add some new Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2011-06-13 13:24:46 +00:00
* The cgit homepage is hosted by cgit at http://hjemli.net/git/cgit/about
Update README with submodule build info Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-05-11 10:13:15 +00:00
README: update some stale information/add some new Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2011-06-13 13:24:46 +00:00
* Patches, bugreports, discussions and support should go to the cgit
mailing list: cgit@hjemli.net
Reference in New Issue Copy Permalink