Archives/cgit
2
0
Fork 0
mirror of https://git.zx2c4.com/cgit/ synced 2024-11-04 06:00:44 +00:00
Code Issues Projects Releases Wiki Activity
ded9393b17
cgit/README

56 lines
1.6 KiB
Plaintext
Raw 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
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
$ make gitsrc=<path>
$ su
$ make prefix=<path> install
Update README with install/config information Signed-off-by: Lars Hjemli <hjemli@gmail.com>
2007-01-28 12:18:23 +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
Default value for gitsrc is "../git", and this directory should contain the
git sources.
Default value for prefix is "/var/www/htdocs/cgit". This directory will
contain "cgit.cgi" and "cgit.css" after 'make install'.
After installation, httpd.conf probably must be updated with a Directory-
section for cgit, possibly something like this:
<Directory "/var/www/htdocs/cgit/">
AllowOverride None
Options ExecCGI
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
to runtime parameters, this file also contains a list of the repositories
displayed by cgit.
A template cgitrc is shipped with the sources, and all parameters and default
values are documented in this file.
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
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),
the content for the request is written into the proper cachefile before the
file is returned.
If the cachefile has expired but cgit is unable to obtain a lock for it, the
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".
Reference in New Issue Copy Permalink