Code

Merge branch 'jn/mime-type-with-params'
[git.git] / gitweb / gitweb.perl
1 #!/usr/bin/perl
3 # gitweb - simple web interface to track changes in git repositories
4 #
5 # (C) 2005-2006, Kay Sievers <kay.sievers@vrfy.org>
6 # (C) 2005, Christian Gierke
7 #
8 # This program is licensed under the GPLv2
10 use 5.008;
11 use strict;
12 use warnings;
13 use CGI qw(:standard :escapeHTML -nosticky);
14 use CGI::Util qw(unescape);
15 use CGI::Carp qw(fatalsToBrowser set_message);
16 use Encode;
17 use Fcntl ':mode';
18 use File::Find qw();
19 use File::Basename qw(basename);
20 use Time::HiRes qw(gettimeofday tv_interval);
21 binmode STDOUT, ':utf8';
23 our $t0 = [ gettimeofday() ];
24 our $number_of_git_cmds = 0;
26 BEGIN {
27         CGI->compile() if $ENV{'MOD_PERL'};
28 }
30 our $version = "++GIT_VERSION++";
32 our ($my_url, $my_uri, $base_url, $path_info, $home_link);
33 sub evaluate_uri {
34         our $cgi;
36         our $my_url = $cgi->url();
37         our $my_uri = $cgi->url(-absolute => 1);
39         # Base URL for relative URLs in gitweb ($logo, $favicon, ...),
40         # needed and used only for URLs with nonempty PATH_INFO
41         our $base_url = $my_url;
43         # When the script is used as DirectoryIndex, the URL does not contain the name
44         # of the script file itself, and $cgi->url() fails to strip PATH_INFO, so we
45         # have to do it ourselves. We make $path_info global because it's also used
46         # later on.
47         #
48         # Another issue with the script being the DirectoryIndex is that the resulting
49         # $my_url data is not the full script URL: this is good, because we want
50         # generated links to keep implying the script name if it wasn't explicitly
51         # indicated in the URL we're handling, but it means that $my_url cannot be used
52         # as base URL.
53         # Therefore, if we needed to strip PATH_INFO, then we know that we have
54         # to build the base URL ourselves:
55         our $path_info = $ENV{"PATH_INFO"};
56         if ($path_info) {
57                 if ($my_url =~ s,\Q$path_info\E$,, &&
58                     $my_uri =~ s,\Q$path_info\E$,, &&
59                     defined $ENV{'SCRIPT_NAME'}) {
60                         $base_url = $cgi->url(-base => 1) . $ENV{'SCRIPT_NAME'};
61                 }
62         }
64         # target of the home link on top of all pages
65         our $home_link = $my_uri || "/";
66 }
68 # core git executable to use
69 # this can just be "git" if your webserver has a sensible PATH
70 our $GIT = "++GIT_BINDIR++/git";
72 # absolute fs-path which will be prepended to the project path
73 #our $projectroot = "/pub/scm";
74 our $projectroot = "++GITWEB_PROJECTROOT++";
76 # fs traversing limit for getting project list
77 # the number is relative to the projectroot
78 our $project_maxdepth = "++GITWEB_PROJECT_MAXDEPTH++";
80 # string of the home link on top of all pages
81 our $home_link_str = "++GITWEB_HOME_LINK_STR++";
83 # name of your site or organization to appear in page titles
84 # replace this with something more descriptive for clearer bookmarks
85 our $site_name = "++GITWEB_SITENAME++"
86                  || ($ENV{'SERVER_NAME'} || "Untitled") . " Git";
88 # filename of html text to include at top of each page
89 our $site_header = "++GITWEB_SITE_HEADER++";
90 # html text to include at home page
91 our $home_text = "++GITWEB_HOMETEXT++";
92 # filename of html text to include at bottom of each page
93 our $site_footer = "++GITWEB_SITE_FOOTER++";
95 # URI of stylesheets
96 our @stylesheets = ("++GITWEB_CSS++");
97 # URI of a single stylesheet, which can be overridden in GITWEB_CONFIG.
98 our $stylesheet = undef;
99 # URI of GIT logo (72x27 size)
100 our $logo = "++GITWEB_LOGO++";
101 # URI of GIT favicon, assumed to be image/png type
102 our $favicon = "++GITWEB_FAVICON++";
103 # URI of gitweb.js (JavaScript code for gitweb)
104 our $javascript = "++GITWEB_JS++";
106 # URI and label (title) of GIT logo link
107 #our $logo_url = "http://www.kernel.org/pub/software/scm/git/docs/";
108 #our $logo_label = "git documentation";
109 our $logo_url = "http://git-scm.com/";
110 our $logo_label = "git homepage";
112 # source of projects list
113 our $projects_list = "++GITWEB_LIST++";
115 # the width (in characters) of the projects list "Description" column
116 our $projects_list_description_width = 25;
118 # group projects by category on the projects list
119 # (enabled if this variable evaluates to true)
120 our $projects_list_group_categories = 0;
122 # default category if none specified
123 # (leave the empty string for no category)
124 our $project_list_default_category = "";
126 # default order of projects list
127 # valid values are none, project, descr, owner, and age
128 our $default_projects_order = "project";
130 # show repository only if this file exists
131 # (only effective if this variable evaluates to true)
132 our $export_ok = "++GITWEB_EXPORT_OK++";
134 # show repository only if this subroutine returns true
135 # when given the path to the project, for example:
136 #    sub { return -e "$_[0]/git-daemon-export-ok"; }
137 our $export_auth_hook = undef;
139 # only allow viewing of repositories also shown on the overview page
140 our $strict_export = "++GITWEB_STRICT_EXPORT++";
142 # list of git base URLs used for URL to where fetch project from,
143 # i.e. full URL is "$git_base_url/$project"
144 our @git_base_url_list = grep { $_ ne '' } ("++GITWEB_BASE_URL++");
146 # default blob_plain mimetype and default charset for text/plain blob
147 our $default_blob_plain_mimetype = 'text/plain';
148 our $default_text_plain_charset  = undef;
150 # file to use for guessing MIME types before trying /etc/mime.types
151 # (relative to the current git repository)
152 our $mimetypes_file = undef;
154 # assume this charset if line contains non-UTF-8 characters;
155 # it should be valid encoding (see Encoding::Supported(3pm) for list),
156 # for which encoding all byte sequences are valid, for example
157 # 'iso-8859-1' aka 'latin1' (it is decoded without checking, so it
158 # could be even 'utf-8' for the old behavior)
159 our $fallback_encoding = 'latin1';
161 # rename detection options for git-diff and git-diff-tree
162 # - default is '-M', with the cost proportional to
163 #   (number of removed files) * (number of new files).
164 # - more costly is '-C' (which implies '-M'), with the cost proportional to
165 #   (number of changed files + number of removed files) * (number of new files)
166 # - even more costly is '-C', '--find-copies-harder' with cost
167 #   (number of files in the original tree) * (number of new files)
168 # - one might want to include '-B' option, e.g. '-B', '-M'
169 our @diff_opts = ('-M'); # taken from git_commit
171 # Disables features that would allow repository owners to inject script into
172 # the gitweb domain.
173 our $prevent_xss = 0;
175 # Path to the highlight executable to use (must be the one from
176 # http://www.andre-simon.de due to assumptions about parameters and output).
177 # Useful if highlight is not installed on your webserver's PATH.
178 # [Default: highlight]
179 our $highlight_bin = "++HIGHLIGHT_BIN++";
181 # information about snapshot formats that gitweb is capable of serving
182 our %known_snapshot_formats = (
183         # name => {
184         #       'display' => display name,
185         #       'type' => mime type,
186         #       'suffix' => filename suffix,
187         #       'format' => --format for git-archive,
188         #       'compressor' => [compressor command and arguments]
189         #                       (array reference, optional)
190         #       'disabled' => boolean (optional)}
191         #
192         'tgz' => {
193                 'display' => 'tar.gz',
194                 'type' => 'application/x-gzip',
195                 'suffix' => '.tar.gz',
196                 'format' => 'tar',
197                 'compressor' => ['gzip', '-n']},
199         'tbz2' => {
200                 'display' => 'tar.bz2',
201                 'type' => 'application/x-bzip2',
202                 'suffix' => '.tar.bz2',
203                 'format' => 'tar',
204                 'compressor' => ['bzip2']},
206         'txz' => {
207                 'display' => 'tar.xz',
208                 'type' => 'application/x-xz',
209                 'suffix' => '.tar.xz',
210                 'format' => 'tar',
211                 'compressor' => ['xz'],
212                 'disabled' => 1},
214         'zip' => {
215                 'display' => 'zip',
216                 'type' => 'application/x-zip',
217                 'suffix' => '.zip',
218                 'format' => 'zip'},
219 );
221 # Aliases so we understand old gitweb.snapshot values in repository
222 # configuration.
223 our %known_snapshot_format_aliases = (
224         'gzip'  => 'tgz',
225         'bzip2' => 'tbz2',
226         'xz'    => 'txz',
228         # backward compatibility: legacy gitweb config support
229         'x-gzip' => undef, 'gz' => undef,
230         'x-bzip2' => undef, 'bz2' => undef,
231         'x-zip' => undef, '' => undef,
232 );
234 # Pixel sizes for icons and avatars. If the default font sizes or lineheights
235 # are changed, it may be appropriate to change these values too via
236 # $GITWEB_CONFIG.
237 our %avatar_size = (
238         'default' => 16,
239         'double'  => 32
240 );
242 # Used to set the maximum load that we will still respond to gitweb queries.
243 # If server load exceed this value then return "503 server busy" error.
244 # If gitweb cannot determined server load, it is taken to be 0.
245 # Leave it undefined (or set to 'undef') to turn off load checking.
246 our $maxload = 300;
248 # configuration for 'highlight' (http://www.andre-simon.de/)
249 # match by basename
250 our %highlight_basename = (
251         #'Program' => 'py',
252         #'Library' => 'py',
253         'SConstruct' => 'py', # SCons equivalent of Makefile
254         'Makefile' => 'make',
255 );
256 # match by extension
257 our %highlight_ext = (
258         # main extensions, defining name of syntax;
259         # see files in /usr/share/highlight/langDefs/ directory
260         map { $_ => $_ }
261                 qw(py c cpp rb java css php sh pl js tex bib xml awk bat ini spec tcl sql make),
262         # alternate extensions, see /etc/highlight/filetypes.conf
263         'h' => 'c',
264         map { $_ => 'sh'  } qw(bash zsh ksh),
265         map { $_ => 'cpp' } qw(cxx c++ cc),
266         map { $_ => 'php' } qw(php3 php4 php5 phps),
267         map { $_ => 'pl'  } qw(perl pm), # perhaps also 'cgi'
268         map { $_ => 'make'} qw(mak mk),
269         map { $_ => 'xml' } qw(xhtml html htm),
270 );
272 # You define site-wide feature defaults here; override them with
273 # $GITWEB_CONFIG as necessary.
274 our %feature = (
275         # feature => {
276         #       'sub' => feature-sub (subroutine),
277         #       'override' => allow-override (boolean),
278         #       'default' => [ default options...] (array reference)}
279         #
280         # if feature is overridable (it means that allow-override has true value),
281         # then feature-sub will be called with default options as parameters;
282         # return value of feature-sub indicates if to enable specified feature
283         #
284         # if there is no 'sub' key (no feature-sub), then feature cannot be
285         # overridden
286         #
287         # use gitweb_get_feature(<feature>) to retrieve the <feature> value
288         # (an array) or gitweb_check_feature(<feature>) to check if <feature>
289         # is enabled
291         # Enable the 'blame' blob view, showing the last commit that modified
292         # each line in the file. This can be very CPU-intensive.
294         # To enable system wide have in $GITWEB_CONFIG
295         # $feature{'blame'}{'default'} = [1];
296         # To have project specific config enable override in $GITWEB_CONFIG
297         # $feature{'blame'}{'override'} = 1;
298         # and in project config gitweb.blame = 0|1;
299         'blame' => {
300                 'sub' => sub { feature_bool('blame', @_) },
301                 'override' => 0,
302                 'default' => [0]},
304         # Enable the 'snapshot' link, providing a compressed archive of any
305         # tree. This can potentially generate high traffic if you have large
306         # project.
308         # Value is a list of formats defined in %known_snapshot_formats that
309         # you wish to offer.
310         # To disable system wide have in $GITWEB_CONFIG
311         # $feature{'snapshot'}{'default'} = [];
312         # To have project specific config enable override in $GITWEB_CONFIG
313         # $feature{'snapshot'}{'override'} = 1;
314         # and in project config, a comma-separated list of formats or "none"
315         # to disable.  Example: gitweb.snapshot = tbz2,zip;
316         'snapshot' => {
317                 'sub' => \&feature_snapshot,
318                 'override' => 0,
319                 'default' => ['tgz']},
321         # Enable text search, which will list the commits which match author,
322         # committer or commit text to a given string.  Enabled by default.
323         # Project specific override is not supported.
324         'search' => {
325                 'override' => 0,
326                 'default' => [1]},
328         # Enable grep search, which will list the files in currently selected
329         # tree containing the given string. Enabled by default. This can be
330         # potentially CPU-intensive, of course.
331         # Note that you need to have 'search' feature enabled too.
333         # To enable system wide have in $GITWEB_CONFIG
334         # $feature{'grep'}{'default'} = [1];
335         # To have project specific config enable override in $GITWEB_CONFIG
336         # $feature{'grep'}{'override'} = 1;
337         # and in project config gitweb.grep = 0|1;
338         'grep' => {
339                 'sub' => sub { feature_bool('grep', @_) },
340                 'override' => 0,
341                 'default' => [1]},
343         # Enable the pickaxe search, which will list the commits that modified
344         # a given string in a file. This can be practical and quite faster
345         # alternative to 'blame', but still potentially CPU-intensive.
346         # Note that you need to have 'search' feature enabled too.
348         # To enable system wide have in $GITWEB_CONFIG
349         # $feature{'pickaxe'}{'default'} = [1];
350         # To have project specific config enable override in $GITWEB_CONFIG
351         # $feature{'pickaxe'}{'override'} = 1;
352         # and in project config gitweb.pickaxe = 0|1;
353         'pickaxe' => {
354                 'sub' => sub { feature_bool('pickaxe', @_) },
355                 'override' => 0,
356                 'default' => [1]},
358         # Enable showing size of blobs in a 'tree' view, in a separate
359         # column, similar to what 'ls -l' does.  This cost a bit of IO.
361         # To disable system wide have in $GITWEB_CONFIG
362         # $feature{'show-sizes'}{'default'} = [0];
363         # To have project specific config enable override in $GITWEB_CONFIG
364         # $feature{'show-sizes'}{'override'} = 1;
365         # and in project config gitweb.showsizes = 0|1;
366         'show-sizes' => {
367                 'sub' => sub { feature_bool('showsizes', @_) },
368                 'override' => 0,
369                 'default' => [1]},
371         # Make gitweb use an alternative format of the URLs which can be
372         # more readable and natural-looking: project name is embedded
373         # directly in the path and the query string contains other
374         # auxiliary information. All gitweb installations recognize
375         # URL in either format; this configures in which formats gitweb
376         # generates links.
378         # To enable system wide have in $GITWEB_CONFIG
379         # $feature{'pathinfo'}{'default'} = [1];
380         # Project specific override is not supported.
382         # Note that you will need to change the default location of CSS,
383         # favicon, logo and possibly other files to an absolute URL. Also,
384         # if gitweb.cgi serves as your indexfile, you will need to force
385         # $my_uri to contain the script name in your $GITWEB_CONFIG.
386         'pathinfo' => {
387                 'override' => 0,
388                 'default' => [0]},
390         # Make gitweb consider projects in project root subdirectories
391         # to be forks of existing projects. Given project $projname.git,
392         # projects matching $projname/*.git will not be shown in the main
393         # projects list, instead a '+' mark will be added to $projname
394         # there and a 'forks' view will be enabled for the project, listing
395         # all the forks. If project list is taken from a file, forks have
396         # to be listed after the main project.
398         # To enable system wide have in $GITWEB_CONFIG
399         # $feature{'forks'}{'default'} = [1];
400         # Project specific override is not supported.
401         'forks' => {
402                 'override' => 0,
403                 'default' => [0]},
405         # Insert custom links to the action bar of all project pages.
406         # This enables you mainly to link to third-party scripts integrating
407         # into gitweb; e.g. git-browser for graphical history representation
408         # or custom web-based repository administration interface.
410         # The 'default' value consists of a list of triplets in the form
411         # (label, link, position) where position is the label after which
412         # to insert the link and link is a format string where %n expands
413         # to the project name, %f to the project path within the filesystem,
414         # %h to the current hash (h gitweb parameter) and %b to the current
415         # hash base (hb gitweb parameter); %% expands to %.
417         # To enable system wide have in $GITWEB_CONFIG e.g.
418         # $feature{'actions'}{'default'} = [('graphiclog',
419         #       '/git-browser/by-commit.html?r=%n', 'summary')];
420         # Project specific override is not supported.
421         'actions' => {
422                 'override' => 0,
423                 'default' => []},
425         # Allow gitweb scan project content tags of project repository,
426         # and display the popular Web 2.0-ish "tag cloud" near the projects
427         # list.  Note that this is something COMPLETELY different from the
428         # normal Git tags.
430         # gitweb by itself can show existing tags, but it does not handle
431         # tagging itself; you need to do it externally, outside gitweb.
432         # The format is described in git_get_project_ctags() subroutine.
433         # You may want to install the HTML::TagCloud Perl module to get
434         # a pretty tag cloud instead of just a list of tags.
436         # To enable system wide have in $GITWEB_CONFIG
437         # $feature{'ctags'}{'default'} = [1];
438         # Project specific override is not supported.
440         # In the future whether ctags editing is enabled might depend
441         # on the value, but using 1 should always mean no editing of ctags.
442         'ctags' => {
443                 'override' => 0,
444                 'default' => [0]},
446         # The maximum number of patches in a patchset generated in patch
447         # view. Set this to 0 or undef to disable patch view, or to a
448         # negative number to remove any limit.
450         # To disable system wide have in $GITWEB_CONFIG
451         # $feature{'patches'}{'default'} = [0];
452         # To have project specific config enable override in $GITWEB_CONFIG
453         # $feature{'patches'}{'override'} = 1;
454         # and in project config gitweb.patches = 0|n;
455         # where n is the maximum number of patches allowed in a patchset.
456         'patches' => {
457                 'sub' => \&feature_patches,
458                 'override' => 0,
459                 'default' => [16]},
461         # Avatar support. When this feature is enabled, views such as
462         # shortlog or commit will display an avatar associated with
463         # the email of the committer(s) and/or author(s).
465         # Currently available providers are gravatar and picon.
466         # If an unknown provider is specified, the feature is disabled.
468         # Gravatar depends on Digest::MD5.
469         # Picon currently relies on the indiana.edu database.
471         # To enable system wide have in $GITWEB_CONFIG
472         # $feature{'avatar'}{'default'} = ['<provider>'];
473         # where <provider> is either gravatar or picon.
474         # To have project specific config enable override in $GITWEB_CONFIG
475         # $feature{'avatar'}{'override'} = 1;
476         # and in project config gitweb.avatar = <provider>;
477         'avatar' => {
478                 'sub' => \&feature_avatar,
479                 'override' => 0,
480                 'default' => ['']},
482         # Enable displaying how much time and how many git commands
483         # it took to generate and display page.  Disabled by default.
484         # Project specific override is not supported.
485         'timed' => {
486                 'override' => 0,
487                 'default' => [0]},
489         # Enable turning some links into links to actions which require
490         # JavaScript to run (like 'blame_incremental').  Not enabled by
491         # default.  Project specific override is currently not supported.
492         'javascript-actions' => {
493                 'override' => 0,
494                 'default' => [0]},
496         # Enable and configure ability to change common timezone for dates
497         # in gitweb output via JavaScript.  Enabled by default.
498         # Project specific override is not supported.
499         'javascript-timezone' => {
500                 'override' => 0,
501                 'default' => [
502                         'local',     # default timezone: 'utc', 'local', or '(-|+)HHMM' format,
503                                      # or undef to turn off this feature
504                         'gitweb_tz', # name of cookie where to store selected timezone
505                         'datetime',  # CSS class used to mark up dates for manipulation
506                 ]},
508         # Syntax highlighting support. This is based on Daniel Svensson's
509         # and Sham Chukoury's work in gitweb-xmms2.git.
510         # It requires the 'highlight' program present in $PATH,
511         # and therefore is disabled by default.
513         # To enable system wide have in $GITWEB_CONFIG
514         # $feature{'highlight'}{'default'} = [1];
516         'highlight' => {
517                 'sub' => sub { feature_bool('highlight', @_) },
518                 'override' => 0,
519                 'default' => [0]},
521         # Enable displaying of remote heads in the heads list
523         # To enable system wide have in $GITWEB_CONFIG
524         # $feature{'remote_heads'}{'default'} = [1];
525         # To have project specific config enable override in $GITWEB_CONFIG
526         # $feature{'remote_heads'}{'override'} = 1;
527         # and in project config gitweb.remote_heads = 0|1;
528         'remote_heads' => {
529                 'sub' => sub { feature_bool('remote_heads', @_) },
530                 'override' => 0,
531                 'default' => [0]},
532 );
534 sub gitweb_get_feature {
535         my ($name) = @_;
536         return unless exists $feature{$name};
537         my ($sub, $override, @defaults) = (
538                 $feature{$name}{'sub'},
539                 $feature{$name}{'override'},
540                 @{$feature{$name}{'default'}});
541         # project specific override is possible only if we have project
542         our $git_dir; # global variable, declared later
543         if (!$override || !defined $git_dir) {
544                 return @defaults;
545         }
546         if (!defined $sub) {
547                 warn "feature $name is not overridable";
548                 return @defaults;
549         }
550         return $sub->(@defaults);
553 # A wrapper to check if a given feature is enabled.
554 # With this, you can say
556 #   my $bool_feat = gitweb_check_feature('bool_feat');
557 #   gitweb_check_feature('bool_feat') or somecode;
559 # instead of
561 #   my ($bool_feat) = gitweb_get_feature('bool_feat');
562 #   (gitweb_get_feature('bool_feat'))[0] or somecode;
564 sub gitweb_check_feature {
565         return (gitweb_get_feature(@_))[0];
569 sub feature_bool {
570         my $key = shift;
571         my ($val) = git_get_project_config($key, '--bool');
573         if (!defined $val) {
574                 return ($_[0]);
575         } elsif ($val eq 'true') {
576                 return (1);
577         } elsif ($val eq 'false') {
578                 return (0);
579         }
582 sub feature_snapshot {
583         my (@fmts) = @_;
585         my ($val) = git_get_project_config('snapshot');
587         if ($val) {
588                 @fmts = ($val eq 'none' ? () : split /\s*[,\s]\s*/, $val);
589         }
591         return @fmts;
594 sub feature_patches {
595         my @val = (git_get_project_config('patches', '--int'));
597         if (@val) {
598                 return @val;
599         }
601         return ($_[0]);
604 sub feature_avatar {
605         my @val = (git_get_project_config('avatar'));
607         return @val ? @val : @_;
610 # checking HEAD file with -e is fragile if the repository was
611 # initialized long time ago (i.e. symlink HEAD) and was pack-ref'ed
612 # and then pruned.
613 sub check_head_link {
614         my ($dir) = @_;
615         my $headfile = "$dir/HEAD";
616         return ((-e $headfile) ||
617                 (-l $headfile && readlink($headfile) =~ /^refs\/heads\//));
620 sub check_export_ok {
621         my ($dir) = @_;
622         return (check_head_link($dir) &&
623                 (!$export_ok || -e "$dir/$export_ok") &&
624                 (!$export_auth_hook || $export_auth_hook->($dir)));
627 # process alternate names for backward compatibility
628 # filter out unsupported (unknown) snapshot formats
629 sub filter_snapshot_fmts {
630         my @fmts = @_;
632         @fmts = map {
633                 exists $known_snapshot_format_aliases{$_} ?
634                        $known_snapshot_format_aliases{$_} : $_} @fmts;
635         @fmts = grep {
636                 exists $known_snapshot_formats{$_} &&
637                 !$known_snapshot_formats{$_}{'disabled'}} @fmts;
640 # If it is set to code reference, it is code that it is to be run once per
641 # request, allowing updating configurations that change with each request,
642 # while running other code in config file only once.
644 # Otherwise, if it is false then gitweb would process config file only once;
645 # if it is true then gitweb config would be run for each request.
646 our $per_request_config = 1;
648 # read and parse gitweb config file given by its parameter.
649 # returns true on success, false on recoverable error, allowing
650 # to chain this subroutine, using first file that exists.
651 # dies on errors during parsing config file, as it is unrecoverable.
652 sub read_config_file {
653         my $filename = shift;
654         return unless defined $filename;
655         # die if there are errors parsing config file
656         if (-e $filename) {
657                 do $filename;
658                 die $@ if $@;
659                 return 1;
660         }
661         return;
664 our ($GITWEB_CONFIG, $GITWEB_CONFIG_SYSTEM);
665 sub evaluate_gitweb_config {
666         our $GITWEB_CONFIG = $ENV{'GITWEB_CONFIG'} || "++GITWEB_CONFIG++";
667         our $GITWEB_CONFIG_SYSTEM = $ENV{'GITWEB_CONFIG_SYSTEM'} || "++GITWEB_CONFIG_SYSTEM++";
669         # use first config file that exists
670         read_config_file($GITWEB_CONFIG) or
671         read_config_file($GITWEB_CONFIG_SYSTEM);
674 # Get loadavg of system, to compare against $maxload.
675 # Currently it requires '/proc/loadavg' present to get loadavg;
676 # if it is not present it returns 0, which means no load checking.
677 sub get_loadavg {
678         if( -e '/proc/loadavg' ){
679                 open my $fd, '<', '/proc/loadavg'
680                         or return 0;
681                 my @load = split(/\s+/, scalar <$fd>);
682                 close $fd;
684                 # The first three columns measure CPU and IO utilization of the last one,
685                 # five, and 10 minute periods.  The fourth column shows the number of
686                 # currently running processes and the total number of processes in the m/n
687                 # format.  The last column displays the last process ID used.
688                 return $load[0] || 0;
689         }
690         # additional checks for load average should go here for things that don't export
691         # /proc/loadavg
693         return 0;
696 # version of the core git binary
697 our $git_version;
698 sub evaluate_git_version {
699         our $git_version = qx("$GIT" --version) =~ m/git version (.*)$/ ? $1 : "unknown";
700         $number_of_git_cmds++;
703 sub check_loadavg {
704         if (defined $maxload && get_loadavg() > $maxload) {
705                 die_error(503, "The load average on the server is too high");
706         }
709 # ======================================================================
710 # input validation and dispatch
712 # input parameters can be collected from a variety of sources (presently, CGI
713 # and PATH_INFO), so we define an %input_params hash that collects them all
714 # together during validation: this allows subsequent uses (e.g. href()) to be
715 # agnostic of the parameter origin
717 our %input_params = ();
719 # input parameters are stored with the long parameter name as key. This will
720 # also be used in the href subroutine to convert parameters to their CGI
721 # equivalent, and since the href() usage is the most frequent one, we store
722 # the name -> CGI key mapping here, instead of the reverse.
724 # XXX: Warning: If you touch this, check the search form for updating,
725 # too.
727 our @cgi_param_mapping = (
728         project => "p",
729         action => "a",
730         file_name => "f",
731         file_parent => "fp",
732         hash => "h",
733         hash_parent => "hp",
734         hash_base => "hb",
735         hash_parent_base => "hpb",
736         page => "pg",
737         order => "o",
738         searchtext => "s",
739         searchtype => "st",
740         snapshot_format => "sf",
741         extra_options => "opt",
742         search_use_regexp => "sr",
743         ctag => "by_tag",
744         # this must be last entry (for manipulation from JavaScript)
745         javascript => "js"
746 );
747 our %cgi_param_mapping = @cgi_param_mapping;
749 # we will also need to know the possible actions, for validation
750 our %actions = (
751         "blame" => \&git_blame,
752         "blame_incremental" => \&git_blame_incremental,
753         "blame_data" => \&git_blame_data,
754         "blobdiff" => \&git_blobdiff,
755         "blobdiff_plain" => \&git_blobdiff_plain,
756         "blob" => \&git_blob,
757         "blob_plain" => \&git_blob_plain,
758         "commitdiff" => \&git_commitdiff,
759         "commitdiff_plain" => \&git_commitdiff_plain,
760         "commit" => \&git_commit,
761         "forks" => \&git_forks,
762         "heads" => \&git_heads,
763         "history" => \&git_history,
764         "log" => \&git_log,
765         "patch" => \&git_patch,
766         "patches" => \&git_patches,
767         "remotes" => \&git_remotes,
768         "rss" => \&git_rss,
769         "atom" => \&git_atom,
770         "search" => \&git_search,
771         "search_help" => \&git_search_help,
772         "shortlog" => \&git_shortlog,
773         "summary" => \&git_summary,
774         "tag" => \&git_tag,
775         "tags" => \&git_tags,
776         "tree" => \&git_tree,
777         "snapshot" => \&git_snapshot,
778         "object" => \&git_object,
779         # those below don't need $project
780         "opml" => \&git_opml,
781         "project_list" => \&git_project_list,
782         "project_index" => \&git_project_index,
783 );
785 # finally, we have the hash of allowed extra_options for the commands that
786 # allow them
787 our %allowed_options = (
788         "--no-merges" => [ qw(rss atom log shortlog history) ],
789 );
791 # fill %input_params with the CGI parameters. All values except for 'opt'
792 # should be single values, but opt can be an array. We should probably
793 # build an array of parameters that can be multi-valued, but since for the time
794 # being it's only this one, we just single it out
795 sub evaluate_query_params {
796         our $cgi;
798         while (my ($name, $symbol) = each %cgi_param_mapping) {
799                 if ($symbol eq 'opt') {
800                         $input_params{$name} = [ $cgi->param($symbol) ];
801                 } else {
802                         $input_params{$name} = $cgi->param($symbol);
803                 }
804         }
807 # now read PATH_INFO and update the parameter list for missing parameters
808 sub evaluate_path_info {
809         return if defined $input_params{'project'};
810         return if !$path_info;
811         $path_info =~ s,^/+,,;
812         return if !$path_info;
814         # find which part of PATH_INFO is project
815         my $project = $path_info;
816         $project =~ s,/+$,,;
817         while ($project && !check_head_link("$projectroot/$project")) {
818                 $project =~ s,/*[^/]*$,,;
819         }
820         return unless $project;
821         $input_params{'project'} = $project;
823         # do not change any parameters if an action is given using the query string
824         return if $input_params{'action'};
825         $path_info =~ s,^\Q$project\E/*,,;
827         # next, check if we have an action
828         my $action = $path_info;
829         $action =~ s,/.*$,,;
830         if (exists $actions{$action}) {
831                 $path_info =~ s,^$action/*,,;
832                 $input_params{'action'} = $action;
833         }
835         # list of actions that want hash_base instead of hash, but can have no
836         # pathname (f) parameter
837         my @wants_base = (
838                 'tree',
839                 'history',
840         );
842         # we want to catch, among others
843         # [$hash_parent_base[:$file_parent]..]$hash_parent[:$file_name]
844         my ($parentrefname, $parentpathname, $refname, $pathname) =
845                 ($path_info =~ /^(?:(.+?)(?::(.+))?\.\.)?([^:]+?)?(?::(.+))?$/);
847         # first, analyze the 'current' part
848         if (defined $pathname) {
849                 # we got "branch:filename" or "branch:dir/"
850                 # we could use git_get_type(branch:pathname), but:
851                 # - it needs $git_dir
852                 # - it does a git() call
853                 # - the convention of terminating directories with a slash
854                 #   makes it superfluous
855                 # - embedding the action in the PATH_INFO would make it even
856                 #   more superfluous
857                 $pathname =~ s,^/+,,;
858                 if (!$pathname || substr($pathname, -1) eq "/") {
859                         $input_params{'action'} ||= "tree";
860                         $pathname =~ s,/$,,;
861                 } else {
862                         # the default action depends on whether we had parent info
863                         # or not
864                         if ($parentrefname) {
865                                 $input_params{'action'} ||= "blobdiff_plain";
866                         } else {
867                                 $input_params{'action'} ||= "blob_plain";
868                         }
869                 }
870                 $input_params{'hash_base'} ||= $refname;
871                 $input_params{'file_name'} ||= $pathname;
872         } elsif (defined $refname) {
873                 # we got "branch". In this case we have to choose if we have to
874                 # set hash or hash_base.
875                 #
876                 # Most of the actions without a pathname only want hash to be
877                 # set, except for the ones specified in @wants_base that want
878                 # hash_base instead. It should also be noted that hand-crafted
879                 # links having 'history' as an action and no pathname or hash
880                 # set will fail, but that happens regardless of PATH_INFO.
881                 if (defined $parentrefname) {
882                         # if there is parent let the default be 'shortlog' action
883                         # (for http://git.example.com/repo.git/A..B links); if there
884                         # is no parent, dispatch will detect type of object and set
885                         # action appropriately if required (if action is not set)
886                         $input_params{'action'} ||= "shortlog";
887                 }
888                 if ($input_params{'action'} &&
889                     grep { $_ eq $input_params{'action'} } @wants_base) {
890                         $input_params{'hash_base'} ||= $refname;
891                 } else {
892                         $input_params{'hash'} ||= $refname;
893                 }
894         }
896         # next, handle the 'parent' part, if present
897         if (defined $parentrefname) {
898                 # a missing pathspec defaults to the 'current' filename, allowing e.g.
899                 # someproject/blobdiff/oldrev..newrev:/filename
900                 if ($parentpathname) {
901                         $parentpathname =~ s,^/+,,;
902                         $parentpathname =~ s,/$,,;
903                         $input_params{'file_parent'} ||= $parentpathname;
904                 } else {
905                         $input_params{'file_parent'} ||= $input_params{'file_name'};
906                 }
907                 # we assume that hash_parent_base is wanted if a path was specified,
908                 # or if the action wants hash_base instead of hash
909                 if (defined $input_params{'file_parent'} ||
910                         grep { $_ eq $input_params{'action'} } @wants_base) {
911                         $input_params{'hash_parent_base'} ||= $parentrefname;
912                 } else {
913                         $input_params{'hash_parent'} ||= $parentrefname;
914                 }
915         }
917         # for the snapshot action, we allow URLs in the form
918         # $project/snapshot/$hash.ext
919         # where .ext determines the snapshot and gets removed from the
920         # passed $refname to provide the $hash.
921         #
922         # To be able to tell that $refname includes the format extension, we
923         # require the following two conditions to be satisfied:
924         # - the hash input parameter MUST have been set from the $refname part
925         #   of the URL (i.e. they must be equal)
926         # - the snapshot format MUST NOT have been defined already (e.g. from
927         #   CGI parameter sf)
928         # It's also useless to try any matching unless $refname has a dot,
929         # so we check for that too
930         if (defined $input_params{'action'} &&
931                 $input_params{'action'} eq 'snapshot' &&
932                 defined $refname && index($refname, '.') != -1 &&
933                 $refname eq $input_params{'hash'} &&
934                 !defined $input_params{'snapshot_format'}) {
935                 # We loop over the known snapshot formats, checking for
936                 # extensions. Allowed extensions are both the defined suffix
937                 # (which includes the initial dot already) and the snapshot
938                 # format key itself, with a prepended dot
939                 while (my ($fmt, $opt) = each %known_snapshot_formats) {
940                         my $hash = $refname;
941                         unless ($hash =~ s/(\Q$opt->{'suffix'}\E|\Q.$fmt\E)$//) {
942                                 next;
943                         }
944                         my $sfx = $1;
945                         # a valid suffix was found, so set the snapshot format
946                         # and reset the hash parameter
947                         $input_params{'snapshot_format'} = $fmt;
948                         $input_params{'hash'} = $hash;
949                         # we also set the format suffix to the one requested
950                         # in the URL: this way a request for e.g. .tgz returns
951                         # a .tgz instead of a .tar.gz
952                         $known_snapshot_formats{$fmt}{'suffix'} = $sfx;
953                         last;
954                 }
955         }
958 our ($action, $project, $file_name, $file_parent, $hash, $hash_parent, $hash_base,
959      $hash_parent_base, @extra_options, $page, $searchtype, $search_use_regexp,
960      $searchtext, $search_regexp);
961 sub evaluate_and_validate_params {
962         our $action = $input_params{'action'};
963         if (defined $action) {
964                 if (!validate_action($action)) {
965                         die_error(400, "Invalid action parameter");
966                 }
967         }
969         # parameters which are pathnames
970         our $project = $input_params{'project'};
971         if (defined $project) {
972                 if (!validate_project($project)) {
973                         undef $project;
974                         die_error(404, "No such project");
975                 }
976         }
978         our $file_name = $input_params{'file_name'};
979         if (defined $file_name) {
980                 if (!validate_pathname($file_name)) {
981                         die_error(400, "Invalid file parameter");
982                 }
983         }
985         our $file_parent = $input_params{'file_parent'};
986         if (defined $file_parent) {
987                 if (!validate_pathname($file_parent)) {
988                         die_error(400, "Invalid file parent parameter");
989                 }
990         }
992         # parameters which are refnames
993         our $hash = $input_params{'hash'};
994         if (defined $hash) {
995                 if (!validate_refname($hash)) {
996                         die_error(400, "Invalid hash parameter");
997                 }
998         }
1000         our $hash_parent = $input_params{'hash_parent'};
1001         if (defined $hash_parent) {
1002                 if (!validate_refname($hash_parent)) {
1003                         die_error(400, "Invalid hash parent parameter");
1004                 }
1005         }
1007         our $hash_base = $input_params{'hash_base'};
1008         if (defined $hash_base) {
1009                 if (!validate_refname($hash_base)) {
1010                         die_error(400, "Invalid hash base parameter");
1011                 }
1012         }
1014         our @extra_options = @{$input_params{'extra_options'}};
1015         # @extra_options is always defined, since it can only be (currently) set from
1016         # CGI, and $cgi->param() returns the empty array in array context if the param
1017         # is not set
1018         foreach my $opt (@extra_options) {
1019                 if (not exists $allowed_options{$opt}) {
1020                         die_error(400, "Invalid option parameter");
1021                 }
1022                 if (not grep(/^$action$/, @{$allowed_options{$opt}})) {
1023                         die_error(400, "Invalid option parameter for this action");
1024                 }
1025         }
1027         our $hash_parent_base = $input_params{'hash_parent_base'};
1028         if (defined $hash_parent_base) {
1029                 if (!validate_refname($hash_parent_base)) {
1030                         die_error(400, "Invalid hash parent base parameter");
1031                 }
1032         }
1034         # other parameters
1035         our $page = $input_params{'page'};
1036         if (defined $page) {
1037                 if ($page =~ m/[^0-9]/) {
1038                         die_error(400, "Invalid page parameter");
1039                 }
1040         }
1042         our $searchtype = $input_params{'searchtype'};
1043         if (defined $searchtype) {
1044                 if ($searchtype =~ m/[^a-z]/) {
1045                         die_error(400, "Invalid searchtype parameter");
1046                 }
1047         }
1049         our $search_use_regexp = $input_params{'search_use_regexp'};
1051         our $searchtext = $input_params{'searchtext'};
1052         our $search_regexp;
1053         if (defined $searchtext) {
1054                 if (length($searchtext) < 2) {
1055                         die_error(403, "At least two characters are required for search parameter");
1056                 }
1057                 $search_regexp = $search_use_regexp ? $searchtext : quotemeta $searchtext;
1058         }
1061 # path to the current git repository
1062 our $git_dir;
1063 sub evaluate_git_dir {
1064         our $git_dir = "$projectroot/$project" if $project;
1067 our (@snapshot_fmts, $git_avatar);
1068 sub configure_gitweb_features {
1069         # list of supported snapshot formats
1070         our @snapshot_fmts = gitweb_get_feature('snapshot');
1071         @snapshot_fmts = filter_snapshot_fmts(@snapshot_fmts);
1073         # check that the avatar feature is set to a known provider name,
1074         # and for each provider check if the dependencies are satisfied.
1075         # if the provider name is invalid or the dependencies are not met,
1076         # reset $git_avatar to the empty string.
1077         our ($git_avatar) = gitweb_get_feature('avatar');
1078         if ($git_avatar eq 'gravatar') {
1079                 $git_avatar = '' unless (eval { require Digest::MD5; 1; });
1080         } elsif ($git_avatar eq 'picon') {
1081                 # no dependencies
1082         } else {
1083                 $git_avatar = '';
1084         }
1087 # custom error handler: 'die <message>' is Internal Server Error
1088 sub handle_errors_html {
1089         my $msg = shift; # it is already HTML escaped
1091         # to avoid infinite loop where error occurs in die_error,
1092         # change handler to default handler, disabling handle_errors_html
1093         set_message("Error occured when inside die_error:\n$msg");
1095         # you cannot jump out of die_error when called as error handler;
1096         # the subroutine set via CGI::Carp::set_message is called _after_
1097         # HTTP headers are already written, so it cannot write them itself
1098         die_error(undef, undef, $msg, -error_handler => 1, -no_http_header => 1);
1100 set_message(\&handle_errors_html);
1102 # dispatch
1103 sub dispatch {
1104         if (!defined $action) {
1105                 if (defined $hash) {
1106                         $action = git_get_type($hash);
1107                 } elsif (defined $hash_base && defined $file_name) {
1108                         $action = git_get_type("$hash_base:$file_name");
1109                 } elsif (defined $project) {
1110                         $action = 'summary';
1111                 } else {
1112                         $action = 'project_list';
1113                 }
1114         }
1115         if (!defined($actions{$action})) {
1116                 die_error(400, "Unknown action");
1117         }
1118         if ($action !~ m/^(?:opml|project_list|project_index)$/ &&
1119             !$project) {
1120                 die_error(400, "Project needed");
1121         }
1122         $actions{$action}->();
1125 sub reset_timer {
1126         our $t0 = [ gettimeofday() ]
1127                 if defined $t0;
1128         our $number_of_git_cmds = 0;
1131 our $first_request = 1;
1132 sub run_request {
1133         reset_timer();
1135         evaluate_uri();
1136         if ($first_request) {
1137                 evaluate_gitweb_config();
1138                 evaluate_git_version();
1139         }
1140         if ($per_request_config) {
1141                 if (ref($per_request_config) eq 'CODE') {
1142                         $per_request_config->();
1143                 } elsif (!$first_request) {
1144                         evaluate_gitweb_config();
1145                 }
1146         }
1147         check_loadavg();
1149         # $projectroot and $projects_list might be set in gitweb config file
1150         $projects_list ||= $projectroot;
1152         evaluate_query_params();
1153         evaluate_path_info();
1154         evaluate_and_validate_params();
1155         evaluate_git_dir();
1157         configure_gitweb_features();
1159         dispatch();
1162 our $is_last_request = sub { 1 };
1163 our ($pre_dispatch_hook, $post_dispatch_hook, $pre_listen_hook);
1164 our $CGI = 'CGI';
1165 our $cgi;
1166 sub configure_as_fcgi {
1167         require CGI::Fast;
1168         our $CGI = 'CGI::Fast';
1170         my $request_number = 0;
1171         # let each child service 100 requests
1172         our $is_last_request = sub { ++$request_number > 100 };
1174 sub evaluate_argv {
1175         my $script_name = $ENV{'SCRIPT_NAME'} || $ENV{'SCRIPT_FILENAME'} || __FILE__;
1176         configure_as_fcgi()
1177                 if $script_name =~ /\.fcgi$/;
1179         return unless (@ARGV);
1181         require Getopt::Long;
1182         Getopt::Long::GetOptions(
1183                 'fastcgi|fcgi|f' => \&configure_as_fcgi,
1184                 'nproc|n=i' => sub {
1185                         my ($arg, $val) = @_;
1186                         return unless eval { require FCGI::ProcManager; 1; };
1187                         my $proc_manager = FCGI::ProcManager->new({
1188                                 n_processes => $val,
1189                         });
1190                         our $pre_listen_hook    = sub { $proc_manager->pm_manage()        };
1191                         our $pre_dispatch_hook  = sub { $proc_manager->pm_pre_dispatch()  };
1192                         our $post_dispatch_hook = sub { $proc_manager->pm_post_dispatch() };
1193                 },
1194         );
1197 sub run {
1198         evaluate_argv();
1200         $first_request = 1;
1201         $pre_listen_hook->()
1202                 if $pre_listen_hook;
1204  REQUEST:
1205         while ($cgi = $CGI->new()) {
1206                 $pre_dispatch_hook->()
1207                         if $pre_dispatch_hook;
1209                 run_request();
1211                 $post_dispatch_hook->()
1212                         if $post_dispatch_hook;
1213                 $first_request = 0;
1215                 last REQUEST if ($is_last_request->());
1216         }
1218  DONE_GITWEB:
1219         1;
1222 run();
1224 if (defined caller) {
1225         # wrapped in a subroutine processing requests,
1226         # e.g. mod_perl with ModPerl::Registry, or PSGI with Plack::App::WrapCGI
1227         return;
1228 } else {
1229         # pure CGI script, serving single request
1230         exit;
1233 ## ======================================================================
1234 ## action links
1236 # possible values of extra options
1237 # -full => 0|1      - use absolute/full URL ($my_uri/$my_url as base)
1238 # -replay => 1      - start from a current view (replay with modifications)
1239 # -path_info => 0|1 - don't use/use path_info URL (if possible)
1240 # -anchor => ANCHOR - add #ANCHOR to end of URL, implies -replay if used alone
1241 sub href {
1242         my %params = @_;
1243         # default is to use -absolute url() i.e. $my_uri
1244         my $href = $params{-full} ? $my_url : $my_uri;
1246         # implicit -replay, must be first of implicit params
1247         $params{-replay} = 1 if (keys %params == 1 && $params{-anchor});
1249         $params{'project'} = $project unless exists $params{'project'};
1251         if ($params{-replay}) {
1252                 while (my ($name, $symbol) = each %cgi_param_mapping) {
1253                         if (!exists $params{$name}) {
1254                                 $params{$name} = $input_params{$name};
1255                         }
1256                 }
1257         }
1259         my $use_pathinfo = gitweb_check_feature('pathinfo');
1260         if (defined $params{'project'} &&
1261             (exists $params{-path_info} ? $params{-path_info} : $use_pathinfo)) {
1262                 # try to put as many parameters as possible in PATH_INFO:
1263                 #   - project name
1264                 #   - action
1265                 #   - hash_parent or hash_parent_base:/file_parent
1266                 #   - hash or hash_base:/filename
1267                 #   - the snapshot_format as an appropriate suffix
1269                 # When the script is the root DirectoryIndex for the domain,
1270                 # $href here would be something like http://gitweb.example.com/
1271                 # Thus, we strip any trailing / from $href, to spare us double
1272                 # slashes in the final URL
1273                 $href =~ s,/$,,;
1275                 # Then add the project name, if present
1276                 $href .= "/".esc_path_info($params{'project'});
1277                 delete $params{'project'};
1279                 # since we destructively absorb parameters, we keep this
1280                 # boolean that remembers if we're handling a snapshot
1281                 my $is_snapshot = $params{'action'} eq 'snapshot';
1283                 # Summary just uses the project path URL, any other action is
1284                 # added to the URL
1285                 if (defined $params{'action'}) {
1286                         $href .= "/".esc_path_info($params{'action'})
1287                                 unless $params{'action'} eq 'summary';
1288                         delete $params{'action'};
1289                 }
1291                 # Next, we put hash_parent_base:/file_parent..hash_base:/file_name,
1292                 # stripping nonexistent or useless pieces
1293                 $href .= "/" if ($params{'hash_base'} || $params{'hash_parent_base'}
1294                         || $params{'hash_parent'} || $params{'hash'});
1295                 if (defined $params{'hash_base'}) {
1296                         if (defined $params{'hash_parent_base'}) {
1297                                 $href .= esc_path_info($params{'hash_parent_base'});
1298                                 # skip the file_parent if it's the same as the file_name
1299                                 if (defined $params{'file_parent'}) {
1300                                         if (defined $params{'file_name'} && $params{'file_parent'} eq $params{'file_name'}) {
1301                                                 delete $params{'file_parent'};
1302                                         } elsif ($params{'file_parent'} !~ /\.\./) {
1303                                                 $href .= ":/".esc_path_info($params{'file_parent'});
1304                                                 delete $params{'file_parent'};
1305                                         }
1306                                 }
1307                                 $href .= "..";
1308                                 delete $params{'hash_parent'};
1309                                 delete $params{'hash_parent_base'};
1310                         } elsif (defined $params{'hash_parent'}) {
1311                                 $href .= esc_path_info($params{'hash_parent'}). "..";
1312                                 delete $params{'hash_parent'};
1313                         }
1315                         $href .= esc_path_info($params{'hash_base'});
1316                         if (defined $params{'file_name'} && $params{'file_name'} !~ /\.\./) {
1317                                 $href .= ":/".esc_path_info($params{'file_name'});
1318                                 delete $params{'file_name'};
1319                         }
1320                         delete $params{'hash'};
1321                         delete $params{'hash_base'};
1322                 } elsif (defined $params{'hash'}) {
1323                         $href .= esc_path_info($params{'hash'});
1324                         delete $params{'hash'};
1325                 }
1327                 # If the action was a snapshot, we can absorb the
1328                 # snapshot_format parameter too
1329                 if ($is_snapshot) {
1330                         my $fmt = $params{'snapshot_format'};
1331                         # snapshot_format should always be defined when href()
1332                         # is called, but just in case some code forgets, we
1333                         # fall back to the default
1334                         $fmt ||= $snapshot_fmts[0];
1335                         $href .= $known_snapshot_formats{$fmt}{'suffix'};
1336                         delete $params{'snapshot_format'};
1337                 }
1338         }
1340         # now encode the parameters explicitly
1341         my @result = ();
1342         for (my $i = 0; $i < @cgi_param_mapping; $i += 2) {
1343                 my ($name, $symbol) = ($cgi_param_mapping[$i], $cgi_param_mapping[$i+1]);
1344                 if (defined $params{$name}) {
1345                         if (ref($params{$name}) eq "ARRAY") {
1346                                 foreach my $par (@{$params{$name}}) {
1347                                         push @result, $symbol . "=" . esc_param($par);
1348                                 }
1349                         } else {
1350                                 push @result, $symbol . "=" . esc_param($params{$name});
1351                         }
1352                 }
1353         }
1354         $href .= "?" . join(';', @result) if scalar @result;
1356         # final transformation: trailing spaces must be escaped (URI-encoded)
1357         $href =~ s/(\s+)$/CGI::escape($1)/e;
1359         if ($params{-anchor}) {
1360                 $href .= "#".esc_param($params{-anchor});
1361         }
1363         return $href;
1367 ## ======================================================================
1368 ## validation, quoting/unquoting and escaping
1370 sub validate_action {
1371         my $input = shift || return undef;
1372         return undef unless exists $actions{$input};
1373         return $input;
1376 sub validate_project {
1377         my $input = shift || return undef;
1378         if (!validate_pathname($input) ||
1379                 !(-d "$projectroot/$input") ||
1380                 !check_export_ok("$projectroot/$input") ||
1381                 ($strict_export && !project_in_list($input))) {
1382                 return undef;
1383         } else {
1384                 return $input;
1385         }
1388 sub validate_pathname {
1389         my $input = shift || return undef;
1391         # no '.' or '..' as elements of path, i.e. no '.' nor '..'
1392         # at the beginning, at the end, and between slashes.
1393         # also this catches doubled slashes
1394         if ($input =~ m!(^|/)(|\.|\.\.)(/|$)!) {
1395                 return undef;
1396         }
1397         # no null characters
1398         if ($input =~ m!\0!) {
1399                 return undef;
1400         }
1401         return $input;
1404 sub validate_refname {
1405         my $input = shift || return undef;
1407         # textual hashes are O.K.
1408         if ($input =~ m/^[0-9a-fA-F]{40}$/) {
1409                 return $input;
1410         }
1411         # it must be correct pathname
1412         $input = validate_pathname($input)
1413                 or return undef;
1414         # restrictions on ref name according to git-check-ref-format
1415         if ($input =~ m!(/\.|\.\.|[\000-\040\177 ~^:?*\[]|/$)!) {
1416                 return undef;
1417         }
1418         return $input;
1421 # decode sequences of octets in utf8 into Perl's internal form,
1422 # which is utf-8 with utf8 flag set if needed.  gitweb writes out
1423 # in utf-8 thanks to "binmode STDOUT, ':utf8'" at beginning
1424 sub to_utf8 {
1425         my $str = shift;
1426         return undef unless defined $str;
1427         if (utf8::valid($str)) {
1428                 utf8::decode($str);
1429                 return $str;
1430         } else {
1431                 return decode($fallback_encoding, $str, Encode::FB_DEFAULT);
1432         }
1435 # quote unsafe chars, but keep the slash, even when it's not
1436 # correct, but quoted slashes look too horrible in bookmarks
1437 sub esc_param {
1438         my $str = shift;
1439         return undef unless defined $str;
1440         $str =~ s/([^A-Za-z0-9\-_.~()\/:@ ]+)/CGI::escape($1)/eg;
1441         $str =~ s/ /\+/g;
1442         return $str;
1445 # the quoting rules for path_info fragment are slightly different
1446 sub esc_path_info {
1447         my $str = shift;
1448         return undef unless defined $str;
1450         # path_info doesn't treat '+' as space (specially), but '?' must be escaped
1451         $str =~ s/([^A-Za-z0-9\-_.~();\/;:@&= +]+)/CGI::escape($1)/eg;
1453         return $str;
1456 # quote unsafe chars in whole URL, so some characters cannot be quoted
1457 sub esc_url {
1458         my $str = shift;
1459         return undef unless defined $str;
1460         $str =~ s/([^A-Za-z0-9\-_.~();\/;?:@&= ]+)/CGI::escape($1)/eg;
1461         $str =~ s/ /\+/g;
1462         return $str;
1465 # quote unsafe characters in HTML attributes
1466 sub esc_attr {
1468         # for XHTML conformance escaping '"' to '&quot;' is not enough
1469         return esc_html(@_);
1472 # replace invalid utf8 character with SUBSTITUTION sequence
1473 sub esc_html {
1474         my $str = shift;
1475         my %opts = @_;
1477         return undef unless defined $str;
1479         $str = to_utf8($str);
1480         $str = $cgi->escapeHTML($str);
1481         if ($opts{'-nbsp'}) {
1482                 $str =~ s/ /&nbsp;/g;
1483         }
1484         $str =~ s|([[:cntrl:]])|(($1 ne "\t") ? quot_cec($1) : $1)|eg;
1485         return $str;
1488 # quote control characters and escape filename to HTML
1489 sub esc_path {
1490         my $str = shift;
1491         my %opts = @_;
1493         return undef unless defined $str;
1495         $str = to_utf8($str);
1496         $str = $cgi->escapeHTML($str);
1497         if ($opts{'-nbsp'}) {
1498                 $str =~ s/ /&nbsp;/g;
1499         }
1500         $str =~ s|([[:cntrl:]])|quot_cec($1)|eg;
1501         return $str;
1504 # Make control characters "printable", using character escape codes (CEC)
1505 sub quot_cec {
1506         my $cntrl = shift;
1507         my %opts = @_;
1508         my %es = ( # character escape codes, aka escape sequences
1509                 "\t" => '\t',   # tab            (HT)
1510                 "\n" => '\n',   # line feed      (LF)
1511                 "\r" => '\r',   # carrige return (CR)
1512                 "\f" => '\f',   # form feed      (FF)
1513                 "\b" => '\b',   # backspace      (BS)
1514                 "\a" => '\a',   # alarm (bell)   (BEL)
1515                 "\e" => '\e',   # escape         (ESC)
1516                 "\013" => '\v', # vertical tab   (VT)
1517                 "\000" => '\0', # nul character  (NUL)
1518         );
1519         my $chr = ( (exists $es{$cntrl})
1520                     ? $es{$cntrl}
1521                     : sprintf('\%2x', ord($cntrl)) );
1522         if ($opts{-nohtml}) {
1523                 return $chr;
1524         } else {
1525                 return "<span class=\"cntrl\">$chr</span>";
1526         }
1529 # Alternatively use unicode control pictures codepoints,
1530 # Unicode "printable representation" (PR)
1531 sub quot_upr {
1532         my $cntrl = shift;
1533         my %opts = @_;
1535         my $chr = sprintf('&#%04d;', 0x2400+ord($cntrl));
1536         if ($opts{-nohtml}) {
1537                 return $chr;
1538         } else {
1539                 return "<span class=\"cntrl\">$chr</span>";
1540         }
1543 # git may return quoted and escaped filenames
1544 sub unquote {
1545         my $str = shift;
1547         sub unq {
1548                 my $seq = shift;
1549                 my %es = ( # character escape codes, aka escape sequences
1550                         't' => "\t",   # tab            (HT, TAB)
1551                         'n' => "\n",   # newline        (NL)
1552                         'r' => "\r",   # return         (CR)
1553                         'f' => "\f",   # form feed      (FF)
1554                         'b' => "\b",   # backspace      (BS)
1555                         'a' => "\a",   # alarm (bell)   (BEL)
1556                         'e' => "\e",   # escape         (ESC)
1557                         'v' => "\013", # vertical tab   (VT)
1558                 );
1560                 if ($seq =~ m/^[0-7]{1,3}$/) {
1561                         # octal char sequence
1562                         return chr(oct($seq));
1563                 } elsif (exists $es{$seq}) {
1564                         # C escape sequence, aka character escape code
1565                         return $es{$seq};
1566                 }
1567                 # quoted ordinary character
1568                 return $seq;
1569         }
1571         if ($str =~ m/^"(.*)"$/) {
1572                 # needs unquoting
1573                 $str = $1;
1574                 $str =~ s/\\([^0-7]|[0-7]{1,3})/unq($1)/eg;
1575         }
1576         return $str;
1579 # escape tabs (convert tabs to spaces)
1580 sub untabify {
1581         my $line = shift;
1583         while ((my $pos = index($line, "\t")) != -1) {
1584                 if (my $count = (8 - ($pos % 8))) {
1585                         my $spaces = ' ' x $count;
1586                         $line =~ s/\t/$spaces/;
1587                 }
1588         }
1590         return $line;
1593 sub project_in_list {
1594         my $project = shift;
1595         my @list = git_get_projects_list();
1596         return @list && scalar(grep { $_->{'path'} eq $project } @list);
1599 ## ----------------------------------------------------------------------
1600 ## HTML aware string manipulation
1602 # Try to chop given string on a word boundary between position
1603 # $len and $len+$add_len. If there is no word boundary there,
1604 # chop at $len+$add_len. Do not chop if chopped part plus ellipsis
1605 # (marking chopped part) would be longer than given string.
1606 sub chop_str {
1607         my $str = shift;
1608         my $len = shift;
1609         my $add_len = shift || 10;
1610         my $where = shift || 'right'; # 'left' | 'center' | 'right'
1612         # Make sure perl knows it is utf8 encoded so we don't
1613         # cut in the middle of a utf8 multibyte char.
1614         $str = to_utf8($str);
1616         # allow only $len chars, but don't cut a word if it would fit in $add_len
1617         # if it doesn't fit, cut it if it's still longer than the dots we would add
1618         # remove chopped character entities entirely
1620         # when chopping in the middle, distribute $len into left and right part
1621         # return early if chopping wouldn't make string shorter
1622         if ($where eq 'center') {
1623                 return $str if ($len + 5 >= length($str)); # filler is length 5
1624                 $len = int($len/2);
1625         } else {
1626                 return $str if ($len + 4 >= length($str)); # filler is length 4
1627         }
1629         # regexps: ending and beginning with word part up to $add_len
1630         my $endre = qr/.{$len}\w{0,$add_len}/;
1631         my $begre = qr/\w{0,$add_len}.{$len}/;
1633         if ($where eq 'left') {
1634                 $str =~ m/^(.*?)($begre)$/;
1635                 my ($lead, $body) = ($1, $2);
1636                 if (length($lead) > 4) {
1637                         $lead = " ...";
1638                 }
1639                 return "$lead$body";
1641         } elsif ($where eq 'center') {
1642                 $str =~ m/^($endre)(.*)$/;
1643                 my ($left, $str)  = ($1, $2);
1644                 $str =~ m/^(.*?)($begre)$/;
1645                 my ($mid, $right) = ($1, $2);
1646                 if (length($mid) > 5) {
1647                         $mid = " ... ";
1648                 }
1649                 return "$left$mid$right";
1651         } else {
1652                 $str =~ m/^($endre)(.*)$/;
1653                 my $body = $1;
1654                 my $tail = $2;
1655                 if (length($tail) > 4) {
1656                         $tail = "... ";
1657                 }
1658                 return "$body$tail";
1659         }
1662 # takes the same arguments as chop_str, but also wraps a <span> around the
1663 # result with a title attribute if it does get chopped. Additionally, the
1664 # string is HTML-escaped.
1665 sub chop_and_escape_str {
1666         my ($str) = @_;
1668         my $chopped = chop_str(@_);
1669         if ($chopped eq $str) {
1670                 return esc_html($chopped);
1671         } else {
1672                 $str =~ s/[[:cntrl:]]/?/g;
1673                 return $cgi->span({-title=>$str}, esc_html($chopped));
1674         }
1677 ## ----------------------------------------------------------------------
1678 ## functions returning short strings
1680 # CSS class for given age value (in seconds)
1681 sub age_class {
1682         my $age = shift;
1684         if (!defined $age) {
1685                 return "noage";
1686         } elsif ($age < 60*60*2) {
1687                 return "age0";
1688         } elsif ($age < 60*60*24*2) {
1689                 return "age1";
1690         } else {
1691                 return "age2";
1692         }
1695 # convert age in seconds to "nn units ago" string
1696 sub age_string {
1697         my $age = shift;
1698         my $age_str;
1700         if ($age > 60*60*24*365*2) {
1701                 $age_str = (int $age/60/60/24/365);
1702                 $age_str .= " years ago";
1703         } elsif ($age > 60*60*24*(365/12)*2) {
1704                 $age_str = int $age/60/60/24/(365/12);
1705                 $age_str .= " months ago";
1706         } elsif ($age > 60*60*24*7*2) {
1707                 $age_str = int $age/60/60/24/7;
1708                 $age_str .= " weeks ago";
1709         } elsif ($age > 60*60*24*2) {
1710                 $age_str = int $age/60/60/24;
1711                 $age_str .= " days ago";
1712         } elsif ($age > 60*60*2) {
1713                 $age_str = int $age/60/60;
1714                 $age_str .= " hours ago";
1715         } elsif ($age > 60*2) {
1716                 $age_str = int $age/60;
1717                 $age_str .= " min ago";
1718         } elsif ($age > 2) {
1719                 $age_str = int $age;
1720                 $age_str .= " sec ago";
1721         } else {
1722                 $age_str .= " right now";
1723         }
1724         return $age_str;
1727 use constant {
1728         S_IFINVALID => 0030000,
1729         S_IFGITLINK => 0160000,
1730 };
1732 # submodule/subproject, a commit object reference
1733 sub S_ISGITLINK {
1734         my $mode = shift;
1736         return (($mode & S_IFMT) == S_IFGITLINK)
1739 # convert file mode in octal to symbolic file mode string
1740 sub mode_str {
1741         my $mode = oct shift;
1743         if (S_ISGITLINK($mode)) {
1744                 return 'm---------';
1745         } elsif (S_ISDIR($mode & S_IFMT)) {
1746                 return 'drwxr-xr-x';
1747         } elsif (S_ISLNK($mode)) {
1748                 return 'lrwxrwxrwx';
1749         } elsif (S_ISREG($mode)) {
1750                 # git cares only about the executable bit
1751                 if ($mode & S_IXUSR) {
1752                         return '-rwxr-xr-x';
1753                 } else {
1754                         return '-rw-r--r--';
1755                 };
1756         } else {
1757                 return '----------';
1758         }
1761 # convert file mode in octal to file type string
1762 sub file_type {
1763         my $mode = shift;
1765         if ($mode !~ m/^[0-7]+$/) {
1766                 return $mode;
1767         } else {
1768                 $mode = oct $mode;
1769         }
1771         if (S_ISGITLINK($mode)) {
1772                 return "submodule";
1773         } elsif (S_ISDIR($mode & S_IFMT)) {
1774                 return "directory";
1775         } elsif (S_ISLNK($mode)) {
1776                 return "symlink";
1777         } elsif (S_ISREG($mode)) {
1778                 return "file";
1779         } else {
1780                 return "unknown";
1781         }
1784 # convert file mode in octal to file type description string
1785 sub file_type_long {
1786         my $mode = shift;
1788         if ($mode !~ m/^[0-7]+$/) {
1789                 return $mode;
1790         } else {
1791                 $mode = oct $mode;
1792         }
1794         if (S_ISGITLINK($mode)) {
1795                 return "submodule";
1796         } elsif (S_ISDIR($mode & S_IFMT)) {
1797                 return "directory";
1798         } elsif (S_ISLNK($mode)) {
1799                 return "symlink";
1800         } elsif (S_ISREG($mode)) {
1801                 if ($mode & S_IXUSR) {
1802                         return "executable";
1803                 } else {
1804                         return "file";
1805                 };
1806         } else {
1807                 return "unknown";
1808         }
1812 ## ----------------------------------------------------------------------
1813 ## functions returning short HTML fragments, or transforming HTML fragments
1814 ## which don't belong to other sections
1816 # format line of commit message.
1817 sub format_log_line_html {
1818         my $line = shift;
1820         $line = esc_html($line, -nbsp=>1);
1821         $line =~ s{\b([0-9a-fA-F]{8,40})\b}{
1822                 $cgi->a({-href => href(action=>"object", hash=>$1),
1823                                         -class => "text"}, $1);
1824         }eg;
1826         return $line;
1829 # format marker of refs pointing to given object
1831 # the destination action is chosen based on object type and current context:
1832 # - for annotated tags, we choose the tag view unless it's the current view
1833 #   already, in which case we go to shortlog view
1834 # - for other refs, we keep the current view if we're in history, shortlog or
1835 #   log view, and select shortlog otherwise
1836 sub format_ref_marker {
1837         my ($refs, $id) = @_;
1838         my $markers = '';
1840         if (defined $refs->{$id}) {
1841                 foreach my $ref (@{$refs->{$id}}) {
1842                         # this code exploits the fact that non-lightweight tags are the
1843                         # only indirect objects, and that they are the only objects for which
1844                         # we want to use tag instead of shortlog as action
1845                         my ($type, $name) = qw();
1846                         my $indirect = ($ref =~ s/\^\{\}$//);
1847                         # e.g. tags/v2.6.11 or heads/next
1848                         if ($ref =~ m!^(.*?)s?/(.*)$!) {
1849                                 $type = $1;
1850                                 $name = $2;
1851                         } else {
1852                                 $type = "ref";
1853                                 $name = $ref;
1854                         }
1856                         my $class = $type;
1857                         $class .= " indirect" if $indirect;
1859                         my $dest_action = "shortlog";
1861                         if ($indirect) {
1862                                 $dest_action = "tag" unless $action eq "tag";
1863                         } elsif ($action =~ /^(history|(short)?log)$/) {
1864                                 $dest_action = $action;
1865                         }
1867                         my $dest = "";
1868                         $dest .= "refs/" unless $ref =~ m!^refs/!;
1869                         $dest .= $ref;
1871                         my $link = $cgi->a({
1872                                 -href => href(
1873                                         action=>$dest_action,
1874                                         hash=>$dest
1875                                 )}, $name);
1877                         $markers .= " <span class=\"".esc_attr($class)."\" title=\"".esc_attr($ref)."\">" .
1878                                 $link . "</span>";
1879                 }
1880         }
1882         if ($markers) {
1883                 return ' <span class="refs">'. $markers . '</span>';
1884         } else {
1885                 return "";
1886         }
1889 # format, perhaps shortened and with markers, title line
1890 sub format_subject_html {
1891         my ($long, $short, $href, $extra) = @_;
1892         $extra = '' unless defined($extra);
1894         if (length($short) < length($long)) {
1895                 $long =~ s/[[:cntrl:]]/?/g;
1896                 return $cgi->a({-href => $href, -class => "list subject",
1897                                 -title => to_utf8($long)},
1898                        esc_html($short)) . $extra;
1899         } else {
1900                 return $cgi->a({-href => $href, -class => "list subject"},
1901                        esc_html($long)) . $extra;
1902         }
1905 # Rather than recomputing the url for an email multiple times, we cache it
1906 # after the first hit. This gives a visible benefit in views where the avatar
1907 # for the same email is used repeatedly (e.g. shortlog).
1908 # The cache is shared by all avatar engines (currently gravatar only), which
1909 # are free to use it as preferred. Since only one avatar engine is used for any
1910 # given page, there's no risk for cache conflicts.
1911 our %avatar_cache = ();
1913 # Compute the picon url for a given email, by using the picon search service over at
1914 # http://www.cs.indiana.edu/picons/search.html
1915 sub picon_url {
1916         my $email = lc shift;
1917         if (!$avatar_cache{$email}) {
1918                 my ($user, $domain) = split('@', $email);
1919                 $avatar_cache{$email} =
1920                         "http://www.cs.indiana.edu/cgi-pub/kinzler/piconsearch.cgi/" .
1921                         "$domain/$user/" .
1922                         "users+domains+unknown/up/single";
1923         }
1924         return $avatar_cache{$email};
1927 # Compute the gravatar url for a given email, if it's not in the cache already.
1928 # Gravatar stores only the part of the URL before the size, since that's the
1929 # one computationally more expensive. This also allows reuse of the cache for
1930 # different sizes (for this particular engine).
1931 sub gravatar_url {
1932         my $email = lc shift;
1933         my $size = shift;
1934         $avatar_cache{$email} ||=
1935                 "http://www.gravatar.com/avatar/" .
1936                         Digest::MD5::md5_hex($email) . "?s=";
1937         return $avatar_cache{$email} . $size;
1940 # Insert an avatar for the given $email at the given $size if the feature
1941 # is enabled.
1942 sub git_get_avatar {
1943         my ($email, %opts) = @_;
1944         my $pre_white  = ($opts{-pad_before} ? "&nbsp;" : "");
1945         my $post_white = ($opts{-pad_after}  ? "&nbsp;" : "");
1946         $opts{-size} ||= 'default';
1947         my $size = $avatar_size{$opts{-size}} || $avatar_size{'default'};
1948         my $url = "";
1949         if ($git_avatar eq 'gravatar') {
1950                 $url = gravatar_url($email, $size);
1951         } elsif ($git_avatar eq 'picon') {
1952                 $url = picon_url($email);
1953         }
1954         # Other providers can be added by extending the if chain, defining $url
1955         # as needed. If no variant puts something in $url, we assume avatars
1956         # are completely disabled/unavailable.
1957         if ($url) {
1958                 return $pre_white .
1959                        "<img width=\"$size\" " .
1960                             "class=\"avatar\" " .
1961                             "src=\"".esc_url($url)."\" " .
1962                             "alt=\"\" " .
1963                        "/>" . $post_white;
1964         } else {
1965                 return "";
1966         }
1969 sub format_search_author {
1970         my ($author, $searchtype, $displaytext) = @_;
1971         my $have_search = gitweb_check_feature('search');
1973         if ($have_search) {
1974                 my $performed = "";
1975                 if ($searchtype eq 'author') {
1976                         $performed = "authored";
1977                 } elsif ($searchtype eq 'committer') {
1978                         $performed = "committed";
1979                 }
1981                 return $cgi->a({-href => href(action=>"search", hash=>$hash,
1982                                 searchtext=>$author,
1983                                 searchtype=>$searchtype), class=>"list",
1984                                 title=>"Search for commits $performed by $author"},
1985                                 $displaytext);
1987         } else {
1988                 return $displaytext;
1989         }
1992 # format the author name of the given commit with the given tag
1993 # the author name is chopped and escaped according to the other
1994 # optional parameters (see chop_str).
1995 sub format_author_html {
1996         my $tag = shift;
1997         my $co = shift;
1998         my $author = chop_and_escape_str($co->{'author_name'}, @_);
1999         return "<$tag class=\"author\">" .
2000                format_search_author($co->{'author_name'}, "author",
2001                        git_get_avatar($co->{'author_email'}, -pad_after => 1) .
2002                        $author) .
2003                "</$tag>";
2006 # format git diff header line, i.e. "diff --(git|combined|cc) ..."
2007 sub format_git_diff_header_line {
2008         my $line = shift;
2009         my $diffinfo = shift;
2010         my ($from, $to) = @_;
2012         if ($diffinfo->{'nparents'}) {
2013                 # combined diff
2014                 $line =~ s!^(diff (.*?) )"?.*$!$1!;
2015                 if ($to->{'href'}) {
2016                         $line .= $cgi->a({-href => $to->{'href'}, -class => "path"},
2017                                          esc_path($to->{'file'}));
2018                 } else { # file was deleted (no href)
2019                         $line .= esc_path($to->{'file'});
2020                 }
2021         } else {
2022                 # "ordinary" diff
2023                 $line =~ s!^(diff (.*?) )"?a/.*$!$1!;
2024                 if ($from->{'href'}) {
2025                         $line .= $cgi->a({-href => $from->{'href'}, -class => "path"},
2026                                          'a/' . esc_path($from->{'file'}));
2027                 } else { # file was added (no href)
2028                         $line .= 'a/' . esc_path($from->{'file'});
2029                 }
2030                 $line .= ' ';
2031                 if ($to->{'href'}) {
2032                         $line .= $cgi->a({-href => $to->{'href'}, -class => "path"},
2033                                          'b/' . esc_path($to->{'file'}));
2034                 } else { # file was deleted
2035                         $line .= 'b/' . esc_path($to->{'file'});
2036                 }
2037         }
2039         return "<div class=\"diff header\">$line</div>\n";
2042 # format extended diff header line, before patch itself
2043 sub format_extended_diff_header_line {
2044         my $line = shift;
2045         my $diffinfo = shift;
2046         my ($from, $to) = @_;
2048         # match <path>
2049         if ($line =~ s!^((copy|rename) from ).*$!$1! && $from->{'href'}) {
2050                 $line .= $cgi->a({-href=>$from->{'href'}, -class=>"path"},
2051                                        esc_path($from->{'file'}));
2052         }
2053         if ($line =~ s!^((copy|rename) to ).*$!$1! && $to->{'href'}) {
2054                 $line .= $cgi->a({-href=>$to->{'href'}, -class=>"path"},
2055                                  esc_path($to->{'file'}));
2056         }
2057         # match single <mode>
2058         if ($line =~ m/\s(\d{6})$/) {
2059                 $line .= '<span class="info"> (' .
2060                          file_type_long($1) .
2061                          ')</span>';
2062         }
2063         # match <hash>
2064         if ($line =~ m/^index [0-9a-fA-F]{40},[0-9a-fA-F]{40}/) {
2065                 # can match only for combined diff
2066                 $line = 'index ';
2067                 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
2068                         if ($from->{'href'}[$i]) {
2069                                 $line .= $cgi->a({-href=>$from->{'href'}[$i],
2070                                                   -class=>"hash"},
2071                                                  substr($diffinfo->{'from_id'}[$i],0,7));
2072                         } else {
2073                                 $line .= '0' x 7;
2074                         }
2075                         # separator
2076                         $line .= ',' if ($i < $diffinfo->{'nparents'} - 1);
2077                 }
2078                 $line .= '..';
2079                 if ($to->{'href'}) {
2080                         $line .= $cgi->a({-href=>$to->{'href'}, -class=>"hash"},
2081                                          substr($diffinfo->{'to_id'},0,7));
2082                 } else {
2083                         $line .= '0' x 7;
2084                 }
2086         } elsif ($line =~ m/^index [0-9a-fA-F]{40}..[0-9a-fA-F]{40}/) {
2087                 # can match only for ordinary diff
2088                 my ($from_link, $to_link);
2089                 if ($from->{'href'}) {
2090                         $from_link = $cgi->a({-href=>$from->{'href'}, -class=>"hash"},
2091                                              substr($diffinfo->{'from_id'},0,7));
2092                 } else {
2093                         $from_link = '0' x 7;
2094                 }
2095                 if ($to->{'href'}) {
2096                         $to_link = $cgi->a({-href=>$to->{'href'}, -class=>"hash"},
2097                                            substr($diffinfo->{'to_id'},0,7));
2098                 } else {
2099                         $to_link = '0' x 7;
2100                 }
2101                 my ($from_id, $to_id) = ($diffinfo->{'from_id'}, $diffinfo->{'to_id'});
2102                 $line =~ s!$from_id\.\.$to_id!$from_link..$to_link!;
2103         }
2105         return $line . "<br/>\n";
2108 # format from-file/to-file diff header
2109 sub format_diff_from_to_header {
2110         my ($from_line, $to_line, $diffinfo, $from, $to, @parents) = @_;
2111         my $line;
2112         my $result = '';
2114         $line = $from_line;
2115         #assert($line =~ m/^---/) if DEBUG;
2116         # no extra formatting for "^--- /dev/null"
2117         if (! $diffinfo->{'nparents'}) {
2118                 # ordinary (single parent) diff
2119                 if ($line =~ m!^--- "?a/!) {
2120                         if ($from->{'href'}) {
2121                                 $line = '--- a/' .
2122                                         $cgi->a({-href=>$from->{'href'}, -class=>"path"},
2123                                                 esc_path($from->{'file'}));
2124                         } else {
2125                                 $line = '--- a/' .
2126                                         esc_path($from->{'file'});
2127                         }
2128                 }
2129                 $result .= qq!<div class="diff from_file">$line</div>\n!;
2131         } else {
2132                 # combined diff (merge commit)
2133                 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
2134                         if ($from->{'href'}[$i]) {
2135                                 $line = '--- ' .
2136                                         $cgi->a({-href=>href(action=>"blobdiff",
2137                                                              hash_parent=>$diffinfo->{'from_id'}[$i],
2138                                                              hash_parent_base=>$parents[$i],
2139                                                              file_parent=>$from->{'file'}[$i],
2140                                                              hash=>$diffinfo->{'to_id'},
2141                                                              hash_base=>$hash,
2142                                                              file_name=>$to->{'file'}),
2143                                                  -class=>"path",
2144                                                  -title=>"diff" . ($i+1)},
2145                                                 $i+1) .
2146                                         '/' .
2147                                         $cgi->a({-href=>$from->{'href'}[$i], -class=>"path"},
2148                                                 esc_path($from->{'file'}[$i]));
2149                         } else {
2150                                 $line = '--- /dev/null';
2151                         }
2152                         $result .= qq!<div class="diff from_file">$line</div>\n!;
2153                 }
2154         }
2156         $line = $to_line;
2157         #assert($line =~ m/^\+\+\+/) if DEBUG;
2158         # no extra formatting for "^+++ /dev/null"
2159         if ($line =~ m!^\+\+\+ "?b/!) {
2160                 if ($to->{'href'}) {
2161                         $line = '+++ b/' .
2162                                 $cgi->a({-href=>$to->{'href'}, -class=>"path"},
2163                                         esc_path($to->{'file'}));
2164                 } else {
2165                         $line = '+++ b/' .
2166                                 esc_path($to->{'file'});
2167                 }
2168         }
2169         $result .= qq!<div class="diff to_file">$line</div>\n!;
2171         return $result;
2174 # create note for patch simplified by combined diff
2175 sub format_diff_cc_simplified {
2176         my ($diffinfo, @parents) = @_;
2177         my $result = '';
2179         $result .= "<div class=\"diff header\">" .
2180                    "diff --cc ";
2181         if (!is_deleted($diffinfo)) {
2182                 $result .= $cgi->a({-href => href(action=>"blob",
2183                                                   hash_base=>$hash,
2184                                                   hash=>$diffinfo->{'to_id'},
2185                                                   file_name=>$diffinfo->{'to_file'}),
2186                                     -class => "path"},
2187                                    esc_path($diffinfo->{'to_file'}));
2188         } else {
2189                 $result .= esc_path($diffinfo->{'to_file'});
2190         }
2191         $result .= "</div>\n" . # class="diff header"
2192                    "<div class=\"diff nodifferences\">" .
2193                    "Simple merge" .
2194                    "</div>\n"; # class="diff nodifferences"
2196         return $result;
2199 # format patch (diff) line (not to be used for diff headers)
2200 sub format_diff_line {
2201         my $line = shift;
2202         my ($from, $to) = @_;
2203         my $diff_class = "";
2205         chomp $line;
2207         if ($from && $to && ref($from->{'href'}) eq "ARRAY") {
2208                 # combined diff
2209                 my $prefix = substr($line, 0, scalar @{$from->{'href'}});
2210                 if ($line =~ m/^\@{3}/) {
2211                         $diff_class = " chunk_header";
2212                 } elsif ($line =~ m/^\\/) {
2213                         $diff_class = " incomplete";
2214                 } elsif ($prefix =~ tr/+/+/) {
2215                         $diff_class = " add";
2216                 } elsif ($prefix =~ tr/-/-/) {
2217                         $diff_class = " rem";
2218                 }
2219         } else {
2220                 # assume ordinary diff
2221                 my $char = substr($line, 0, 1);
2222                 if ($char eq '+') {
2223                         $diff_class = " add";
2224                 } elsif ($char eq '-') {
2225                         $diff_class = " rem";
2226                 } elsif ($char eq '@') {
2227                         $diff_class = " chunk_header";
2228                 } elsif ($char eq "\\") {
2229                         $diff_class = " incomplete";
2230                 }
2231         }
2232         $line = untabify($line);
2233         if ($from && $to && $line =~ m/^\@{2} /) {
2234                 my ($from_text, $from_start, $from_lines, $to_text, $to_start, $to_lines, $section) =
2235                         $line =~ m/^\@{2} (-(\d+)(?:,(\d+))?) (\+(\d+)(?:,(\d+))?) \@{2}(.*)$/;
2237                 $from_lines = 0 unless defined $from_lines;
2238                 $to_lines   = 0 unless defined $to_lines;
2240                 if ($from->{'href'}) {
2241                         $from_text = $cgi->a({-href=>"$from->{'href'}#l$from_start",
2242                                              -class=>"list"}, $from_text);
2243                 }
2244                 if ($to->{'href'}) {
2245                         $to_text   = $cgi->a({-href=>"$to->{'href'}#l$to_start",
2246                                              -class=>"list"}, $to_text);
2247                 }
2248                 $line = "<span class=\"chunk_info\">@@ $from_text $to_text @@</span>" .
2249                         "<span class=\"section\">" . esc_html($section, -nbsp=>1) . "</span>";
2250                 return "<div class=\"diff$diff_class\">$line</div>\n";
2251         } elsif ($from && $to && $line =~ m/^\@{3}/) {
2252                 my ($prefix, $ranges, $section) = $line =~ m/^(\@+) (.*?) \@+(.*)$/;
2253                 my (@from_text, @from_start, @from_nlines, $to_text, $to_start, $to_nlines);
2255                 @from_text = split(' ', $ranges);
2256                 for (my $i = 0; $i < @from_text; ++$i) {
2257                         ($from_start[$i], $from_nlines[$i]) =
2258                                 (split(',', substr($from_text[$i], 1)), 0);
2259                 }
2261                 $to_text   = pop @from_text;
2262                 $to_start  = pop @from_start;
2263                 $to_nlines = pop @from_nlines;
2265                 $line = "<span class=\"chunk_info\">$prefix ";
2266                 for (my $i = 0; $i < @from_text; ++$i) {
2267                         if ($from->{'href'}[$i]) {
2268                                 $line .= $cgi->a({-href=>"$from->{'href'}[$i]#l$from_start[$i]",
2269                                                   -class=>"list"}, $from_text[$i]);
2270                         } else {
2271                                 $line .= $from_text[$i];
2272                         }
2273                         $line .= " ";
2274                 }
2275                 if ($to->{'href'}) {
2276                         $line .= $cgi->a({-href=>"$to->{'href'}#l$to_start",
2277                                           -class=>"list"}, $to_text);
2278                 } else {
2279                         $line .= $to_text;
2280                 }
2281                 $line .= " $prefix</span>" .
2282                          "<span class=\"section\">" . esc_html($section, -nbsp=>1) . "</span>";
2283                 return "<div class=\"diff$diff_class\">$line</div>\n";
2284         }
2285         return "<div class=\"diff$diff_class\">" . esc_html($line, -nbsp=>1) . "</div>\n";
2288 # Generates undef or something like "_snapshot_" or "snapshot (_tbz2_ _zip_)",
2289 # linked.  Pass the hash of the tree/commit to snapshot.
2290 sub format_snapshot_links {
2291         my ($hash) = @_;
2292         my $num_fmts = @snapshot_fmts;
2293         if ($num_fmts > 1) {
2294                 # A parenthesized list of links bearing format names.
2295                 # e.g. "snapshot (_tar.gz_ _zip_)"
2296                 return "snapshot (" . join(' ', map
2297                         $cgi->a({
2298                                 -href => href(
2299                                         action=>"snapshot",
2300                                         hash=>$hash,
2301                                         snapshot_format=>$_
2302                                 )
2303                         }, $known_snapshot_formats{$_}{'display'})
2304                 , @snapshot_fmts) . ")";
2305         } elsif ($num_fmts == 1) {
2306                 # A single "snapshot" link whose tooltip bears the format name.
2307                 # i.e. "_snapshot_"
2308                 my ($fmt) = @snapshot_fmts;
2309                 return
2310                         $cgi->a({
2311                                 -href => href(
2312                                         action=>"snapshot",
2313                                         hash=>$hash,
2314                                         snapshot_format=>$fmt
2315                                 ),
2316                                 -title => "in format: $known_snapshot_formats{$fmt}{'display'}"
2317                         }, "snapshot");
2318         } else { # $num_fmts == 0
2319                 return undef;
2320         }
2323 ## ......................................................................
2324 ## functions returning values to be passed, perhaps after some
2325 ## transformation, to other functions; e.g. returning arguments to href()
2327 # returns hash to be passed to href to generate gitweb URL
2328 # in -title key it returns description of link
2329 sub get_feed_info {
2330         my $format = shift || 'Atom';
2331         my %res = (action => lc($format));
2333         # feed links are possible only for project views
2334         return unless (defined $project);
2335         # some views should link to OPML, or to generic project feed,
2336         # or don't have specific feed yet (so they should use generic)
2337         return if ($action =~ /^(?:tags|heads|forks|tag|search)$/x);
2339         my $branch;
2340         # branches refs uses 'refs/heads/' prefix (fullname) to differentiate
2341         # from tag links; this also makes possible to detect branch links
2342         if ((defined $hash_base && $hash_base =~ m!^refs/heads/(.*)$!) ||
2343             (defined $hash      && $hash      =~ m!^refs/heads/(.*)$!)) {
2344                 $branch = $1;
2345         }
2346         # find log type for feed description (title)
2347         my $type = 'log';
2348         if (defined $file_name) {
2349                 $type  = "history of $file_name";
2350                 $type .= "/" if ($action eq 'tree');
2351                 $type .= " on '$branch'" if (defined $branch);
2352         } else {
2353                 $type = "log of $branch" if (defined $branch);
2354         }
2356         $res{-title} = $type;
2357         $res{'hash'} = (defined $branch ? "refs/heads/$branch" : undef);
2358         $res{'file_name'} = $file_name;
2360         return %res;
2363 ## ----------------------------------------------------------------------
2364 ## git utility subroutines, invoking git commands
2366 # returns path to the core git executable and the --git-dir parameter as list
2367 sub git_cmd {
2368         $number_of_git_cmds++;
2369         return $GIT, '--git-dir='.$git_dir;
2372 # quote the given arguments for passing them to the shell
2373 # quote_command("command", "arg 1", "arg with ' and ! characters")
2374 # => "'command' 'arg 1' 'arg with '\'' and '\!' characters'"
2375 # Try to avoid using this function wherever possible.
2376 sub quote_command {
2377         return join(' ',
2378                 map { my $a = $_; $a =~ s/(['!])/'\\$1'/g; "'$a'" } @_ );
2381 # get HEAD ref of given project as hash
2382 sub git_get_head_hash {
2383         return git_get_full_hash(shift, 'HEAD');
2386 sub git_get_full_hash {
2387         return git_get_hash(@_);
2390 sub git_get_short_hash {
2391         return git_get_hash(@_, '--short=7');
2394 sub git_get_hash {
2395         my ($project, $hash, @options) = @_;
2396         my $o_git_dir = $git_dir;
2397         my $retval = undef;
2398         $git_dir = "$projectroot/$project";
2399         if (open my $fd, '-|', git_cmd(), 'rev-parse',
2400             '--verify', '-q', @options, $hash) {
2401                 $retval = <$fd>;
2402                 chomp $retval if defined $retval;
2403                 close $fd;
2404         }
2405         if (defined $o_git_dir) {
2406                 $git_dir = $o_git_dir;
2407         }
2408         return $retval;
2411 # get type of given object
2412 sub git_get_type {
2413         my $hash = shift;
2415         open my $fd, "-|", git_cmd(), "cat-file", '-t', $hash or return;
2416         my $type = <$fd>;
2417         close $fd or return;
2418         chomp $type;
2419         return $type;
2422 # repository configuration
2423 our $config_file = '';
2424 our %config;
2426 # store multiple values for single key as anonymous array reference
2427 # single values stored directly in the hash, not as [ <value> ]
2428 sub hash_set_multi {
2429         my ($hash, $key, $value) = @_;
2431         if (!exists $hash->{$key}) {
2432                 $hash->{$key} = $value;
2433         } elsif (!ref $hash->{$key}) {
2434                 $hash->{$key} = [ $hash->{$key}, $value ];
2435         } else {
2436                 push @{$hash->{$key}}, $value;
2437         }
2440 # return hash of git project configuration
2441 # optionally limited to some section, e.g. 'gitweb'
2442 sub git_parse_project_config {
2443         my $section_regexp = shift;
2444         my %config;
2446         local $/ = "\0";
2448         open my $fh, "-|", git_cmd(), "config", '-z', '-l',
2449                 or return;
2451         while (my $keyval = <$fh>) {
2452                 chomp $keyval;
2453                 my ($key, $value) = split(/\n/, $keyval, 2);
2455                 hash_set_multi(\%config, $key, $value)
2456                         if (!defined $section_regexp || $key =~ /^(?:$section_regexp)\./o);
2457         }
2458         close $fh;
2460         return %config;
2463 # convert config value to boolean: 'true' or 'false'
2464 # no value, number > 0, 'true' and 'yes' values are true
2465 # rest of values are treated as false (never as error)
2466 sub config_to_bool {
2467         my $val = shift;
2469         return 1 if !defined $val;             # section.key
2471         # strip leading and trailing whitespace
2472         $val =~ s/^\s+//;
2473         $val =~ s/\s+$//;
2475         return (($val =~ /^\d+$/ && $val) ||   # section.key = 1
2476                 ($val =~ /^(?:true|yes)$/i));  # section.key = true
2479 # convert config value to simple decimal number
2480 # an optional value suffix of 'k', 'm', or 'g' will cause the value
2481 # to be multiplied by 1024, 1048576, or 1073741824
2482 sub config_to_int {
2483         my $val = shift;
2485         # strip leading and trailing whitespace
2486         $val =~ s/^\s+//;
2487         $val =~ s/\s+$//;
2489         if (my ($num, $unit) = ($val =~ /^([0-9]*)([kmg])$/i)) {
2490                 $unit = lc($unit);
2491                 # unknown unit is treated as 1
2492                 return $num * ($unit eq 'g' ? 1073741824 :
2493                                $unit eq 'm' ?    1048576 :
2494                                $unit eq 'k' ?       1024 : 1);
2495         }
2496         return $val;
2499 # convert config value to array reference, if needed
2500 sub config_to_multi {
2501         my $val = shift;
2503         return ref($val) ? $val : (defined($val) ? [ $val ] : []);
2506 sub git_get_project_config {
2507         my ($key, $type) = @_;
2509         return unless defined $git_dir;
2511         # key sanity check
2512         return unless ($key);
2513         $key =~ s/^gitweb\.//;
2514         return if ($key =~ m/\W/);
2516         # type sanity check
2517         if (defined $type) {
2518                 $type =~ s/^--//;
2519                 $type = undef
2520                         unless ($type eq 'bool' || $type eq 'int');
2521         }
2523         # get config
2524         if (!defined $config_file ||
2525             $config_file ne "$git_dir/config") {
2526                 %config = git_parse_project_config('gitweb');
2527                 $config_file = "$git_dir/config";
2528         }
2530         # check if config variable (key) exists
2531         return unless exists $config{"gitweb.$key"};
2533         # ensure given type
2534         if (!defined $type) {
2535                 return $config{"gitweb.$key"};
2536         } elsif ($type eq 'bool') {
2537                 # backward compatibility: 'git config --bool' returns true/false
2538                 return config_to_bool($config{"gitweb.$key"}) ? 'true' : 'false';
2539         } elsif ($type eq 'int') {
2540                 return config_to_int($config{"gitweb.$key"});
2541         }
2542         return $config{"gitweb.$key"};
2545 # get hash of given path at given ref
2546 sub git_get_hash_by_path {
2547         my $base = shift;
2548         my $path = shift || return undef;
2549         my $type = shift;
2551         $path =~ s,/+$,,;
2553         open my $fd, "-|", git_cmd(), "ls-tree", $base, "--", $path
2554                 or die_error(500, "Open git-ls-tree failed");
2555         my $line = <$fd>;
2556         close $fd or return undef;
2558         if (!defined $line) {
2559                 # there is no tree or hash given by $path at $base
2560                 return undef;
2561         }
2563         #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa  panic.c'
2564         $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t/;
2565         if (defined $type && $type ne $2) {
2566                 # type doesn't match
2567                 return undef;
2568         }
2569         return $3;
2572 # get path of entry with given hash at given tree-ish (ref)
2573 # used to get 'from' filename for combined diff (merge commit) for renames
2574 sub git_get_path_by_hash {
2575         my $base = shift || return;
2576         my $hash = shift || return;
2578         local $/ = "\0";
2580         open my $fd, "-|", git_cmd(), "ls-tree", '-r', '-t', '-z', $base
2581                 or return undef;
2582         while (my $line = <$fd>) {
2583                 chomp $line;
2585                 #'040000 tree 595596a6a9117ddba9fe379b6b012b558bac8423  gitweb'
2586                 #'100644 blob e02e90f0429be0d2a69b76571101f20b8f75530f  gitweb/README'
2587                 if ($line =~ m/(?:[0-9]+) (?:.+) $hash\t(.+)$/) {
2588                         close $fd;
2589                         return $1;
2590                 }
2591         }
2592         close $fd;
2593         return undef;
2596 ## ......................................................................
2597 ## git utility functions, directly accessing git repository
2599 # get the value of config variable either from file named as the variable
2600 # itself in the repository ($GIT_DIR/$name file), or from gitweb.$name
2601 # configuration variable in the repository config file.
2602 sub git_get_file_or_project_config {
2603         my ($path, $name) = @_;
2605         $git_dir = "$projectroot/$path";
2606         open my $fd, '<', "$git_dir/$name"
2607                 or return git_get_project_config($name);
2608         my $conf = <$fd>;
2609         close $fd;
2610         if (defined $conf) {
2611                 chomp $conf;
2612         }
2613         return $conf;
2616 sub git_get_project_description {
2617         my $path = shift;
2618         return git_get_file_or_project_config($path, 'description');
2621 sub git_get_project_category {
2622         my $path = shift;
2623         return git_get_file_or_project_config($path, 'category');
2627 # supported formats:
2628 # * $GIT_DIR/ctags/<tagname> file (in 'ctags' subdirectory)
2629 #   - if its contents is a number, use it as tag weight,
2630 #   - otherwise add a tag with weight 1
2631 # * $GIT_DIR/ctags file, each line is a tag (with weight 1)
2632 #   the same value multiple times increases tag weight
2633 # * `gitweb.ctag' multi-valued repo config variable
2634 sub git_get_project_ctags {
2635         my $project = shift;
2636         my $ctags = {};
2638         $git_dir = "$projectroot/$project";
2639         if (opendir my $dh, "$git_dir/ctags") {
2640                 my @files = grep { -f $_ } map { "$git_dir/ctags/$_" } readdir($dh);
2641                 foreach my $tagfile (@files) {
2642                         open my $ct, '<', $tagfile
2643                                 or next;
2644                         my $val = <$ct>;
2645                         chomp $val if $val;
2646                         close $ct;
2648                         (my $ctag = $tagfile) =~ s#.*/##;
2649                         if ($val =~ /^\d+$/) {
2650                                 $ctags->{$ctag} = $val;
2651                         } else {
2652                                 $ctags->{$ctag} = 1;
2653                         }
2654                 }
2655                 closedir $dh;
2657         } elsif (open my $fh, '<', "$git_dir/ctags") {
2658                 while (my $line = <$fh>) {
2659                         chomp $line;
2660                         $ctags->{$line}++ if $line;
2661                 }
2662                 close $fh;
2664         } else {
2665                 my $taglist = config_to_multi(git_get_project_config('ctag'));
2666                 foreach my $tag (@$taglist) {
2667                         $ctags->{$tag}++;
2668                 }
2669         }
2671         return $ctags;
2674 # return hash, where keys are content tags ('ctags'),
2675 # and values are sum of weights of given tag in every project
2676 sub git_gather_all_ctags {
2677         my $projects = shift;
2678         my $ctags = {};
2680         foreach my $p (@$projects) {
2681                 foreach my $ct (keys %{$p->{'ctags'}}) {
2682                         $ctags->{$ct} += $p->{'ctags'}->{$ct};
2683                 }
2684         }
2686         return $ctags;
2689 sub git_populate_project_tagcloud {
2690         my $ctags = shift;
2692         # First, merge different-cased tags; tags vote on casing
2693         my %ctags_lc;
2694         foreach (keys %$ctags) {
2695                 $ctags_lc{lc $_}->{count} += $ctags->{$_};
2696                 if (not $ctags_lc{lc $_}->{topcount}
2697                     or $ctags_lc{lc $_}->{topcount} < $ctags->{$_}) {
2698                         $ctags_lc{lc $_}->{topcount} = $ctags->{$_};
2699                         $ctags_lc{lc $_}->{topname} = $_;
2700                 }
2701         }
2703         my $cloud;
2704         my $matched = $cgi->param('by_tag');
2705         if (eval { require HTML::TagCloud; 1; }) {
2706                 $cloud = HTML::TagCloud->new;
2707                 foreach my $ctag (sort keys %ctags_lc) {
2708                         # Pad the title with spaces so that the cloud looks
2709                         # less crammed.
2710                         my $title = esc_html($ctags_lc{$ctag}->{topname});
2711                         $title =~ s/ /&nbsp;/g;
2712                         $title =~ s/^/&nbsp;/g;
2713                         $title =~ s/$/&nbsp;/g;
2714                         if (defined $matched && $matched eq $ctag) {
2715                                 $title = qq(<span class="match">$title</span>);
2716                         }
2717                         $cloud->add($title, href(project=>undef, ctag=>$ctag),
2718                                     $ctags_lc{$ctag}->{count});
2719                 }
2720         } else {
2721                 $cloud = {};
2722                 foreach my $ctag (keys %ctags_lc) {
2723                         my $title = esc_html($ctags_lc{$ctag}->{topname}, -nbsp=>1);
2724                         if (defined $matched && $matched eq $ctag) {
2725                                 $title = qq(<span class="match">$title</span>);
2726                         }
2727                         $cloud->{$ctag}{count} = $ctags_lc{$ctag}->{count};
2728                         $cloud->{$ctag}{ctag} =
2729                                 $cgi->a({-href=>href(project=>undef, ctag=>$ctag)}, $title);
2730                 }
2731         }
2732         return $cloud;
2735 sub git_show_project_tagcloud {
2736         my ($cloud, $count) = @_;
2737         if (ref $cloud eq 'HTML::TagCloud') {
2738                 return $cloud->html_and_css($count);
2739         } else {
2740                 my @tags = sort { $cloud->{$a}->{'count'} <=> $cloud->{$b}->{'count'} } keys %$cloud;
2741                 return
2742                         '<div id="htmltagcloud"'.($project ? '' : ' align="center"').'>' .
2743                         join (', ', map {
2744                                 $cloud->{$_}->{'ctag'}
2745                         } splice(@tags, 0, $count)) .
2746                         '</div>';
2747         }
2750 sub git_get_project_url_list {
2751         my $path = shift;
2753         $git_dir = "$projectroot/$path";
2754         open my $fd, '<', "$git_dir/cloneurl"
2755                 or return wantarray ?
2756                 @{ config_to_multi(git_get_project_config('url')) } :
2757                    config_to_multi(git_get_project_config('url'));
2758         my @git_project_url_list = map { chomp; $_ } <$fd>;
2759         close $fd;
2761         return wantarray ? @git_project_url_list : \@git_project_url_list;
2764 sub git_get_projects_list {
2765         my $filter = shift || '';
2766         my @list;
2768         $filter =~ s/\.git$//;
2770         if (-d $projects_list) {
2771                 # search in directory
2772                 my $dir = $projects_list;
2773                 # remove the trailing "/"
2774                 $dir =~ s!/+$!!;
2775                 my $pfxlen = length("$projects_list");
2776                 my $pfxdepth = ($projects_list =~ tr!/!!);
2777                 # when filtering, search only given subdirectory
2778                 if ($filter) {
2779                         $dir .= "/$filter";
2780                         $dir =~ s!/+$!!;
2781                 }
2783                 File::Find::find({
2784                         follow_fast => 1, # follow symbolic links
2785                         follow_skip => 2, # ignore duplicates
2786                         dangling_symlinks => 0, # ignore dangling symlinks, silently
2787                         wanted => sub {
2788                                 # global variables
2789                                 our $project_maxdepth;
2790                                 our $projectroot;
2791                                 # skip project-list toplevel, if we get it.
2792                                 return if (m!^[/.]$!);
2793                                 # only directories can be git repositories
2794                                 return unless (-d $_);
2795                                 # don't traverse too deep (Find is super slow on os x)
2796                                 # $project_maxdepth excludes depth of $projectroot
2797                                 if (($File::Find::name =~ tr!/!!) - $pfxdepth > $project_maxdepth) {
2798                                         $File::Find::prune = 1;
2799                                         return;
2800                                 }
2802                                 my $path = substr($File::Find::name, $pfxlen + 1);
2803                                 # we check related file in $projectroot
2804                                 if (check_export_ok("$projectroot/$path")) {
2805                                         push @list, { path => $path };
2806                                         $File::Find::prune = 1;
2807                                 }
2808                         },
2809                 }, "$dir");
2811         } elsif (-f $projects_list) {
2812                 # read from file(url-encoded):
2813                 # 'git%2Fgit.git Linus+Torvalds'
2814                 # 'libs%2Fklibc%2Fklibc.git H.+Peter+Anvin'
2815                 # 'linux%2Fhotplug%2Fudev.git Greg+Kroah-Hartman'
2816                 open my $fd, '<', $projects_list or return;
2817         PROJECT:
2818                 while (my $line = <$fd>) {
2819                         chomp $line;
2820                         my ($path, $owner) = split ' ', $line;
2821                         $path = unescape($path);
2822                         $owner = unescape($owner);
2823                         if (!defined $path) {
2824                                 next;
2825                         }
2826                         # if $filter is rpovided, check if $path begins with $filter
2827                         if ($filter && $path !~ m!^\Q$filter\E/!) {
2828                                 next;
2829                         }
2830                         if (check_export_ok("$projectroot/$path")) {
2831                                 my $pr = {
2832                                         path => $path,
2833                                         owner => to_utf8($owner),
2834                                 };
2835                                 push @list, $pr;
2836                         }
2837                 }
2838                 close $fd;
2839         }
2840         return @list;
2843 # written with help of Tree::Trie module (Perl Artistic License, GPL compatibile)
2844 # as side effects it sets 'forks' field to list of forks for forked projects
2845 sub filter_forks_from_projects_list {
2846         my $projects = shift;
2848         my %trie; # prefix tree of directories (path components)
2849         # generate trie out of those directories that might contain forks
2850         foreach my $pr (@$projects) {
2851                 my $path = $pr->{'path'};
2852                 $path =~ s/\.git$//;      # forks of 'repo.git' are in 'repo/' directory
2853                 next if ($path =~ m!/$!); # skip non-bare repositories, e.g. 'repo/.git'
2854                 next unless ($path);      # skip '.git' repository: tests, git-instaweb
2855                 next unless (-d $path);   # containing directory exists
2856                 $pr->{'forks'} = [];      # there can be 0 or more forks of project
2858                 # add to trie
2859                 my @dirs = split('/', $path);
2860                 # walk the trie, until either runs out of components or out of trie
2861                 my $ref = \%trie;
2862                 while (scalar @dirs &&
2863                        exists($ref->{$dirs[0]})) {
2864                         $ref = $ref->{shift @dirs};
2865                 }
2866                 # create rest of trie structure from rest of components
2867                 foreach my $dir (@dirs) {
2868                         $ref = $ref->{$dir} = {};
2869                 }
2870                 # create end marker, store $pr as a data
2871                 $ref->{''} = $pr if (!exists $ref->{''});
2872         }
2874         # filter out forks, by finding shortest prefix match for paths
2875         my @filtered;
2876  PROJECT:
2877         foreach my $pr (@$projects) {
2878                 # trie lookup
2879                 my $ref = \%trie;
2880         DIR:
2881                 foreach my $dir (split('/', $pr->{'path'})) {
2882                         if (exists $ref->{''}) {
2883                                 # found [shortest] prefix, is a fork - skip it
2884                                 push @{$ref->{''}{'forks'}}, $pr;
2885                                 next PROJECT;
2886                         }
2887                         if (!exists $ref->{$dir}) {
2888                                 # not in trie, cannot have prefix, not a fork
2889                                 push @filtered, $pr;
2890                                 next PROJECT;
2891                         }
2892                         # If the dir is there, we just walk one step down the trie.
2893                         $ref = $ref->{$dir};
2894                 }
2895                 # we ran out of trie
2896                 # (shouldn't happen: it's either no match, or end marker)
2897                 push @filtered, $pr;
2898         }
2900         return @filtered;
2903 # note: fill_project_list_info must be run first,
2904 # for 'descr_long' and 'ctags' to be filled
2905 sub search_projects_list {
2906         my ($projlist, %opts) = @_;
2907         my $tagfilter  = $opts{'tagfilter'};
2908         my $searchtext = $opts{'searchtext'};
2910         return @$projlist
2911                 unless ($tagfilter || $searchtext);
2913         my @projects;
2914  PROJECT:
2915         foreach my $pr (@$projlist) {
2917                 if ($tagfilter) {
2918                         next unless ref($pr->{'ctags'}) eq 'HASH';
2919                         next unless
2920                                 grep { lc($_) eq lc($tagfilter) } keys %{$pr->{'ctags'}};
2921                 }
2923                 if ($searchtext) {
2924                         next unless
2925                                 $pr->{'path'} =~ /$searchtext/ ||
2926                                 $pr->{'descr_long'} =~ /$searchtext/;
2927                 }
2929                 push @projects, $pr;
2930         }
2932         return @projects;
2935 our $gitweb_project_owner = undef;
2936 sub git_get_project_list_from_file {
2938         return if (defined $gitweb_project_owner);
2940         $gitweb_project_owner = {};
2941         # read from file (url-encoded):
2942         # 'git%2Fgit.git Linus+Torvalds'
2943         # 'libs%2Fklibc%2Fklibc.git H.+Peter+Anvin'
2944         # 'linux%2Fhotplug%2Fudev.git Greg+Kroah-Hartman'
2945         if (-f $projects_list) {
2946                 open(my $fd, '<', $projects_list);
2947                 while (my $line = <$fd>) {
2948                         chomp $line;
2949                         my ($pr, $ow) = split ' ', $line;
2950                         $pr = unescape($pr);
2951                         $ow = unescape($ow);
2952                         $gitweb_project_owner->{$pr} = to_utf8($ow);
2953                 }
2954                 close $fd;
2955         }
2958 sub git_get_project_owner {
2959         my $project = shift;
2960         my $owner;
2962         return undef unless $project;
2963         $git_dir = "$projectroot/$project";
2965         if (!defined $gitweb_project_owner) {
2966                 git_get_project_list_from_file();
2967         }
2969         if (exists $gitweb_project_owner->{$project}) {
2970                 $owner = $gitweb_project_owner->{$project};
2971         }
2972         if (!defined $owner){
2973                 $owner = git_get_project_config('owner');
2974         }
2975         if (!defined $owner) {
2976                 $owner = get_file_owner("$git_dir");
2977         }
2979         return $owner;
2982 sub git_get_last_activity {
2983         my ($path) = @_;
2984         my $fd;
2986         $git_dir = "$projectroot/$path";
2987         open($fd, "-|", git_cmd(), 'for-each-ref',
2988              '--format=%(committer)',
2989              '--sort=-committerdate',
2990              '--count=1',
2991              'refs/heads') or return;
2992         my $most_recent = <$fd>;
2993         close $fd or return;
2994         if (defined $most_recent &&
2995             $most_recent =~ / (\d+) [-+][01]\d\d\d$/) {
2996                 my $timestamp = $1;
2997                 my $age = time - $timestamp;
2998                 return ($age, age_string($age));
2999         }
3000         return (undef, undef);
3003 # Implementation note: when a single remote is wanted, we cannot use 'git
3004 # remote show -n' because that command always work (assuming it's a remote URL
3005 # if it's not defined), and we cannot use 'git remote show' because that would
3006 # try to make a network roundtrip. So the only way to find if that particular
3007 # remote is defined is to walk the list provided by 'git remote -v' and stop if
3008 # and when we find what we want.
3009 sub git_get_remotes_list {
3010         my $wanted = shift;
3011         my %remotes = ();
3013         open my $fd, '-|' , git_cmd(), 'remote', '-v';
3014         return unless $fd;
3015         while (my $remote = <$fd>) {
3016                 chomp $remote;
3017                 $remote =~ s!\t(.*?)\s+\((\w+)\)$!!;
3018                 next if $wanted and not $remote eq $wanted;
3019                 my ($url, $key) = ($1, $2);
3021                 $remotes{$remote} ||= { 'heads' => () };
3022                 $remotes{$remote}{$key} = $url;
3023         }
3024         close $fd or return;
3025         return wantarray ? %remotes : \%remotes;
3028 # Takes a hash of remotes as first parameter and fills it by adding the
3029 # available remote heads for each of the indicated remotes.
3030 sub fill_remote_heads {
3031         my $remotes = shift;
3032         my @heads = map { "remotes/$_" } keys %$remotes;
3033         my @remoteheads = git_get_heads_list(undef, @heads);
3034         foreach my $remote (keys %$remotes) {
3035                 $remotes->{$remote}{'heads'} = [ grep {
3036                         $_->{'name'} =~ s!^$remote/!!
3037                         } @remoteheads ];
3038         }
3041 sub git_get_references {
3042         my $type = shift || "";
3043         my %refs;
3044         # 5dc01c595e6c6ec9ccda4f6f69c131c0dd945f8c refs/tags/v2.6.11
3045         # c39ae07f393806ccf406ef966e9a15afc43cc36a refs/tags/v2.6.11^{}
3046         open my $fd, "-|", git_cmd(), "show-ref", "--dereference",
3047                 ($type ? ("--", "refs/$type") : ()) # use -- <pattern> if $type
3048                 or return;
3050         while (my $line = <$fd>) {
3051                 chomp $line;
3052                 if ($line =~ m!^([0-9a-fA-F]{40})\srefs/($type.*)$!) {
3053                         if (defined $refs{$1}) {
3054                                 push @{$refs{$1}}, $2;
3055                         } else {
3056                                 $refs{$1} = [ $2 ];
3057                         }
3058                 }
3059         }
3060         close $fd or return;
3061         return \%refs;
3064 sub git_get_rev_name_tags {
3065         my $hash = shift || return undef;
3067         open my $fd, "-|", git_cmd(), "name-rev", "--tags", $hash
3068                 or return;
3069         my $name_rev = <$fd>;
3070         close $fd;
3072         if ($name_rev =~ m|^$hash tags/(.*)$|) {
3073                 return $1;
3074         } else {
3075                 # catches also '$hash undefined' output
3076                 return undef;
3077         }
3080 ## ----------------------------------------------------------------------
3081 ## parse to hash functions
3083 sub parse_date {
3084         my $epoch = shift;
3085         my $tz = shift || "-0000";
3087         my %date;
3088         my @months = ("Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec");
3089         my @days = ("Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat");
3090         my ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($epoch);
3091         $date{'hour'} = $hour;
3092         $date{'minute'} = $min;
3093         $date{'mday'} = $mday;
3094         $date{'day'} = $days[$wday];
3095         $date{'month'} = $months[$mon];
3096         $date{'rfc2822'}   = sprintf "%s, %d %s %4d %02d:%02d:%02d +0000",
3097                              $days[$wday], $mday, $months[$mon], 1900+$year, $hour ,$min, $sec;
3098         $date{'mday-time'} = sprintf "%d %s %02d:%02d",
3099                              $mday, $months[$mon], $hour ,$min;
3100         $date{'iso-8601'}  = sprintf "%04d-%02d-%02dT%02d:%02d:%02dZ",
3101                              1900+$year, 1+$mon, $mday, $hour ,$min, $sec;
3103         my ($tz_sign, $tz_hour, $tz_min) =
3104                 ($tz =~ m/^([-+])(\d\d)(\d\d)$/);
3105         $tz_sign = ($tz_sign eq '-' ? -1 : +1);
3106         my $local = $epoch + $tz_sign*((($tz_hour*60) + $tz_min)*60);
3107         ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($local);
3108         $date{'hour_local'} = $hour;
3109         $date{'minute_local'} = $min;
3110         $date{'tz_local'} = $tz;
3111         $date{'iso-tz'} = sprintf("%04d-%02d-%02d %02d:%02d:%02d %s",
3112                                   1900+$year, $mon+1, $mday,
3113                                   $hour, $min, $sec, $tz);
3114         return %date;
3117 sub parse_tag {
3118         my $tag_id = shift;
3119         my %tag;
3120         my @comment;
3122         open my $fd, "-|", git_cmd(), "cat-file", "tag", $tag_id or return;
3123         $tag{'id'} = $tag_id;
3124         while (my $line = <$fd>) {
3125                 chomp $line;
3126                 if ($line =~ m/^object ([0-9a-fA-F]{40})$/) {
3127                         $tag{'object'} = $1;
3128                 } elsif ($line =~ m/^type (.+)$/) {
3129                         $tag{'type'} = $1;
3130                 } elsif ($line =~ m/^tag (.+)$/) {
3131                         $tag{'name'} = $1;
3132                 } elsif ($line =~ m/^tagger (.*) ([0-9]+) (.*)$/) {
3133                         $tag{'author'} = $1;
3134                         $tag{'author_epoch'} = $2;
3135                         $tag{'author_tz'} = $3;
3136                         if ($tag{'author'} =~ m/^([^<]+) <([^>]*)>/) {
3137                                 $tag{'author_name'}  = $1;
3138                                 $tag{'author_email'} = $2;
3139                         } else {
3140                                 $tag{'author_name'} = $tag{'author'};
3141                         }
3142                 } elsif ($line =~ m/--BEGIN/) {
3143                         push @comment, $line;
3144                         last;
3145                 } elsif ($line eq "") {
3146                         last;
3147                 }
3148         }
3149         push @comment, <$fd>;
3150         $tag{'comment'} = \@comment;
3151         close $fd or return;
3152         if (!defined $tag{'name'}) {
3153                 return
3154         };
3155         return %tag
3158 sub parse_commit_text {
3159         my ($commit_text, $withparents) = @_;
3160         my @commit_lines = split '\n', $commit_text;
3161         my %co;
3163         pop @commit_lines; # Remove '\0'
3165         if (! @commit_lines) {
3166                 return;
3167         }
3169         my $header = shift @commit_lines;
3170         if ($header !~ m/^[0-9a-fA-F]{40}/) {
3171                 return;
3172         }
3173         ($co{'id'}, my @parents) = split ' ', $header;
3174         while (my $line = shift @commit_lines) {
3175                 last if $line eq "\n";
3176                 if ($line =~ m/^tree ([0-9a-fA-F]{40})$/) {
3177                         $co{'tree'} = $1;
3178                 } elsif ((!defined $withparents) && ($line =~ m/^parent ([0-9a-fA-F]{40})$/)) {
3179                         push @parents, $1;
3180                 } elsif ($line =~ m/^author (.*) ([0-9]+) (.*)$/) {
3181                         $co{'author'} = to_utf8($1);
3182                         $co{'author_epoch'} = $2;
3183                         $co{'author_tz'} = $3;
3184                         if ($co{'author'} =~ m/^([^<]+) <([^>]*)>/) {
3185                                 $co{'author_name'}  = $1;
3186                                 $co{'author_email'} = $2;
3187                         } else {
3188                                 $co{'author_name'} = $co{'author'};
3189                         }
3190                 } elsif ($line =~ m/^committer (.*) ([0-9]+) (.*)$/) {
3191                         $co{'committer'} = to_utf8($1);
3192                         $co{'committer_epoch'} = $2;
3193                         $co{'committer_tz'} = $3;
3194                         if ($co{'committer'} =~ m/^([^<]+) <([^>]*)>/) {
3195                                 $co{'committer_name'}  = $1;
3196                                 $co{'committer_email'} = $2;
3197                         } else {
3198                                 $co{'committer_name'} = $co{'committer'};
3199                         }
3200                 }
3201         }
3202         if (!defined $co{'tree'}) {
3203                 return;
3204         };
3205         $co{'parents'} = \@parents;
3206         $co{'parent'} = $parents[0];
3208         foreach my $title (@commit_lines) {
3209                 $title =~ s/^    //;
3210                 if ($title ne "") {
3211                         $co{'title'} = chop_str($title, 80, 5);
3212                         # remove leading stuff of merges to make the interesting part visible
3213                         if (length($title) > 50) {
3214                                 $title =~ s/^Automatic //;
3215                                 $title =~ s/^merge (of|with) /Merge ... /i;
3216                                 if (length($title) > 50) {
3217                                         $title =~ s/(http|rsync):\/\///;
3218                                 }
3219                                 if (length($title) > 50) {
3220                                         $title =~ s/(master|www|rsync)\.//;
3221                                 }
3222                                 if (length($title) > 50) {
3223                                         $title =~ s/kernel.org:?//;
3224                                 }
3225                                 if (length($title) > 50) {
3226                                         $title =~ s/\/pub\/scm//;
3227                                 }
3228                         }
3229                         $co{'title_short'} = chop_str($title, 50, 5);
3230                         last;
3231                 }
3232         }
3233         if (! defined $co{'title'} || $co{'title'} eq "") {
3234                 $co{'title'} = $co{'title_short'} = '(no commit message)';
3235         }
3236         # remove added spaces
3237         foreach my $line (@commit_lines) {
3238                 $line =~ s/^    //;
3239         }
3240         $co{'comment'} = \@commit_lines;
3242         my $age = time - $co{'committer_epoch'};
3243         $co{'age'} = $age;
3244         $co{'age_string'} = age_string($age);
3245         my ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($co{'committer_epoch'});
3246         if ($age > 60*60*24*7*2) {
3247                 $co{'age_string_date'} = sprintf "%4i-%02u-%02i", 1900 + $year, $mon+1, $mday;
3248                 $co{'age_string_age'} = $co{'age_string'};
3249         } else {
3250                 $co{'age_string_date'} = $co{'age_string'};
3251                 $co{'age_string_age'} = sprintf "%4i-%02u-%02i", 1900 + $year, $mon+1, $mday;
3252         }
3253         return %co;
3256 sub parse_commit {
3257         my ($commit_id) = @_;
3258         my %co;
3260         local $/ = "\0";
3262         open my $fd, "-|", git_cmd(), "rev-list",
3263                 "--parents",
3264                 "--header",
3265                 "--max-count=1",
3266                 $commit_id,
3267                 "--",
3268                 or die_error(500, "Open git-rev-list failed");
3269         %co = parse_commit_text(<$fd>, 1);
3270         close $fd;
3272         return %co;
3275 sub parse_commits {
3276         my ($commit_id, $maxcount, $skip, $filename, @args) = @_;
3277         my @cos;
3279         $maxcount ||= 1;
3280         $skip ||= 0;
3282         local $/ = "\0";
3284         open my $fd, "-|", git_cmd(), "rev-list",
3285                 "--header",
3286                 @args,
3287                 ("--max-count=" . $maxcount),
3288                 ("--skip=" . $skip),
3289                 @extra_options,
3290                 $commit_id,
3291                 "--",
3292                 ($filename ? ($filename) : ())
3293                 or die_error(500, "Open git-rev-list failed");
3294         while (my $line = <$fd>) {
3295                 my %co = parse_commit_text($line);
3296                 push @cos, \%co;
3297         }
3298         close $fd;
3300         return wantarray ? @cos : \@cos;
3303 # parse line of git-diff-tree "raw" output
3304 sub parse_difftree_raw_line {
3305         my $line = shift;
3306         my %res;
3308         # ':100644 100644 03b218260e99b78c6df0ed378e59ed9205ccc96d 3b93d5e7cc7f7dd4ebed13a5cc1a4ad976fc94d8 M   ls-files.c'
3309         # ':100644 100644 7f9281985086971d3877aca27704f2aaf9c448ce bc190ebc71bbd923f2b728e505408f5e54bd073a M   rev-tree.c'
3310         if ($line =~ m/^:([0-7]{6}) ([0-7]{6}) ([0-9a-fA-F]{40}) ([0-9a-fA-F]{40}) (.)([0-9]{0,3})\t(.*)$/) {
3311                 $res{'from_mode'} = $1;
3312                 $res{'to_mode'} = $2;
3313                 $res{'from_id'} = $3;
3314                 $res{'to_id'} = $4;
3315                 $res{'status'} = $5;
3316                 $res{'similarity'} = $6;
3317                 if ($res{'status'} eq 'R' || $res{'status'} eq 'C') { # renamed or copied
3318                         ($res{'from_file'}, $res{'to_file'}) = map { unquote($_) } split("\t", $7);
3319                 } else {
3320                         $res{'from_file'} = $res{'to_file'} = $res{'file'} = unquote($7);
3321                 }
3322         }
3323         # '::100755 100755 100755 60e79ca1b01bc8b057abe17ddab484699a7f5fdb 94067cc5f73388f33722d52ae02f44692bc07490 94067cc5f73388f33722d52ae02f44692bc07490 MR git-gui/git-gui.sh'
3324         # combined diff (for merge commit)
3325         elsif ($line =~ s/^(::+)((?:[0-7]{6} )+)((?:[0-9a-fA-F]{40} )+)([a-zA-Z]+)\t(.*)$//) {
3326                 $res{'nparents'}  = length($1);
3327                 $res{'from_mode'} = [ split(' ', $2) ];
3328                 $res{'to_mode'} = pop @{$res{'from_mode'}};
3329                 $res{'from_id'} = [ split(' ', $3) ];
3330                 $res{'to_id'} = pop @{$res{'from_id'}};
3331                 $res{'status'} = [ split('', $4) ];
3332                 $res{'to_file'} = unquote($5);
3333         }
3334         # 'c512b523472485aef4fff9e57b229d9d243c967f'
3335         elsif ($line =~ m/^([0-9a-fA-F]{40})$/) {
3336                 $res{'commit'} = $1;
3337         }
3339         return wantarray ? %res : \%res;
3342 # wrapper: return parsed line of git-diff-tree "raw" output
3343 # (the argument might be raw line, or parsed info)
3344 sub parsed_difftree_line {
3345         my $line_or_ref = shift;
3347         if (ref($line_or_ref) eq "HASH") {
3348                 # pre-parsed (or generated by hand)
3349                 return $line_or_ref;
3350         } else {
3351                 return parse_difftree_raw_line($line_or_ref);
3352         }
3355 # parse line of git-ls-tree output
3356 sub parse_ls_tree_line {
3357         my $line = shift;
3358         my %opts = @_;
3359         my %res;
3361         if ($opts{'-l'}) {
3362                 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa   16717  panic.c'
3363                 $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40}) +(-|[0-9]+)\t(.+)$/s;
3365                 $res{'mode'} = $1;
3366                 $res{'type'} = $2;
3367                 $res{'hash'} = $3;
3368                 $res{'size'} = $4;
3369                 if ($opts{'-z'}) {
3370                         $res{'name'} = $5;
3371                 } else {
3372                         $res{'name'} = unquote($5);
3373                 }
3374         } else {
3375                 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa  panic.c'
3376                 $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t(.+)$/s;
3378                 $res{'mode'} = $1;
3379                 $res{'type'} = $2;
3380                 $res{'hash'} = $3;
3381                 if ($opts{'-z'}) {
3382                         $res{'name'} = $4;
3383                 } else {
3384                         $res{'name'} = unquote($4);
3385                 }
3386         }
3388         return wantarray ? %res : \%res;
3391 # generates _two_ hashes, references to which are passed as 2 and 3 argument
3392 sub parse_from_to_diffinfo {
3393         my ($diffinfo, $from, $to, @parents) = @_;
3395         if ($diffinfo->{'nparents'}) {
3396                 # combined diff
3397                 $from->{'file'} = [];
3398                 $from->{'href'} = [];
3399                 fill_from_file_info($diffinfo, @parents)
3400                         unless exists $diffinfo->{'from_file'};
3401                 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
3402                         $from->{'file'}[$i] =
3403                                 defined $diffinfo->{'from_file'}[$i] ?
3404                                         $diffinfo->{'from_file'}[$i] :
3405                                         $diffinfo->{'to_file'};
3406                         if ($diffinfo->{'status'}[$i] ne "A") { # not new (added) file
3407                                 $from->{'href'}[$i] = href(action=>"blob",
3408                                                            hash_base=>$parents[$i],
3409                                                            hash=>$diffinfo->{'from_id'}[$i],
3410                                                            file_name=>$from->{'file'}[$i]);
3411                         } else {
3412                                 $from->{'href'}[$i] = undef;
3413                         }
3414                 }
3415         } else {
3416                 # ordinary (not combined) diff
3417                 $from->{'file'} = $diffinfo->{'from_file'};
3418                 if ($diffinfo->{'status'} ne "A") { # not new (added) file
3419                         $from->{'href'} = href(action=>"blob", hash_base=>$hash_parent,
3420                                                hash=>$diffinfo->{'from_id'},
3421                                                file_name=>$from->{'file'});
3422                 } else {
3423                         delete $from->{'href'};
3424                 }
3425         }
3427         $to->{'file'} = $diffinfo->{'to_file'};
3428         if (!is_deleted($diffinfo)) { # file exists in result
3429                 $to->{'href'} = href(action=>"blob", hash_base=>$hash,
3430                                      hash=>$diffinfo->{'to_id'},
3431                                      file_name=>$to->{'file'});
3432         } else {
3433                 delete $to->{'href'};
3434         }
3437 ## ......................................................................
3438 ## parse to array of hashes functions
3440 sub git_get_heads_list {
3441         my ($limit, @classes) = @_;
3442         @classes = ('heads') unless @classes;
3443         my @patterns = map { "refs/$_" } @classes;
3444         my @headslist;
3446         open my $fd, '-|', git_cmd(), 'for-each-ref',
3447                 ($limit ? '--count='.($limit+1) : ()), '--sort=-committerdate',
3448                 '--format=%(objectname) %(refname) %(subject)%00%(committer)',
3449                 @patterns
3450                 or return;
3451         while (my $line = <$fd>) {
3452                 my %ref_item;
3454                 chomp $line;
3455                 my ($refinfo, $committerinfo) = split(/\0/, $line);
3456                 my ($hash, $name, $title) = split(' ', $refinfo, 3);
3457                 my ($committer, $epoch, $tz) =
3458                         ($committerinfo =~ /^(.*) ([0-9]+) (.*)$/);
3459                 $ref_item{'fullname'}  = $name;
3460                 $name =~ s!^refs/(?:head|remote)s/!!;
3462                 $ref_item{'name'}  = $name;
3463                 $ref_item{'id'}    = $hash;
3464                 $ref_item{'title'} = $title || '(no commit message)';
3465                 $ref_item{'epoch'} = $epoch;
3466                 if ($epoch) {
3467                         $ref_item{'age'} = age_string(time - $ref_item{'epoch'});
3468                 } else {
3469                         $ref_item{'age'} = "unknown";
3470                 }
3472                 push @headslist, \%ref_item;
3473         }
3474         close $fd;
3476         return wantarray ? @headslist : \@headslist;
3479 sub git_get_tags_list {
3480         my $limit = shift;
3481         my @tagslist;
3483         open my $fd, '-|', git_cmd(), 'for-each-ref',
3484                 ($limit ? '--count='.($limit+1) : ()), '--sort=-creatordate',
3485                 '--format=%(objectname) %(objecttype) %(refname) '.
3486                 '%(*objectname) %(*objecttype) %(subject)%00%(creator)',
3487                 'refs/tags'
3488                 or return;
3489         while (my $line = <$fd>) {
3490                 my %ref_item;
3492                 chomp $line;
3493                 my ($refinfo, $creatorinfo) = split(/\0/, $line);
3494                 my ($id, $type, $name, $refid, $reftype, $title) = split(' ', $refinfo, 6);
3495                 my ($creator, $epoch, $tz) =
3496                         ($creatorinfo =~ /^(.*) ([0-9]+) (.*)$/);
3497                 $ref_item{'fullname'} = $name;
3498                 $name =~ s!^refs/tags/!!;
3500                 $ref_item{'type'} = $type;
3501                 $ref_item{'id'} = $id;
3502                 $ref_item{'name'} = $name;
3503                 if ($type eq "tag") {
3504                         $ref_item{'subject'} = $title;
3505                         $ref_item{'reftype'} = $reftype;
3506                         $ref_item{'refid'}   = $refid;
3507                 } else {
3508                         $ref_item{'reftype'} = $type;
3509                         $ref_item{'refid'}   = $id;
3510                 }
3512                 if ($type eq "tag" || $type eq "commit") {
3513                         $ref_item{'epoch'} = $epoch;
3514                         if ($epoch) {
3515                                 $ref_item{'age'} = age_string(time - $ref_item{'epoch'});
3516                         } else {
3517                                 $ref_item{'age'} = "unknown";
3518                         }
3519                 }
3521                 push @tagslist, \%ref_item;
3522         }
3523         close $fd;
3525         return wantarray ? @tagslist : \@tagslist;
3528 ## ----------------------------------------------------------------------
3529 ## filesystem-related functions
3531 sub get_file_owner {
3532         my $path = shift;
3534         my ($dev, $ino, $mode, $nlink, $st_uid, $st_gid, $rdev, $size) = stat($path);
3535         my ($name, $passwd, $uid, $gid, $quota, $comment, $gcos, $dir, $shell) = getpwuid($st_uid);
3536         if (!defined $gcos) {
3537                 return undef;
3538         }
3539         my $owner = $gcos;
3540         $owner =~ s/[,;].*$//;
3541         return to_utf8($owner);
3544 # assume that file exists
3545 sub insert_file {
3546         my $filename = shift;
3548         open my $fd, '<', $filename;
3549         print map { to_utf8($_) } <$fd>;
3550         close $fd;
3553 ## ......................................................................
3554 ## mimetype related functions
3556 sub mimetype_guess_file {
3557         my $filename = shift;
3558         my $mimemap = shift;
3559         -r $mimemap or return undef;
3561         my %mimemap;
3562         open(my $mh, '<', $mimemap) or return undef;
3563         while (<$mh>) {
3564                 next if m/^#/; # skip comments
3565                 my ($mimetype, @exts) = split(/\s+/);
3566                 foreach my $ext (@exts) {
3567                         $mimemap{$ext} = $mimetype;
3568                 }
3569         }
3570         close($mh);
3572         $filename =~ /\.([^.]*)$/;
3573         return $mimemap{$1};
3576 sub mimetype_guess {
3577         my $filename = shift;
3578         my $mime;
3579         $filename =~ /\./ or return undef;
3581         if ($mimetypes_file) {
3582                 my $file = $mimetypes_file;
3583                 if ($file !~ m!^/!) { # if it is relative path
3584                         # it is relative to project
3585                         $file = "$projectroot/$project/$file";
3586                 }
3587                 $mime = mimetype_guess_file($filename, $file);
3588         }
3589         $mime ||= mimetype_guess_file($filename, '/etc/mime.types');
3590         return $mime;
3593 sub blob_mimetype {
3594         my $fd = shift;
3595         my $filename = shift;
3597         if ($filename) {
3598                 my $mime = mimetype_guess($filename);
3599                 $mime and return $mime;
3600         }
3602         # just in case
3603         return $default_blob_plain_mimetype unless $fd;
3605         if (-T $fd) {
3606                 return 'text/plain';
3607         } elsif (! $filename) {
3608                 return 'application/octet-stream';
3609         } elsif ($filename =~ m/\.png$/i) {
3610                 return 'image/png';
3611         } elsif ($filename =~ m/\.gif$/i) {
3612                 return 'image/gif';
3613         } elsif ($filename =~ m/\.jpe?g$/i) {
3614                 return 'image/jpeg';
3615         } else {
3616                 return 'application/octet-stream';
3617         }
3620 sub blob_contenttype {
3621         my ($fd, $file_name, $type) = @_;
3623         $type ||= blob_mimetype($fd, $file_name);
3624         if ($type eq 'text/plain' && defined $default_text_plain_charset) {
3625                 $type .= "; charset=$default_text_plain_charset";
3626         }
3628         return $type;
3631 # guess file syntax for syntax highlighting; return undef if no highlighting
3632 # the name of syntax can (in the future) depend on syntax highlighter used
3633 sub guess_file_syntax {
3634         my ($highlight, $mimetype, $file_name) = @_;
3635         return undef unless ($highlight && defined $file_name);
3636         my $basename = basename($file_name, '.in');
3637         return $highlight_basename{$basename}
3638                 if exists $highlight_basename{$basename};
3640         $basename =~ /\.([^.]*)$/;
3641         my $ext = $1 or return undef;
3642         return $highlight_ext{$ext}
3643                 if exists $highlight_ext{$ext};
3645         return undef;
3648 # run highlighter and return FD of its output,
3649 # or return original FD if no highlighting
3650 sub run_highlighter {
3651         my ($fd, $highlight, $syntax) = @_;
3652         return $fd unless ($highlight && defined $syntax);
3654         close $fd;
3655         open $fd, quote_command(git_cmd(), "cat-file", "blob", $hash)." | ".
3656                   quote_command($highlight_bin).
3657                   " --replace-tabs=8 --fragment --syntax $syntax |"
3658                 or die_error(500, "Couldn't open file or run syntax highlighter");
3659         return $fd;
3662 ## ======================================================================
3663 ## functions printing HTML: header, footer, error page
3665 sub get_page_title {
3666         my $title = to_utf8($site_name);
3668         return $title unless (defined $project);
3669         $title .= " - " . to_utf8($project);
3671         return $title unless (defined $action);
3672         $title .= "/$action"; # $action is US-ASCII (7bit ASCII)
3674         return $title unless (defined $file_name);
3675         $title .= " - " . esc_path($file_name);
3676         if ($action eq "tree" && $file_name !~ m|/$|) {
3677                 $title .= "/";
3678         }
3680         return $title;
3683 sub get_content_type_html {
3684         # require explicit support from the UA if we are to send the page as
3685         # 'application/xhtml+xml', otherwise send it as plain old 'text/html'.
3686         # we have to do this because MSIE sometimes globs '*/*', pretending to
3687         # support xhtml+xml but choking when it gets what it asked for.
3688         if (defined $cgi->http('HTTP_ACCEPT') &&
3689             $cgi->http('HTTP_ACCEPT') =~ m/(,|;|\s|^)application\/xhtml\+xml(,|;|\s|$)/ &&
3690             $cgi->Accept('application/xhtml+xml') != 0) {
3691                 return 'application/xhtml+xml';
3692         } else {
3693                 return 'text/html';
3694         }
3697 sub print_feed_meta {
3698         if (defined $project) {
3699                 my %href_params = get_feed_info();
3700                 if (!exists $href_params{'-title'}) {
3701                         $href_params{'-title'} = 'log';
3702                 }
3704                 foreach my $format (qw(RSS Atom)) {
3705                         my $type = lc($format);
3706                         my %link_attr = (
3707                                 '-rel' => 'alternate',
3708                                 '-title' => esc_attr("$project - $href_params{'-title'} - $format feed"),
3709                                 '-type' => "application/$type+xml"
3710                         );
3712                         $href_params{'action'} = $type;
3713                         $link_attr{'-href'} = href(%href_params);
3714                         print "<link ".
3715                               "rel=\"$link_attr{'-rel'}\" ".
3716                               "title=\"$link_attr{'-title'}\" ".
3717                               "href=\"$link_attr{'-href'}\" ".
3718                               "type=\"$link_attr{'-type'}\" ".
3719                               "/>\n";
3721                         $href_params{'extra_options'} = '--no-merges';
3722                         $link_attr{'-href'} = href(%href_params);
3723                         $link_attr{'-title'} .= ' (no merges)';
3724                         print "<link ".
3725                               "rel=\"$link_attr{'-rel'}\" ".
3726                               "title=\"$link_attr{'-title'}\" ".
3727                               "href=\"$link_attr{'-href'}\" ".
3728                               "type=\"$link_attr{'-type'}\" ".
3729                               "/>\n";
3730                 }
3732         } else {
3733                 printf('<link rel="alternate" title="%s projects list" '.
3734                        'href="%s" type="text/plain; charset=utf-8" />'."\n",
3735                        esc_attr($site_name), href(project=>undef, action=>"project_index"));
3736                 printf('<link rel="alternate" title="%s projects feeds" '.
3737                        'href="%s" type="text/x-opml" />'."\n",
3738                        esc_attr($site_name), href(project=>undef, action=>"opml"));
3739         }
3742 sub print_header_links {
3743         my $status = shift;
3745         # print out each stylesheet that exist, providing backwards capability
3746         # for those people who defined $stylesheet in a config file
3747         if (defined $stylesheet) {
3748                 print '<link rel="stylesheet" type="text/css" href="'.esc_url($stylesheet).'"/>'."\n";
3749         } else {
3750                 foreach my $stylesheet (@stylesheets) {
3751                         next unless $stylesheet;
3752                         print '<link rel="stylesheet" type="text/css" href="'.esc_url($stylesheet).'"/>'."\n";
3753                 }
3754         }
3755         print_feed_meta()
3756                 if ($status eq '200 OK');
3757         if (defined $favicon) {
3758                 print qq(<link rel="shortcut icon" href=").esc_url($favicon).qq(" type="image/png" />\n);
3759         }
3762 sub print_nav_breadcrumbs {
3763         my %opts = @_;
3765         print $cgi->a({-href => esc_url($home_link)}, $home_link_str) . " / ";
3766         if (defined $project) {
3767                 print $cgi->a({-href => href(action=>"summary")}, esc_html($project));
3768                 if (defined $action) {
3769                         my $action_print = $action ;
3770                         if (defined $opts{-action_extra}) {
3771                                 $action_print = $cgi->a({-href => href(action=>$action)},
3772                                         $action);
3773                         }
3774                         print " / $action_print";
3775                 }
3776                 if (defined $opts{-action_extra}) {
3777                         print " / $opts{-action_extra}";
3778                 }
3779                 print "\n";
3780         }
3783 sub print_search_form {
3784         if (!defined $searchtext) {
3785                 $searchtext = "";
3786         }
3787         my $search_hash;
3788         if (defined $hash_base) {
3789                 $search_hash = $hash_base;
3790         } elsif (defined $hash) {
3791                 $search_hash = $hash;
3792         } else {
3793                 $search_hash = "HEAD";
3794         }
3795         my $action = $my_uri;
3796         my $use_pathinfo = gitweb_check_feature('pathinfo');
3797         if ($use_pathinfo) {
3798                 $action .= "/".esc_url($project);
3799         }
3800         print $cgi->startform(-method => "get", -action => $action) .
3801               "<div class=\"search\">\n" .
3802               (!$use_pathinfo &&
3803               $cgi->input({-name=>"p", -value=>$project, -type=>"hidden"}) . "\n") .
3804               $cgi->input({-name=>"a", -value=>"search", -type=>"hidden"}) . "\n" .
3805               $cgi->input({-name=>"h", -value=>$search_hash, -type=>"hidden"}) . "\n" .
3806               $cgi->popup_menu(-name => 'st', -default => 'commit',
3807                                -values => ['commit', 'grep', 'author', 'committer', 'pickaxe']) .
3808               $cgi->sup($cgi->a({-href => href(action=>"search_help")}, "?")) .
3809               " search:\n",
3810               $cgi->textfield(-name => "s", -value => $searchtext) . "\n" .
3811               "<span title=\"Extended regular expression\">" .
3812               $cgi->checkbox(-name => 'sr', -value => 1, -label => 're',
3813                              -checked => $search_use_regexp) .
3814               "</span>" .
3815               "</div>" .
3816               $cgi->end_form() . "\n";
3819 sub git_header_html {
3820         my $status = shift || "200 OK";
3821         my $expires = shift;
3822         my %opts = @_;
3824         my $title = get_page_title();
3825         my $content_type = get_content_type_html();
3826         print $cgi->header(-type=>$content_type, -charset => 'utf-8',
3827                            -status=> $status, -expires => $expires)
3828                 unless ($opts{'-no_http_header'});
3829         my $mod_perl_version = $ENV{'MOD_PERL'} ? " $ENV{'MOD_PERL'}" : '';
3830         print <<EOF;
3831 <?xml version="1.0" encoding="utf-8"?>
3832 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3833 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US">
3834 <!-- git web interface version $version, (C) 2005-2006, Kay Sievers <kay.sievers\@vrfy.org>, Christian Gierke -->
3835 <!-- git core binaries version $git_version -->
3836 <head>
3837 <meta http-equiv="content-type" content="$content_type; charset=utf-8"/>
3838 <meta name="generator" content="gitweb/$version git/$git_version$mod_perl_version"/>
3839 <meta name="robots" content="index, nofollow"/>
3840 <title>$title</title>
3841 EOF
3842         # the stylesheet, favicon etc urls won't work correctly with path_info
3843         # unless we set the appropriate base URL
3844         if ($ENV{'PATH_INFO'}) {
3845                 print "<base href=\"".esc_url($base_url)."\" />\n";
3846         }
3847         print_header_links($status);
3848         print "</head>\n" .
3849               "<body>\n";
3851         if (defined $site_header && -f $site_header) {
3852                 insert_file($site_header);
3853         }
3855         print "<div class=\"page_header\">\n";
3856         if (defined $logo) {
3857                 print $cgi->a({-href => esc_url($logo_url),
3858                                -title => $logo_label},
3859                               $cgi->img({-src => esc_url($logo),
3860                                          -width => 72, -height => 27,
3861                                          -alt => "git",
3862                                          -class => "logo"}));
3863         }
3864         print_nav_breadcrumbs(%opts);
3865         print "</div>\n";
3867         my $have_search = gitweb_check_feature('search');
3868         if (defined $project && $have_search) {
3869                 print_search_form();
3870         }
3873 sub git_footer_html {
3874         my $feed_class = 'rss_logo';
3876         print "<div class=\"page_footer\">\n";
3877         if (defined $project) {
3878                 my $descr = git_get_project_description($project);
3879                 if (defined $descr) {
3880                         print "<div class=\"page_footer_text\">" . esc_html($descr) . "</div>\n";
3881                 }
3883                 my %href_params = get_feed_info();
3884                 if (!%href_params) {
3885                         $feed_class .= ' generic';
3886                 }
3887                 $href_params{'-title'} ||= 'log';
3889                 foreach my $format (qw(RSS Atom)) {
3890                         $href_params{'action'} = lc($format);
3891                         print $cgi->a({-href => href(%href_params),
3892                                       -title => "$href_params{'-title'} $format feed",
3893                                       -class => $feed_class}, $format)."\n";
3894                 }
3896         } else {
3897                 print $cgi->a({-href => href(project=>undef, action=>"opml"),
3898                               -class => $feed_class}, "OPML") . " ";
3899                 print $cgi->a({-href => href(project=>undef, action=>"project_index"),
3900                               -class => $feed_class}, "TXT") . "\n";
3901         }
3902         print "</div>\n"; # class="page_footer"
3904         if (defined $t0 && gitweb_check_feature('timed')) {
3905                 print "<div id=\"generating_info\">\n";
3906                 print 'This page took '.
3907                       '<span id="generating_time" class="time_span">'.
3908                       tv_interval($t0, [ gettimeofday() ]).
3909                       ' seconds </span>'.
3910                       ' and '.
3911                       '<span id="generating_cmd">'.
3912                       $number_of_git_cmds.
3913                       '</span> git commands '.
3914                       " to generate.\n";
3915                 print "</div>\n"; # class="page_footer"
3916         }
3918         if (defined $site_footer && -f $site_footer) {
3919                 insert_file($site_footer);
3920         }
3922         print qq!<script type="text/javascript" src="!.esc_url($javascript).qq!"></script>\n!;
3923         if (defined $action &&
3924             $action eq 'blame_incremental') {
3925                 print qq!<script type="text/javascript">\n!.
3926                       qq!startBlame("!. href(action=>"blame_data", -replay=>1) .qq!",\n!.
3927                       qq!           "!. href() .qq!");\n!.
3928                       qq!</script>\n!;
3929         } else {
3930                 my ($jstimezone, $tz_cookie, $datetime_class) =
3931                         gitweb_get_feature('javascript-timezone');
3933                 print qq!<script type="text/javascript">\n!.
3934                       qq!window.onload = function () {\n!;
3935                 if (gitweb_check_feature('javascript-actions')) {
3936                         print qq!       fixLinks();\n!;
3937                 }
3938                 if ($jstimezone && $tz_cookie && $datetime_class) {
3939                         print qq!       var tz_cookie = { name: '$tz_cookie', expires: 14, path: '/' };\n!. # in days
3940                               qq!       onloadTZSetup('$jstimezone', tz_cookie, '$datetime_class');\n!;
3941                 }
3942                 print qq!};\n!.
3943                       qq!</script>\n!;
3944         }
3946         print "</body>\n" .
3947               "</html>";
3950 # die_error(<http_status_code>, <error_message>[, <detailed_html_description>])
3951 # Example: die_error(404, 'Hash not found')
3952 # By convention, use the following status codes (as defined in RFC 2616):
3953 # 400: Invalid or missing CGI parameters, or
3954 #      requested object exists but has wrong type.
3955 # 403: Requested feature (like "pickaxe" or "snapshot") not enabled on
3956 #      this server or project.
3957 # 404: Requested object/revision/project doesn't exist.
3958 # 500: The server isn't configured properly, or
3959 #      an internal error occurred (e.g. failed assertions caused by bugs), or
3960 #      an unknown error occurred (e.g. the git binary died unexpectedly).
3961 # 503: The server is currently unavailable (because it is overloaded,
3962 #      or down for maintenance).  Generally, this is a temporary state.
3963 sub die_error {
3964         my $status = shift || 500;
3965         my $error = esc_html(shift) || "Internal Server Error";
3966         my $extra = shift;
3967         my %opts = @_;
3969         my %http_responses = (
3970                 400 => '400 Bad Request',
3971                 403 => '403 Forbidden',
3972                 404 => '404 Not Found',
3973                 500 => '500 Internal Server Error',
3974                 503 => '503 Service Unavailable',
3975         );
3976         git_header_html($http_responses{$status}, undef, %opts);
3977         print <<EOF;
3978 <div class="page_body">
3979 <br /><br />
3980 $status - $error
3981 <br />
3982 EOF
3983         if (defined $extra) {
3984                 print "<hr />\n" .
3985                       "$extra\n";
3986         }
3987         print "</div>\n";
3989         git_footer_html();
3990         goto DONE_GITWEB
3991                 unless ($opts{'-error_handler'});
3994 ## ----------------------------------------------------------------------
3995 ## functions printing or outputting HTML: navigation
3997 sub git_print_page_nav {
3998         my ($current, $suppress, $head, $treehead, $treebase, $extra) = @_;
3999         $extra = '' if !defined $extra; # pager or formats
4001         my @navs = qw(summary shortlog log commit commitdiff tree);
4002         if ($suppress) {
4003                 @navs = grep { $_ ne $suppress } @navs;
4004         }
4006         my %arg = map { $_ => {action=>$_} } @navs;
4007         if (defined $head) {
4008                 for (qw(commit commitdiff)) {
4009                         $arg{$_}{'hash'} = $head;
4010                 }
4011                 if ($current =~ m/^(tree | log | shortlog | commit | commitdiff | search)$/x) {
4012                         for (qw(shortlog log)) {
4013                                 $arg{$_}{'hash'} = $head;
4014                         }
4015                 }
4016         }
4018         $arg{'tree'}{'hash'} = $treehead if defined $treehead;
4019         $arg{'tree'}{'hash_base'} = $treebase if defined $treebase;
4021         my @actions = gitweb_get_feature('actions');
4022         my %repl = (
4023                 '%' => '%',
4024                 'n' => $project,         # project name
4025                 'f' => $git_dir,         # project path within filesystem
4026                 'h' => $treehead || '',  # current hash ('h' parameter)
4027                 'b' => $treebase || '',  # hash base ('hb' parameter)
4028         );
4029         while (@actions) {
4030                 my ($label, $link, $pos) = splice(@actions,0,3);
4031                 # insert
4032                 @navs = map { $_ eq $pos ? ($_, $label) : $_ } @navs;
4033                 # munch munch
4034                 $link =~ s/%([%nfhb])/$repl{$1}/g;
4035                 $arg{$label}{'_href'} = $link;
4036         }
4038         print "<div class=\"page_nav\">\n" .
4039                 (join " | ",
4040                  map { $_ eq $current ?
4041                        $_ : $cgi->a({-href => ($arg{$_}{_href} ? $arg{$_}{_href} : href(%{$arg{$_}}))}, "$_")
4042                  } @navs);
4043         print "<br/>\n$extra<br/>\n" .
4044               "</div>\n";
4047 # returns a submenu for the nagivation of the refs views (tags, heads,
4048 # remotes) with the current view disabled and the remotes view only
4049 # available if the feature is enabled
4050 sub format_ref_views {
4051         my ($current) = @_;
4052         my @ref_views = qw{tags heads};
4053         push @ref_views, 'remotes' if gitweb_check_feature('remote_heads');
4054         return join " | ", map {
4055                 $_ eq $current ? $_ :
4056                 $cgi->a({-href => href(action=>$_)}, $_)
4057         } @ref_views
4060 sub format_paging_nav {
4061         my ($action, $page, $has_next_link) = @_;
4062         my $paging_nav;
4065         if ($page > 0) {
4066                 $paging_nav .=
4067                         $cgi->a({-href => href(-replay=>1, page=>undef)}, "first") .
4068                         " &sdot; " .
4069                         $cgi->a({-href => href(-replay=>1, page=>$page-1),
4070                                  -accesskey => "p", -title => "Alt-p"}, "prev");
4071         } else {
4072                 $paging_nav .= "first &sdot; prev";
4073         }
4075         if ($has_next_link) {
4076                 $paging_nav .= " &sdot; " .
4077                         $cgi->a({-href => href(-replay=>1, page=>$page+1),
4078                                  -accesskey => "n", -title => "Alt-n"}, "next");
4079         } else {
4080                 $paging_nav .= " &sdot; next";
4081         }
4083         return $paging_nav;
4086 ## ......................................................................
4087 ## functions printing or outputting HTML: div
4089 sub git_print_header_div {
4090         my ($action, $title, $hash, $hash_base) = @_;
4091         my %args = ();
4093         $args{'action'} = $action;
4094         $args{'hash'} = $hash if $hash;
4095         $args{'hash_base'} = $hash_base if $hash_base;
4097         print "<div class=\"header\">\n" .
4098               $cgi->a({-href => href(%args), -class => "title"},
4099               $title ? $title : $action) .
4100               "\n</div>\n";
4103 sub format_repo_url {
4104         my ($name, $url) = @_;
4105         return "<tr class=\"metadata_url\"><td>$name</td><td>$url</td></tr>\n";
4108 # Group output by placing it in a DIV element and adding a header.
4109 # Options for start_div() can be provided by passing a hash reference as the
4110 # first parameter to the function.
4111 # Options to git_print_header_div() can be provided by passing an array
4112 # reference. This must follow the options to start_div if they are present.
4113 # The content can be a scalar, which is output as-is, a scalar reference, which
4114 # is output after html escaping, an IO handle passed either as *handle or
4115 # *handle{IO}, or a function reference. In the latter case all following
4116 # parameters will be taken as argument to the content function call.
4117 sub git_print_section {
4118         my ($div_args, $header_args, $content);
4119         my $arg = shift;
4120         if (ref($arg) eq 'HASH') {
4121                 $div_args = $arg;
4122                 $arg = shift;
4123         }
4124         if (ref($arg) eq 'ARRAY') {
4125                 $header_args = $arg;
4126                 $arg = shift;
4127         }
4128         $content = $arg;
4130         print $cgi->start_div($div_args);
4131         git_print_header_div(@$header_args);
4133         if (ref($content) eq 'CODE') {
4134                 $content->(@_);
4135         } elsif (ref($content) eq 'SCALAR') {
4136                 print esc_html($$content);
4137         } elsif (ref($content) eq 'GLOB' or ref($content) eq 'IO::Handle') {
4138                 print <$content>;
4139         } elsif (!ref($content) && defined($content)) {
4140                 print $content;
4141         }
4143         print $cgi->end_div;
4146 sub format_timestamp_html {
4147         my $date = shift;
4148         my $strtime = $date->{'rfc2822'};
4150         my (undef, undef, $datetime_class) =
4151                 gitweb_get_feature('javascript-timezone');
4152         if ($datetime_class) {
4153                 $strtime = qq!<span class="$datetime_class">$strtime</span>!;
4154         }
4156         my $localtime_format = '(%02d:%02d %s)';
4157         if ($date->{'hour_local'} < 6) {
4158                 $localtime_format = '(<span class="atnight">%02d:%02d</span> %s)';
4159         }
4160         $strtime .= ' ' .
4161                     sprintf($localtime_format,
4162                             $date->{'hour_local'}, $date->{'minute_local'}, $date->{'tz_local'});
4164         return $strtime;
4167 # Outputs the author name and date in long form
4168 sub git_print_authorship {
4169         my $co = shift;
4170         my %opts = @_;
4171         my $tag = $opts{-tag} || 'div';
4172         my $author = $co->{'author_name'};
4174         my %ad = parse_date($co->{'author_epoch'}, $co->{'author_tz'});
4175         print "<$tag class=\"author_date\">" .
4176               format_search_author($author, "author", esc_html($author)) .
4177               " [".format_timestamp_html(\%ad)."]".
4178               git_get_avatar($co->{'author_email'}, -pad_before => 1) .
4179               "</$tag>\n";
4182 # Outputs table rows containing the full author or committer information,
4183 # in the format expected for 'commit' view (& similar).
4184 # Parameters are a commit hash reference, followed by the list of people
4185 # to output information for. If the list is empty it defaults to both
4186 # author and committer.
4187 sub git_print_authorship_rows {
4188         my $co = shift;
4189         # too bad we can't use @people = @_ || ('author', 'committer')
4190         my @people = @_;
4191         @people = ('author', 'committer') unless @people;
4192         foreach my $who (@people) {
4193                 my %wd = parse_date($co->{"${who}_epoch"}, $co->{"${who}_tz"});
4194                 print "<tr><td>$who</td><td>" .
4195                       format_search_author($co->{"${who}_name"}, $who,
4196                                            esc_html($co->{"${who}_name"})) . " " .
4197                       format_search_author($co->{"${who}_email"}, $who,
4198                                            esc_html("<" . $co->{"${who}_email"} . ">")) .
4199                       "</td><td rowspan=\"2\">" .
4200                       git_get_avatar($co->{"${who}_email"}, -size => 'double') .
4201                       "</td></tr>\n" .
4202                       "<tr>" .
4203                       "<td></td><td>" .
4204                       format_timestamp_html(\%wd) .
4205                       "</td>" .
4206                       "</tr>\n";
4207         }
4210 sub git_print_page_path {
4211         my $name = shift;
4212         my $type = shift;
4213         my $hb = shift;
4216         print "<div class=\"page_path\">";
4217         print $cgi->a({-href => href(action=>"tree", hash_base=>$hb),
4218                       -title => 'tree root'}, to_utf8("[$project]"));
4219         print " / ";
4220         if (defined $name) {
4221                 my @dirname = split '/', $name;
4222                 my $basename = pop @dirname;
4223                 my $fullname = '';
4225                 foreach my $dir (@dirname) {
4226                         $fullname .= ($fullname ? '/' : '') . $dir;
4227                         print $cgi->a({-href => href(action=>"tree", file_name=>$fullname,
4228                                                      hash_base=>$hb),
4229                                       -title => $fullname}, esc_path($dir));
4230                         print " / ";
4231                 }
4232                 if (defined $type && $type eq 'blob') {
4233                         print $cgi->a({-href => href(action=>"blob_plain", file_name=>$file_name,
4234                                                      hash_base=>$hb),
4235                                       -title => $name}, esc_path($basename));
4236                 } elsif (defined $type && $type eq 'tree') {
4237                         print $cgi->a({-href => href(action=>"tree", file_name=>$file_name,
4238                                                      hash_base=>$hb),
4239                                       -title => $name}, esc_path($basename));
4240                         print " / ";
4241                 } else {
4242                         print esc_path($basename);
4243                 }
4244         }
4245         print "<br/></div>\n";
4248 sub git_print_log {
4249         my $log = shift;
4250         my %opts = @_;
4252         if ($opts{'-remove_title'}) {
4253                 # remove title, i.e. first line of log
4254                 shift @$log;
4255         }
4256         # remove leading empty lines
4257         while (defined $log->[0] && $log->[0] eq "") {
4258                 shift @$log;
4259         }
4261         # print log
4262         my $signoff = 0;
4263         my $empty = 0;
4264         foreach my $line (@$log) {
4265                 if ($line =~ m/^ *(signed[ \-]off[ \-]by[ :]|acked[ \-]by[ :]|cc[ :])/i) {
4266                         $signoff = 1;
4267                         $empty = 0;
4268                         if (! $opts{'-remove_signoff'}) {
4269                                 print "<span class=\"signoff\">" . esc_html($line) . "</span><br/>\n";
4270                                 next;
4271                         } else {
4272                                 # remove signoff lines
4273                                 next;
4274                         }
4275                 } else {
4276                         $signoff = 0;
4277                 }
4279                 # print only one empty line
4280                 # do not print empty line after signoff
4281                 if ($line eq "") {
4282                         next if ($empty || $signoff);
4283                         $empty = 1;
4284                 } else {
4285                         $empty = 0;
4286                 }
4288                 print format_log_line_html($line) . "<br/>\n";
4289         }
4291         if ($opts{'-final_empty_line'}) {
4292                 # end with single empty line
4293                 print "<br/>\n" unless $empty;
4294         }
4297 # return link target (what link points to)
4298 sub git_get_link_target {
4299         my $hash = shift;
4300         my $link_target;
4302         # read link
4303         open my $fd, "-|", git_cmd(), "cat-file", "blob", $hash
4304                 or return;
4305         {
4306                 local $/ = undef;
4307                 $link_target = <$fd>;
4308         }
4309         close $fd
4310                 or return;
4312         return $link_target;
4315 # given link target, and the directory (basedir) the link is in,
4316 # return target of link relative to top directory (top tree);
4317 # return undef if it is not possible (including absolute links).
4318 sub normalize_link_target {
4319         my ($link_target, $basedir) = @_;
4321         # absolute symlinks (beginning with '/') cannot be normalized
4322         return if (substr($link_target, 0, 1) eq '/');
4324         # normalize link target to path from top (root) tree (dir)
4325         my $path;
4326         if ($basedir) {
4327                 $path = $basedir . '/' . $link_target;
4328         } else {
4329                 # we are in top (root) tree (dir)
4330                 $path = $link_target;
4331         }
4333         # remove //, /./, and /../
4334         my @path_parts;
4335         foreach my $part (split('/', $path)) {
4336                 # discard '.' and ''
4337                 next if (!$part || $part eq '.');
4338                 # handle '..'
4339                 if ($part eq '..') {
4340                         if (@path_parts) {
4341                                 pop @path_parts;
4342                         } else {
4343                                 # link leads outside repository (outside top dir)
4344                                 return;
4345                         }
4346                 } else {
4347                         push @path_parts, $part;
4348                 }
4349         }
4350         $path = join('/', @path_parts);
4352         return $path;
4355 # print tree entry (row of git_tree), but without encompassing <tr> element
4356 sub git_print_tree_entry {
4357         my ($t, $basedir, $hash_base, $have_blame) = @_;
4359         my %base_key = ();
4360         $base_key{'hash_base'} = $hash_base if defined $hash_base;
4362         # The format of a table row is: mode list link.  Where mode is
4363         # the mode of the entry, list is the name of the entry, an href,
4364         # and link is the action links of the entry.
4366         print "<td class=\"mode\">" . mode_str($t->{'mode'}) . "</td>\n";
4367         if (exists $t->{'size'}) {
4368                 print "<td class=\"size\">$t->{'size'}</td>\n";
4369         }
4370         if ($t->{'type'} eq "blob") {
4371                 print "<td class=\"list\">" .
4372                         $cgi->a({-href => href(action=>"blob", hash=>$t->{'hash'},
4373                                                file_name=>"$basedir$t->{'name'}", %base_key),
4374                                 -class => "list"}, esc_path($t->{'name'}));
4375                 if (S_ISLNK(oct $t->{'mode'})) {
4376                         my $link_target = git_get_link_target($t->{'hash'});
4377                         if ($link_target) {
4378                                 my $norm_target = normalize_link_target($link_target, $basedir);
4379                                 if (defined $norm_target) {
4380                                         print " -> " .
4381                                               $cgi->a({-href => href(action=>"object", hash_base=>$hash_base,
4382                                                                      file_name=>$norm_target),
4383                                                        -title => $norm_target}, esc_path($link_target));
4384                                 } else {
4385                                         print " -> " . esc_path($link_target);
4386                                 }
4387                         }
4388                 }
4389                 print "</td>\n";
4390                 print "<td class=\"link\">";
4391                 print $cgi->a({-href => href(action=>"blob", hash=>$t->{'hash'},
4392                                              file_name=>"$basedir$t->{'name'}", %base_key)},
4393                               "blob");
4394                 if ($have_blame) {
4395                         print " | " .
4396                               $cgi->a({-href => href(action=>"blame", hash=>$t->{'hash'},
4397                                                      file_name=>"$basedir$t->{'name'}", %base_key)},
4398                                       "blame");
4399                 }
4400                 if (defined $hash_base) {
4401                         print " | " .
4402                               $cgi->a({-href => href(action=>"history", hash_base=>$hash_base,
4403                                                      hash=>$t->{'hash'}, file_name=>"$basedir$t->{'name'}")},
4404                                       "history");
4405                 }
4406                 print " | " .
4407                         $cgi->a({-href => href(action=>"blob_plain", hash_base=>$hash_base,
4408                                                file_name=>"$basedir$t->{'name'}")},
4409                                 "raw");
4410                 print "</td>\n";
4412         } elsif ($t->{'type'} eq "tree") {
4413                 print "<td class=\"list\">";
4414                 print $cgi->a({-href => href(action=>"tree", hash=>$t->{'hash'},
4415                                              file_name=>"$basedir$t->{'name'}",
4416                                              %base_key)},
4417                               esc_path($t->{'name'}));
4418                 print "</td>\n";
4419                 print "<td class=\"link\">";
4420                 print $cgi->a({-href => href(action=>"tree", hash=>$t->{'hash'},
4421                                              file_name=>"$basedir$t->{'name'}",
4422                                              %base_key)},
4423                               "tree");
4424                 if (defined $hash_base) {
4425                         print " | " .
4426                               $cgi->a({-href => href(action=>"history", hash_base=>$hash_base,
4427                                                      file_name=>"$basedir$t->{'name'}")},
4428                                       "history");
4429                 }
4430                 print "</td>\n";
4431         } else {
4432                 # unknown object: we can only present history for it
4433                 # (this includes 'commit' object, i.e. submodule support)
4434                 print "<td class=\"list\">" .
4435                       esc_path($t->{'name'}) .
4436                       "</td>\n";
4437                 print "<td class=\"link\">";
4438                 if (defined $hash_base) {
4439                         print $cgi->a({-href => href(action=>"history",
4440                                                      hash_base=>$hash_base,
4441                                                      file_name=>"$basedir$t->{'name'}")},
4442                                       "history");
4443                 }
4444                 print "</td>\n";
4445         }
4448 ## ......................................................................
4449 ## functions printing large fragments of HTML
4451 # get pre-image filenames for merge (combined) diff
4452 sub fill_from_file_info {
4453         my ($diff, @parents) = @_;
4455         $diff->{'from_file'} = [ ];
4456         $diff->{'from_file'}[$diff->{'nparents'} - 1] = undef;
4457         for (my $i = 0; $i < $diff->{'nparents'}; $i++) {
4458                 if ($diff->{'status'}[$i] eq 'R' ||
4459                     $diff->{'status'}[$i] eq 'C') {
4460                         $diff->{'from_file'}[$i] =
4461                                 git_get_path_by_hash($parents[$i], $diff->{'from_id'}[$i]);
4462                 }
4463         }
4465         return $diff;
4468 # is current raw difftree line of file deletion
4469 sub is_deleted {
4470         my $diffinfo = shift;
4472         return $diffinfo->{'to_id'} eq ('0' x 40);
4475 # does patch correspond to [previous] difftree raw line
4476 # $diffinfo  - hashref of parsed raw diff format
4477 # $patchinfo - hashref of parsed patch diff format
4478 #              (the same keys as in $diffinfo)
4479 sub is_patch_split {
4480         my ($diffinfo, $patchinfo) = @_;
4482         return defined $diffinfo && defined $patchinfo
4483                 && $diffinfo->{'to_file'} eq $patchinfo->{'to_file'};
4487 sub git_difftree_body {
4488         my ($difftree, $hash, @parents) = @_;
4489         my ($parent) = $parents[0];
4490         my $have_blame = gitweb_check_feature('blame');
4491         print "<div class=\"list_head\">\n";
4492         if ($#{$difftree} > 10) {
4493                 print(($#{$difftree} + 1) . " files changed:\n");
4494         }
4495         print "</div>\n";
4497         print "<table class=\"" .
4498               (@parents > 1 ? "combined " : "") .
4499               "diff_tree\">\n";
4501         # header only for combined diff in 'commitdiff' view
4502         my $has_header = @$difftree && @parents > 1 && $action eq 'commitdiff';
4503         if ($has_header) {
4504                 # table header
4505                 print "<thead><tr>\n" .
4506                        "<th></th><th></th>\n"; # filename, patchN link
4507                 for (my $i = 0; $i < @parents; $i++) {
4508                         my $par = $parents[$i];
4509                         print "<th>" .
4510                               $cgi->a({-href => href(action=>"commitdiff",
4511                                                      hash=>$hash, hash_parent=>$par),
4512                                        -title => 'commitdiff to parent number ' .
4513                                                   ($i+1) . ': ' . substr($par,0,7)},
4514                                       $i+1) .
4515                               "&nbsp;</th>\n";
4516                 }
4517                 print "</tr></thead>\n<tbody>\n";
4518         }
4520         my $alternate = 1;
4521         my $patchno = 0;
4522         foreach my $line (@{$difftree}) {
4523                 my $diff = parsed_difftree_line($line);
4525                 if ($alternate) {
4526                         print "<tr class=\"dark\">\n";
4527                 } else {
4528                         print "<tr class=\"light\">\n";
4529                 }
4530                 $alternate ^= 1;
4532                 if (exists $diff->{'nparents'}) { # combined diff
4534                         fill_from_file_info($diff, @parents)
4535                                 unless exists $diff->{'from_file'};
4537                         if (!is_deleted($diff)) {
4538                                 # file exists in the result (child) commit
4539                                 print "<td>" .
4540                                       $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4541                                                              file_name=>$diff->{'to_file'},
4542                                                              hash_base=>$hash),
4543                                               -class => "list"}, esc_path($diff->{'to_file'})) .
4544                                       "</td>\n";
4545                         } else {
4546                                 print "<td>" .
4547                                       esc_path($diff->{'to_file'}) .
4548                                       "</td>\n";
4549                         }
4551                         if ($action eq 'commitdiff') {
4552                                 # link to patch
4553                                 $patchno++;
4554                                 print "<td class=\"link\">" .
4555                                       $cgi->a({-href => href(-anchor=>"patch$patchno")},
4556                                               "patch") .
4557                                       " | " .
4558                                       "</td>\n";
4559                         }
4561                         my $has_history = 0;
4562                         my $not_deleted = 0;
4563                         for (my $i = 0; $i < $diff->{'nparents'}; $i++) {
4564                                 my $hash_parent = $parents[$i];
4565                                 my $from_hash = $diff->{'from_id'}[$i];
4566                                 my $from_path = $diff->{'from_file'}[$i];
4567                                 my $status = $diff->{'status'}[$i];
4569                                 $has_history ||= ($status ne 'A');
4570                                 $not_deleted ||= ($status ne 'D');
4572                                 if ($status eq 'A') {
4573                                         print "<td  class=\"link\" align=\"right\"> | </td>\n";
4574                                 } elsif ($status eq 'D') {
4575                                         print "<td class=\"link\">" .
4576                                               $cgi->a({-href => href(action=>"blob",
4577                                                                      hash_base=>$hash,
4578                                                                      hash=>$from_hash,
4579                                                                      file_name=>$from_path)},
4580                                                       "blob" . ($i+1)) .
4581                                               " | </td>\n";
4582                                 } else {
4583                                         if ($diff->{'to_id'} eq $from_hash) {
4584                                                 print "<td class=\"link nochange\">";
4585                                         } else {
4586                                                 print "<td class=\"link\">";
4587                                         }
4588                                         print $cgi->a({-href => href(action=>"blobdiff",
4589                                                                      hash=>$diff->{'to_id'},
4590                                                                      hash_parent=>$from_hash,
4591                                                                      hash_base=>$hash,
4592                                                                      hash_parent_base=>$hash_parent,
4593                                                                      file_name=>$diff->{'to_file'},
4594                                                                      file_parent=>$from_path)},
4595                                                       "diff" . ($i+1)) .
4596                                               " | </td>\n";
4597                                 }
4598                         }
4600                         print "<td class=\"link\">";
4601                         if ($not_deleted) {
4602                                 print $cgi->a({-href => href(action=>"blob",
4603                                                              hash=>$diff->{'to_id'},
4604                                                              file_name=>$diff->{'to_file'},
4605                                                              hash_base=>$hash)},
4606                                               "blob");
4607                                 print " | " if ($has_history);
4608                         }
4609                         if ($has_history) {
4610                                 print $cgi->a({-href => href(action=>"history",
4611                                                              file_name=>$diff->{'to_file'},
4612                                                              hash_base=>$hash)},
4613                                               "history");
4614                         }
4615                         print "</td>\n";
4617                         print "</tr>\n";
4618                         next; # instead of 'else' clause, to avoid extra indent
4619                 }
4620                 # else ordinary diff
4622                 my ($to_mode_oct, $to_mode_str, $to_file_type);
4623                 my ($from_mode_oct, $from_mode_str, $from_file_type);
4624                 if ($diff->{'to_mode'} ne ('0' x 6)) {
4625                         $to_mode_oct = oct $diff->{'to_mode'};
4626                         if (S_ISREG($to_mode_oct)) { # only for regular file
4627                                 $to_mode_str = sprintf("%04o", $to_mode_oct & 0777); # permission bits
4628                         }
4629                         $to_file_type = file_type($diff->{'to_mode'});
4630                 }
4631                 if ($diff->{'from_mode'} ne ('0' x 6)) {
4632                         $from_mode_oct = oct $diff->{'from_mode'};
4633                         if (S_ISREG($from_mode_oct)) { # only for regular file
4634                                 $from_mode_str = sprintf("%04o", $from_mode_oct & 0777); # permission bits
4635                         }
4636                         $from_file_type = file_type($diff->{'from_mode'});
4637                 }
4639                 if ($diff->{'status'} eq "A") { # created
4640                         my $mode_chng = "<span class=\"file_status new\">[new $to_file_type";
4641                         $mode_chng   .= " with mode: $to_mode_str" if $to_mode_str;
4642                         $mode_chng   .= "]</span>";
4643                         print "<td>";
4644                         print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4645                                                      hash_base=>$hash, file_name=>$diff->{'file'}),
4646                                       -class => "list"}, esc_path($diff->{'file'}));
4647                         print "</td>\n";
4648                         print "<td>$mode_chng</td>\n";
4649                         print "<td class=\"link\">";
4650                         if ($action eq 'commitdiff') {
4651                                 # link to patch
4652                                 $patchno++;
4653                                 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
4654                                               "patch") .
4655                                       " | ";
4656                         }
4657                         print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4658                                                      hash_base=>$hash, file_name=>$diff->{'file'})},
4659                                       "blob");
4660                         print "</td>\n";
4662                 } elsif ($diff->{'status'} eq "D") { # deleted
4663                         my $mode_chng = "<span class=\"file_status deleted\">[deleted $from_file_type]</span>";
4664                         print "<td>";
4665                         print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'from_id'},
4666                                                      hash_base=>$parent, file_name=>$diff->{'file'}),
4667                                        -class => "list"}, esc_path($diff->{'file'}));
4668                         print "</td>\n";
4669                         print "<td>$mode_chng</td>\n";
4670                         print "<td class=\"link\">";
4671                         if ($action eq 'commitdiff') {
4672                                 # link to patch
4673                                 $patchno++;
4674                                 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
4675                                               "patch") .
4676                                       " | ";
4677                         }
4678                         print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'from_id'},
4679                                                      hash_base=>$parent, file_name=>$diff->{'file'})},
4680                                       "blob") . " | ";
4681                         if ($have_blame) {
4682                                 print $cgi->a({-href => href(action=>"blame", hash_base=>$parent,
4683                                                              file_name=>$diff->{'file'})},
4684                                               "blame") . " | ";
4685                         }
4686                         print $cgi->a({-href => href(action=>"history", hash_base=>$parent,
4687                                                      file_name=>$diff->{'file'})},
4688                                       "history");
4689                         print "</td>\n";
4691                 } elsif ($diff->{'status'} eq "M" || $diff->{'status'} eq "T") { # modified, or type changed
4692                         my $mode_chnge = "";
4693                         if ($diff->{'from_mode'} != $diff->{'to_mode'}) {
4694                                 $mode_chnge = "<span class=\"file_status mode_chnge\">[changed";
4695                                 if ($from_file_type ne $to_file_type) {
4696                                         $mode_chnge .= " from $from_file_type to $to_file_type";
4697                                 }
4698                                 if (($from_mode_oct & 0777) != ($to_mode_oct & 0777)) {
4699                                         if ($from_mode_str && $to_mode_str) {
4700                                                 $mode_chnge .= " mode: $from_mode_str->$to_mode_str";
4701                                         } elsif ($to_mode_str) {
4702                                                 $mode_chnge .= " mode: $to_mode_str";
4703                                         }
4704                                 }
4705                                 $mode_chnge .= "]</span>\n";
4706                         }
4707                         print "<td>";
4708                         print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4709                                                      hash_base=>$hash, file_name=>$diff->{'file'}),
4710                                       -class => "list"}, esc_path($diff->{'file'}));
4711                         print "</td>\n";
4712                         print "<td>$mode_chnge</td>\n";
4713                         print "<td class=\"link\">";
4714                         if ($action eq 'commitdiff') {
4715                                 # link to patch
4716                                 $patchno++;
4717                                 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
4718                                               "patch") .
4719                                       " | ";
4720                         } elsif ($diff->{'to_id'} ne $diff->{'from_id'}) {
4721                                 # "commit" view and modified file (not onlu mode changed)
4722                                 print $cgi->a({-href => href(action=>"blobdiff",
4723                                                              hash=>$diff->{'to_id'}, hash_parent=>$diff->{'from_id'},
4724                                                              hash_base=>$hash, hash_parent_base=>$parent,
4725                                                              file_name=>$diff->{'file'})},
4726                                               "diff") .
4727                                       " | ";
4728                         }
4729                         print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4730                                                      hash_base=>$hash, file_name=>$diff->{'file'})},
4731                                        "blob") . " | ";
4732                         if ($have_blame) {
4733                                 print $cgi->a({-href => href(action=>"blame", hash_base=>$hash,
4734                                                              file_name=>$diff->{'file'})},
4735                                               "blame") . " | ";
4736                         }
4737                         print $cgi->a({-href => href(action=>"history", hash_base=>$hash,
4738                                                      file_name=>$diff->{'file'})},
4739                                       "history");
4740                         print "</td>\n";
4742                 } elsif ($diff->{'status'} eq "R" || $diff->{'status'} eq "C") { # renamed or copied
4743                         my %status_name = ('R' => 'moved', 'C' => 'copied');
4744                         my $nstatus = $status_name{$diff->{'status'}};
4745                         my $mode_chng = "";
4746                         if ($diff->{'from_mode'} != $diff->{'to_mode'}) {
4747                                 # mode also for directories, so we cannot use $to_mode_str
4748                                 $mode_chng = sprintf(", mode: %04o", $to_mode_oct & 0777);
4749                         }
4750                         print "<td>" .
4751                               $cgi->a({-href => href(action=>"blob", hash_base=>$hash,
4752                                                      hash=>$diff->{'to_id'}, file_name=>$diff->{'to_file'}),
4753                                       -class => "list"}, esc_path($diff->{'to_file'})) . "</td>\n" .
4754                               "<td><span class=\"file_status $nstatus\">[$nstatus from " .
4755                               $cgi->a({-href => href(action=>"blob", hash_base=>$parent,
4756                                                      hash=>$diff->{'from_id'}, file_name=>$diff->{'from_file'}),
4757                                       -class => "list"}, esc_path($diff->{'from_file'})) .
4758                               " with " . (int $diff->{'similarity'}) . "% similarity$mode_chng]</span></td>\n" .
4759                               "<td class=\"link\">";
4760                         if ($action eq 'commitdiff') {
4761                                 # link to patch
4762                                 $patchno++;
4763                                 print $cgi->a({-href => href(-anchor=>"patch$patchno")},
4764                                               "patch") .
4765                                       " | ";
4766                         } elsif ($diff->{'to_id'} ne $diff->{'from_id'}) {
4767                                 # "commit" view and modified file (not only pure rename or copy)
4768                                 print $cgi->a({-href => href(action=>"blobdiff",
4769                                                              hash=>$diff->{'to_id'}, hash_parent=>$diff->{'from_id'},
4770                                                              hash_base=>$hash, hash_parent_base=>$parent,
4771                                                              file_name=>$diff->{'to_file'}, file_parent=>$diff->{'from_file'})},
4772                                               "diff") .
4773                                       " | ";
4774                         }
4775                         print $cgi->a({-href => href(action=>"blob", hash=>$diff->{'to_id'},
4776                                                      hash_base=>$parent, file_name=>$diff->{'to_file'})},
4777                                       "blob") . " | ";
4778                         if ($have_blame) {
4779                                 print $cgi->a({-href => href(action=>"blame", hash_base=>$hash,
4780                                                              file_name=>$diff->{'to_file'})},
4781                                               "blame") . " | ";
4782                         }
4783                         print $cgi->a({-href => href(action=>"history", hash_base=>$hash,
4784                                                     file_name=>$diff->{'to_file'})},
4785                                       "history");
4786                         print "</td>\n";
4788                 } # we should not encounter Unmerged (U) or Unknown (X) status
4789                 print "</tr>\n";
4790         }
4791         print "</tbody>" if $has_header;
4792         print "</table>\n";
4795 sub git_patchset_body {
4796         my ($fd, $difftree, $hash, @hash_parents) = @_;
4797         my ($hash_parent) = $hash_parents[0];
4799         my $is_combined = (@hash_parents > 1);
4800         my $patch_idx = 0;
4801         my $patch_number = 0;
4802         my $patch_line;
4803         my $diffinfo;
4804         my $to_name;
4805         my (%from, %to);
4807         print "<div class=\"patchset\">\n";
4809         # skip to first patch
4810         while ($patch_line = <$fd>) {
4811                 chomp $patch_line;
4813                 last if ($patch_line =~ m/^diff /);
4814         }
4816  PATCH:
4817         while ($patch_line) {
4819                 # parse "git diff" header line
4820                 if ($patch_line =~ m/^diff --git (\"(?:[^\\\"]*(?:\\.[^\\\"]*)*)\"|[^ "]*) (.*)$/) {
4821                         # $1 is from_name, which we do not use
4822                         $to_name = unquote($2);
4823                         $to_name =~ s!^b/!!;
4824                 } elsif ($patch_line =~ m/^diff --(cc|combined) ("?.*"?)$/) {
4825                         # $1 is 'cc' or 'combined', which we do not use
4826                         $to_name = unquote($2);
4827                 } else {
4828                         $to_name = undef;
4829                 }
4831                 # check if current patch belong to current raw line
4832                 # and parse raw git-diff line if needed
4833                 if (is_patch_split($diffinfo, { 'to_file' => $to_name })) {
4834                         # this is continuation of a split patch
4835                         print "<div class=\"patch cont\">\n";
4836                 } else {
4837                         # advance raw git-diff output if needed
4838                         $patch_idx++ if defined $diffinfo;
4840                         # read and prepare patch information
4841                         $diffinfo = parsed_difftree_line($difftree->[$patch_idx]);
4843                         # compact combined diff output can have some patches skipped
4844                         # find which patch (using pathname of result) we are at now;
4845                         if ($is_combined) {
4846                                 while ($to_name ne $diffinfo->{'to_file'}) {
4847                                         print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n" .
4848                                               format_diff_cc_simplified($diffinfo, @hash_parents) .
4849                                               "</div>\n";  # class="patch"
4851                                         $patch_idx++;
4852                                         $patch_number++;
4854                                         last if $patch_idx > $#$difftree;
4855                                         $diffinfo = parsed_difftree_line($difftree->[$patch_idx]);
4856                                 }
4857                         }
4859                         # modifies %from, %to hashes
4860                         parse_from_to_diffinfo($diffinfo, \%from, \%to, @hash_parents);
4862                         # this is first patch for raw difftree line with $patch_idx index
4863                         # we index @$difftree array from 0, but number patches from 1
4864                         print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n";
4865                 }
4867                 # git diff header
4868                 #assert($patch_line =~ m/^diff /) if DEBUG;
4869                 #assert($patch_line !~ m!$/$!) if DEBUG; # is chomp-ed
4870                 $patch_number++;
4871                 # print "git diff" header
4872                 print format_git_diff_header_line($patch_line, $diffinfo,
4873                                                   \%from, \%to);
4875                 # print extended diff header
4876                 print "<div class=\"diff extended_header\">\n";
4877         EXTENDED_HEADER:
4878                 while ($patch_line = <$fd>) {
4879                         chomp $patch_line;
4881                         last EXTENDED_HEADER if ($patch_line =~ m/^--- |^diff /);
4883                         print format_extended_diff_header_line($patch_line, $diffinfo,
4884                                                                \%from, \%to);
4885                 }
4886                 print "</div>\n"; # class="diff extended_header"
4888                 # from-file/to-file diff header
4889                 if (! $patch_line) {
4890                         print "</div>\n"; # class="patch"
4891                         last PATCH;
4892                 }
4893                 next PATCH if ($patch_line =~ m/^diff /);
4894                 #assert($patch_line =~ m/^---/) if DEBUG;
4896                 my $last_patch_line = $patch_line;
4897                 $patch_line = <$fd>;
4898                 chomp $patch_line;
4899                 #assert($patch_line =~ m/^\+\+\+/) if DEBUG;
4901                 print format_diff_from_to_header($last_patch_line, $patch_line,
4902                                                  $diffinfo, \%from, \%to,
4903                                                  @hash_parents);
4905                 # the patch itself
4906         LINE:
4907                 while ($patch_line = <$fd>) {
4908                         chomp $patch_line;
4910                         next PATCH if ($patch_line =~ m/^diff /);
4912                         print format_diff_line($patch_line, \%from, \%to);
4913                 }
4915         } continue {
4916                 print "</div>\n"; # class="patch"
4917         }
4919         # for compact combined (--cc) format, with chunk and patch simplification
4920         # the patchset might be empty, but there might be unprocessed raw lines
4921         for (++$patch_idx if $patch_number > 0;
4922              $patch_idx < @$difftree;
4923              ++$patch_idx) {
4924                 # read and prepare patch information
4925                 $diffinfo = parsed_difftree_line($difftree->[$patch_idx]);
4927                 # generate anchor for "patch" links in difftree / whatchanged part
4928                 print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n" .
4929                       format_diff_cc_simplified($diffinfo, @hash_parents) .
4930                       "</div>\n";  # class="patch"
4932                 $patch_number++;
4933         }
4935         if ($patch_number == 0) {
4936                 if (@hash_parents > 1) {
4937                         print "<div class=\"diff nodifferences\">Trivial merge</div>\n";
4938                 } else {
4939                         print "<div class=\"diff nodifferences\">No differences found</div>\n";
4940                 }
4941         }
4943         print "</div>\n"; # class="patchset"
4946 # . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4948 # fills project list info (age, description, owner, category, forks)
4949 # for each project in the list, removing invalid projects from
4950 # returned list
4951 # NOTE: modifies $projlist, but does not remove entries from it
4952 sub fill_project_list_info {
4953         my $projlist = shift;
4954         my @projects;
4956         my $show_ctags = gitweb_check_feature('ctags');
4957  PROJECT:
4958         foreach my $pr (@$projlist) {
4959                 my (@activity) = git_get_last_activity($pr->{'path'});
4960                 unless (@activity) {
4961                         next PROJECT;
4962                 }
4963                 ($pr->{'age'}, $pr->{'age_string'}) = @activity;
4964                 if (!defined $pr->{'descr'}) {
4965                         my $descr = git_get_project_description($pr->{'path'}) || "";
4966                         $descr = to_utf8($descr);
4967                         $pr->{'descr_long'} = $descr;
4968                         $pr->{'descr'} = chop_str($descr, $projects_list_description_width, 5);
4969                 }
4970                 if (!defined $pr->{'owner'}) {
4971                         $pr->{'owner'} = git_get_project_owner("$pr->{'path'}") || "";
4972                 }
4973                 if ($show_ctags) {
4974                         $pr->{'ctags'} = git_get_project_ctags($pr->{'path'});
4975                 }
4976                 if ($projects_list_group_categories && !defined $pr->{'category'}) {
4977                         my $cat = git_get_project_category($pr->{'path'}) ||
4978                                                            $project_list_default_category;
4979                         $pr->{'category'} = to_utf8($cat);
4980                 }
4982                 push @projects, $pr;
4983         }
4985         return @projects;
4988 sub sort_projects_list {
4989         my ($projlist, $order) = @_;
4990         my @projects;
4992         my %order_info = (
4993                 project => { key => 'path', type => 'str' },
4994                 descr => { key => 'descr_long', type => 'str' },
4995                 owner => { key => 'owner', type => 'str' },
4996                 age => { key => 'age', type => 'num' }
4997         );
4998         my $oi = $order_info{$order};
4999         return @$projlist unless defined $oi;
5000         if ($oi->{'type'} eq 'str') {
5001                 @projects = sort {$a->{$oi->{'key'}} cmp $b->{$oi->{'key'}}} @$projlist;
5002         } else {
5003                 @projects = sort {$a->{$oi->{'key'}} <=> $b->{$oi->{'key'}}} @$projlist;
5004         }
5006         return @projects;
5009 # returns a hash of categories, containing the list of project
5010 # belonging to each category
5011 sub build_projlist_by_category {
5012         my ($projlist, $from, $to) = @_;
5013         my %categories;
5015         $from = 0 unless defined $from;
5016         $to = $#$projlist if (!defined $to || $#$projlist < $to);
5018         for (my $i = $from; $i <= $to; $i++) {
5019                 my $pr = $projlist->[$i];
5020                 push @{$categories{ $pr->{'category'} }}, $pr;
5021         }
5023         return wantarray ? %categories : \%categories;
5026 # print 'sort by' <th> element, generating 'sort by $name' replay link
5027 # if that order is not selected
5028 sub print_sort_th {
5029         print format_sort_th(@_);
5032 sub format_sort_th {
5033         my ($name, $order, $header) = @_;
5034         my $sort_th = "";
5035         $header ||= ucfirst($name);
5037         if ($order eq $name) {
5038                 $sort_th .= "<th>$header</th>\n";
5039         } else {
5040                 $sort_th .= "<th>" .
5041                             $cgi->a({-href => href(-replay=>1, order=>$name),
5042                                      -class => "header"}, $header) .
5043                             "</th>\n";
5044         }
5046         return $sort_th;
5049 sub git_project_list_rows {
5050         my ($projlist, $from, $to, $check_forks) = @_;
5052         $from = 0 unless defined $from;
5053         $to = $#$projlist if (!defined $to || $#$projlist < $to);
5055         my $alternate = 1;
5056         for (my $i = $from; $i <= $to; $i++) {
5057                 my $pr = $projlist->[$i];
5059                 if ($alternate) {
5060                         print "<tr class=\"dark\">\n";
5061                 } else {
5062                         print "<tr class=\"light\">\n";
5063                 }
5064                 $alternate ^= 1;
5066                 if ($check_forks) {
5067                         print "<td>";
5068                         if ($pr->{'forks'}) {
5069                                 my $nforks = scalar @{$pr->{'forks'}};
5070                                 if ($nforks > 0) {
5071                                         print $cgi->a({-href => href(project=>$pr->{'path'}, action=>"forks"),
5072                                                        -title => "$nforks forks"}, "+");
5073                                 } else {
5074                                         print $cgi->span({-title => "$nforks forks"}, "+");
5075                                 }
5076                         }
5077                         print "</td>\n";
5078                 }
5079                 print "<td>" . $cgi->a({-href => href(project=>$pr->{'path'}, action=>"summary"),
5080                                         -class => "list"}, esc_html($pr->{'path'})) . "</td>\n" .
5081                       "<td>" . $cgi->a({-href => href(project=>$pr->{'path'}, action=>"summary"),
5082                                         -class => "list", -title => $pr->{'descr_long'}},
5083                                         esc_html($pr->{'descr'})) . "</td>\n" .
5084                       "<td><i>" . chop_and_escape_str($pr->{'owner'}, 15) . "</i></td>\n";
5085                 print "<td class=\"". age_class($pr->{'age'}) . "\">" .
5086                       (defined $pr->{'age_string'} ? $pr->{'age_string'} : "No commits") . "</td>\n" .
5087                       "<td class=\"link\">" .
5088                       $cgi->a({-href => href(project=>$pr->{'path'}, action=>"summary")}, "summary")   . " | " .
5089                       $cgi->a({-href => href(project=>$pr->{'path'}, action=>"shortlog")}, "shortlog") . " | " .
5090                       $cgi->a({-href => href(project=>$pr->{'path'}, action=>"log")}, "log") . " | " .
5091                       $cgi->a({-href => href(project=>$pr->{'path'}, action=>"tree")}, "tree") .
5092                       ($pr->{'forks'} ? " | " . $cgi->a({-href => href(project=>$pr->{'path'}, action=>"forks")}, "forks") : '') .
5093                       "</td>\n" .
5094                       "</tr>\n";
5095         }
5098 sub git_project_list_body {
5099         # actually uses global variable $project
5100         my ($projlist, $order, $from, $to, $extra, $no_header) = @_;
5101         my @projects = @$projlist;
5103         my $check_forks = gitweb_check_feature('forks');
5104         my $show_ctags  = gitweb_check_feature('ctags');
5105         my $tagfilter = $show_ctags ? $cgi->param('by_tag') : undef;
5106         $check_forks = undef
5107                 if ($tagfilter || $searchtext);
5109         # filtering out forks before filling info allows to do less work
5110         @projects = filter_forks_from_projects_list(\@projects)
5111                 if ($check_forks);
5112         @projects = fill_project_list_info(\@projects);
5113         # searching projects require filling to be run before it
5114         @projects = search_projects_list(\@projects,
5115                                          'searchtext' => $searchtext,
5116                                          'tagfilter'  => $tagfilter)
5117                 if ($tagfilter || $searchtext);
5119         $order ||= $default_projects_order;
5120         $from = 0 unless defined $from;
5121         $to = $#projects if (!defined $to || $#projects < $to);
5123         # short circuit
5124         if ($from > $to) {
5125                 print "<center>\n".
5126                       "<b>No such projects found</b><br />\n".
5127                       "Click ".$cgi->a({-href=>href(project=>undef)},"here")." to view all projects<br />\n".
5128                       "</center>\n<br />\n";
5129                 return;
5130         }
5132         @projects = sort_projects_list(\@projects, $order);
5134         if ($show_ctags) {
5135                 my $ctags = git_gather_all_ctags(\@projects);
5136                 my $cloud = git_populate_project_tagcloud($ctags);
5137                 print git_show_project_tagcloud($cloud, 64);
5138         }
5140         print "<table class=\"project_list\">\n";
5141         unless ($no_header) {
5142                 print "<tr>\n";
5143                 if ($check_forks) {
5144                         print "<th></th>\n";
5145                 }
5146                 print_sort_th('project', $order, 'Project');
5147                 print_sort_th('descr', $order, 'Description');
5148                 print_sort_th('owner', $order, 'Owner');
5149                 print_sort_th('age', $order, 'Last Change');
5150                 print "<th></th>\n" . # for links
5151                       "</tr>\n";
5152         }
5154         if ($projects_list_group_categories) {
5155                 # only display categories with projects in the $from-$to window
5156                 @projects = sort {$a->{'category'} cmp $b->{'category'}} @projects[$from..$to];
5157                 my %categories = build_projlist_by_category(\@projects, $from, $to);
5158                 foreach my $cat (sort keys %categories) {
5159                         unless ($cat eq "") {
5160                                 print "<tr>\n";
5161                                 if ($check_forks) {
5162                                         print "<td></td>\n";
5163                                 }
5164                                 print "<td class=\"category\" colspan=\"5\">".esc_html($cat)."</td>\n";
5165                                 print "</tr>\n";
5166                         }
5168                         git_project_list_rows($categories{$cat}, undef, undef, $check_forks);
5169                 }
5170         } else {
5171                 git_project_list_rows(\@projects, $from, $to, $check_forks);
5172         }
5174         if (defined $extra) {
5175                 print "<tr>\n";
5176                 if ($check_forks) {
5177                         print "<td></td>\n";
5178                 }
5179                 print "<td colspan=\"5\">$extra</td>\n" .
5180                       "</tr>\n";
5181         }
5182         print "</table>\n";
5185 sub git_log_body {
5186         # uses global variable $project
5187         my ($commitlist, $from, $to, $refs, $extra) = @_;
5189         $from = 0 unless defined $from;
5190         $to = $#{$commitlist} if (!defined $to || $#{$commitlist} < $to);
5192         for (my $i = 0; $i <= $to; $i++) {
5193                 my %co = %{$commitlist->[$i]};
5194                 next if !%co;
5195                 my $commit = $co{'id'};
5196                 my $ref = format_ref_marker($refs, $commit);
5197                 git_print_header_div('commit',
5198                                "<span class=\"age\">$co{'age_string'}</span>" .
5199                                esc_html($co{'title'}) . $ref,
5200                                $commit);
5201                 print "<div class=\"title_text\">\n" .
5202                       "<div class=\"log_link\">\n" .
5203                       $cgi->a({-href => href(action=>"commit", hash=>$commit)}, "commit") .
5204                       " | " .
5205                       $cgi->a({-href => href(action=>"commitdiff", hash=>$commit)}, "commitdiff") .
5206                       " | " .
5207                       $cgi->a({-href => href(action=>"tree", hash=>$commit, hash_base=>$commit)}, "tree") .
5208                       "<br/>\n" .
5209                       "</div>\n";
5210                       git_print_authorship(\%co, -tag => 'span');
5211                       print "<br/>\n</div>\n";
5213                 print "<div class=\"log_body\">\n";
5214                 git_print_log($co{'comment'}, -final_empty_line=> 1);
5215                 print "</div>\n";
5216         }
5217         if ($extra) {
5218                 print "<div class=\"page_nav\">\n";
5219                 print "$extra\n";
5220                 print "</div>\n";
5221         }
5224 sub git_shortlog_body {
5225         # uses global variable $project
5226         my ($commitlist, $from, $to, $refs, $extra) = @_;
5228         $from = 0 unless defined $from;
5229         $to = $#{$commitlist} if (!defined $to || $#{$commitlist} < $to);
5231         print "<table class=\"shortlog\">\n";
5232         my $alternate = 1;
5233         for (my $i = $from; $i <= $to; $i++) {
5234                 my %co = %{$commitlist->[$i]};
5235                 my $commit = $co{'id'};
5236                 my $ref = format_ref_marker($refs, $commit);
5237                 if ($alternate) {
5238                         print "<tr class=\"dark\">\n";
5239                 } else {
5240                         print "<tr class=\"light\">\n";
5241                 }
5242                 $alternate ^= 1;
5243                 # git_summary() used print "<td><i>$co{'age_string'}</i></td>\n" .
5244                 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
5245                       format_author_html('td', \%co, 10) . "<td>";
5246                 print format_subject_html($co{'title'}, $co{'title_short'},
5247                                           href(action=>"commit", hash=>$commit), $ref);
5248                 print "</td>\n" .
5249                       "<td class=\"link\">" .
5250                       $cgi->a({-href => href(action=>"commit", hash=>$commit)}, "commit") . " | " .
5251                       $cgi->a({-href => href(action=>"commitdiff", hash=>$commit)}, "commitdiff") . " | " .
5252                       $cgi->a({-href => href(action=>"tree", hash=>$commit, hash_base=>$commit)}, "tree");
5253                 my $snapshot_links = format_snapshot_links($commit);
5254                 if (defined $snapshot_links) {
5255                         print " | " . $snapshot_links;
5256                 }
5257                 print "</td>\n" .
5258                       "</tr>\n";
5259         }
5260         if (defined $extra) {
5261                 print "<tr>\n" .
5262                       "<td colspan=\"4\">$extra</td>\n" .
5263                       "</tr>\n";
5264         }
5265         print "</table>\n";
5268 sub git_history_body {
5269         # Warning: assumes constant type (blob or tree) during history
5270         my ($commitlist, $from, $to, $refs, $extra,
5271             $file_name, $file_hash, $ftype) = @_;
5273         $from = 0 unless defined $from;
5274         $to = $#{$commitlist} unless (defined $to && $to <= $#{$commitlist});
5276         print "<table class=\"history\">\n";
5277         my $alternate = 1;
5278         for (my $i = $from; $i <= $to; $i++) {
5279                 my %co = %{$commitlist->[$i]};
5280                 if (!%co) {
5281                         next;
5282                 }
5283                 my $commit = $co{'id'};
5285                 my $ref = format_ref_marker($refs, $commit);
5287                 if ($alternate) {
5288                         print "<tr class=\"dark\">\n";
5289                 } else {
5290                         print "<tr class=\"light\">\n";
5291                 }
5292                 $alternate ^= 1;
5293                 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
5294         # shortlog:   format_author_html('td', \%co, 10)
5295                       format_author_html('td', \%co, 15, 3) . "<td>";
5296                 # originally git_history used chop_str($co{'title'}, 50)
5297                 print format_subject_html($co{'title'}, $co{'title_short'},
5298                                           href(action=>"commit", hash=>$commit), $ref);
5299                 print "</td>\n" .
5300                       "<td class=\"link\">" .
5301                       $cgi->a({-href => href(action=>$ftype, hash_base=>$commit, file_name=>$file_name)}, $ftype) . " | " .
5302                       $cgi->a({-href => href(action=>"commitdiff", hash=>$commit)}, "commitdiff");
5304                 if ($ftype eq 'blob') {
5305                         my $blob_current = $file_hash;
5306                         my $blob_parent  = git_get_hash_by_path($commit, $file_name);
5307                         if (defined $blob_current && defined $blob_parent &&
5308                                         $blob_current ne $blob_parent) {
5309                                 print " | " .
5310                                         $cgi->a({-href => href(action=>"blobdiff",
5311                                                                hash=>$blob_current, hash_parent=>$blob_parent,
5312                                                                hash_base=>$hash_base, hash_parent_base=>$commit,
5313                                                                file_name=>$file_name)},
5314                                                 "diff to current");
5315                         }
5316                 }
5317                 print "</td>\n" .
5318                       "</tr>\n";
5319         }
5320         if (defined $extra) {
5321                 print "<tr>\n" .
5322                       "<td colspan=\"4\">$extra</td>\n" .
5323                       "</tr>\n";
5324         }
5325         print "</table>\n";
5328 sub git_tags_body {
5329         # uses global variable $project
5330         my ($taglist, $from, $to, $extra) = @_;
5331         $from = 0 unless defined $from;
5332         $to = $#{$taglist} if (!defined $to || $#{$taglist} < $to);
5334         print "<table class=\"tags\">\n";
5335         my $alternate = 1;
5336         for (my $i = $from; $i <= $to; $i++) {
5337                 my $entry = $taglist->[$i];
5338                 my %tag = %$entry;
5339                 my $comment = $tag{'subject'};
5340                 my $comment_short;
5341                 if (defined $comment) {
5342                         $comment_short = chop_str($comment, 30, 5);
5343                 }
5344                 if ($alternate) {
5345                         print "<tr class=\"dark\">\n";
5346                 } else {
5347                         print "<tr class=\"light\">\n";
5348                 }
5349                 $alternate ^= 1;
5350                 if (defined $tag{'age'}) {
5351                         print "<td><i>$tag{'age'}</i></td>\n";
5352                 } else {
5353                         print "<td></td>\n";
5354                 }
5355                 print "<td>" .
5356                       $cgi->a({-href => href(action=>$tag{'reftype'}, hash=>$tag{'refid'}),
5357                                -class => "list name"}, esc_html($tag{'name'})) .
5358                       "</td>\n" .
5359                       "<td>";
5360                 if (defined $comment) {
5361                         print format_subject_html($comment, $comment_short,
5362                                                   href(action=>"tag", hash=>$tag{'id'}));
5363                 }
5364                 print "</td>\n" .
5365                       "<td class=\"selflink\">";
5366                 if ($tag{'type'} eq "tag") {
5367                         print $cgi->a({-href => href(action=>"tag", hash=>$tag{'id'})}, "tag");
5368                 } else {
5369                         print "&nbsp;";
5370                 }
5371                 print "</td>\n" .
5372                       "<td class=\"link\">" . " | " .
5373                       $cgi->a({-href => href(action=>$tag{'reftype'}, hash=>$tag{'refid'})}, $tag{'reftype'});
5374                 if ($tag{'reftype'} eq "commit") {
5375                         print " | " . $cgi->a({-href => href(action=>"shortlog", hash=>$tag{'fullname'})}, "shortlog") .
5376                               " | " . $cgi->a({-href => href(action=>"log", hash=>$tag{'fullname'})}, "log");
5377                 } elsif ($tag{'reftype'} eq "blob") {
5378                         print " | " . $cgi->a({-href => href(action=>"blob_plain", hash=>$tag{'refid'})}, "raw");
5379                 }
5380                 print "</td>\n" .
5381                       "</tr>";
5382         }
5383         if (defined $extra) {
5384                 print "<tr>\n" .
5385                       "<td colspan=\"5\">$extra</td>\n" .
5386                       "</tr>\n";
5387         }
5388         print "</table>\n";
5391 sub git_heads_body {
5392         # uses global variable $project
5393         my ($headlist, $head, $from, $to, $extra) = @_;
5394         $from = 0 unless defined $from;
5395         $to = $#{$headlist} if (!defined $to || $#{$headlist} < $to);
5397         print "<table class=\"heads\">\n";
5398         my $alternate = 1;
5399         for (my $i = $from; $i <= $to; $i++) {
5400                 my $entry = $headlist->[$i];
5401                 my %ref = %$entry;
5402                 my $curr = $ref{'id'} eq $head;
5403                 if ($alternate) {
5404                         print "<tr class=\"dark\">\n";
5405                 } else {
5406                         print "<tr class=\"light\">\n";
5407                 }
5408                 $alternate ^= 1;
5409                 print "<td><i>$ref{'age'}</i></td>\n" .
5410                       ($curr ? "<td class=\"current_head\">" : "<td>") .
5411                       $cgi->a({-href => href(action=>"shortlog", hash=>$ref{'fullname'}),
5412                                -class => "list name"},esc_html($ref{'name'})) .
5413                       "</td>\n" .
5414                       "<td class=\"link\">" .
5415                       $cgi->a({-href => href(action=>"shortlog", hash=>$ref{'fullname'})}, "shortlog") . " | " .
5416                       $cgi->a({-href => href(action=>"log", hash=>$ref{'fullname'})}, "log") . " | " .
5417                       $cgi->a({-href => href(action=>"tree", hash=>$ref{'fullname'}, hash_base=>$ref{'fullname'})}, "tree") .
5418                       "</td>\n" .
5419                       "</tr>";
5420         }
5421         if (defined $extra) {
5422                 print "<tr>\n" .
5423                       "<td colspan=\"3\">$extra</td>\n" .
5424                       "</tr>\n";
5425         }
5426         print "</table>\n";
5429 # Display a single remote block
5430 sub git_remote_block {
5431         my ($remote, $rdata, $limit, $head) = @_;
5433         my $heads = $rdata->{'heads'};
5434         my $fetch = $rdata->{'fetch'};
5435         my $push = $rdata->{'push'};
5437         my $urls_table = "<table class=\"projects_list\">\n" ;
5439         if (defined $fetch) {
5440                 if ($fetch eq $push) {
5441                         $urls_table .= format_repo_url("URL", $fetch);
5442                 } else {
5443                         $urls_table .= format_repo_url("Fetch URL", $fetch);
5444                         $urls_table .= format_repo_url("Push URL", $push) if defined $push;
5445                 }
5446         } elsif (defined $push) {
5447                 $urls_table .= format_repo_url("Push URL", $push);
5448         } else {
5449                 $urls_table .= format_repo_url("", "No remote URL");
5450         }
5452         $urls_table .= "</table>\n";
5454         my $dots;
5455         if (defined $limit && $limit < @$heads) {
5456                 $dots = $cgi->a({-href => href(action=>"remotes", hash=>$remote)}, "...");
5457         }
5459         print $urls_table;
5460         git_heads_body($heads, $head, 0, $limit, $dots);
5463 # Display a list of remote names with the respective fetch and push URLs
5464 sub git_remotes_list {
5465         my ($remotedata, $limit) = @_;
5466         print "<table class=\"heads\">\n";
5467         my $alternate = 1;
5468         my @remotes = sort keys %$remotedata;
5470         my $limited = $limit && $limit < @remotes;
5472         $#remotes = $limit - 1 if $limited;
5474         while (my $remote = shift @remotes) {
5475                 my $rdata = $remotedata->{$remote};
5476                 my $fetch = $rdata->{'fetch'};
5477                 my $push = $rdata->{'push'};
5478                 if ($alternate) {
5479                         print "<tr class=\"dark\">\n";
5480                 } else {
5481                         print "<tr class=\"light\">\n";
5482                 }
5483                 $alternate ^= 1;
5484                 print "<td>" .
5485                       $cgi->a({-href=> href(action=>'remotes', hash=>$remote),
5486                                -class=> "list name"},esc_html($remote)) .
5487                       "</td>";
5488                 print "<td class=\"link\">" .
5489                       (defined $fetch ? $cgi->a({-href=> $fetch}, "fetch") : "fetch") .
5490                       " | " .
5491                       (defined $push ? $cgi->a({-href=> $push}, "push") : "push") .
5492                       "</td>";
5494                 print "</tr>\n";
5495         }
5497         if ($limited) {
5498                 print "<tr>\n" .
5499                       "<td colspan=\"3\">" .
5500                       $cgi->a({-href => href(action=>"remotes")}, "...") .
5501                       "</td>\n" . "</tr>\n";
5502         }
5504         print "</table>";
5507 # Display remote heads grouped by remote, unless there are too many
5508 # remotes, in which case we only display the remote names
5509 sub git_remotes_body {
5510         my ($remotedata, $limit, $head) = @_;
5511         if ($limit and $limit < keys %$remotedata) {
5512                 git_remotes_list($remotedata, $limit);
5513         } else {
5514                 fill_remote_heads($remotedata);
5515                 while (my ($remote, $rdata) = each %$remotedata) {
5516                         git_print_section({-class=>"remote", -id=>$remote},
5517                                 ["remotes", $remote, $remote], sub {
5518                                         git_remote_block($remote, $rdata, $limit, $head);
5519                                 });
5520                 }
5521         }
5524 sub git_search_grep_body {
5525         my ($commitlist, $from, $to, $extra) = @_;
5526         $from = 0 unless defined $from;
5527         $to = $#{$commitlist} if (!defined $to || $#{$commitlist} < $to);
5529         print "<table class=\"commit_search\">\n";
5530         my $alternate = 1;
5531         for (my $i = $from; $i <= $to; $i++) {
5532                 my %co = %{$commitlist->[$i]};
5533                 if (!%co) {
5534                         next;
5535                 }
5536                 my $commit = $co{'id'};
5537                 if ($alternate) {
5538                         print "<tr class=\"dark\">\n";
5539                 } else {
5540                         print "<tr class=\"light\">\n";
5541                 }
5542                 $alternate ^= 1;
5543                 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
5544                       format_author_html('td', \%co, 15, 5) .
5545                       "<td>" .
5546                       $cgi->a({-href => href(action=>"commit", hash=>$co{'id'}),
5547                                -class => "list subject"},
5548                               chop_and_escape_str($co{'title'}, 50) . "<br/>");
5549                 my $comment = $co{'comment'};
5550                 foreach my $line (@$comment) {
5551                         if ($line =~ m/^(.*?)($search_regexp)(.*)$/i) {
5552                                 my ($lead, $match, $trail) = ($1, $2, $3);
5553                                 $match = chop_str($match, 70, 5, 'center');
5554                                 my $contextlen = int((80 - length($match))/2);
5555                                 $contextlen = 30 if ($contextlen > 30);
5556                                 $lead  = chop_str($lead,  $contextlen, 10, 'left');
5557                                 $trail = chop_str($trail, $contextlen, 10, 'right');
5559                                 $lead  = esc_html($lead);
5560                                 $match = esc_html($match);
5561                                 $trail = esc_html($trail);
5563                                 print "$lead<span class=\"match\">$match</span>$trail<br />";
5564                         }
5565                 }
5566                 print "</td>\n" .
5567                       "<td class=\"link\">" .
5568                       $cgi->a({-href => href(action=>"commit", hash=>$co{'id'})}, "commit") .
5569                       " | " .
5570                       $cgi->a({-href => href(action=>"commitdiff", hash=>$co{'id'})}, "commitdiff") .
5571                       " | " .
5572                       $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'}, hash_base=>$co{'id'})}, "tree");
5573                 print "</td>\n" .
5574                       "</tr>\n";
5575         }
5576         if (defined $extra) {
5577                 print "<tr>\n" .
5578                       "<td colspan=\"3\">$extra</td>\n" .
5579                       "</tr>\n";
5580         }
5581         print "</table>\n";
5584 ## ======================================================================
5585 ## ======================================================================
5586 ## actions
5588 sub git_project_list {
5589         my $order = $input_params{'order'};
5590         if (defined $order && $order !~ m/none|project|descr|owner|age/) {
5591                 die_error(400, "Unknown order parameter");
5592         }
5594         my @list = git_get_projects_list();
5595         if (!@list) {
5596                 die_error(404, "No projects found");
5597         }
5599         git_header_html();
5600         if (defined $home_text && -f $home_text) {
5601                 print "<div class=\"index_include\">\n";
5602                 insert_file($home_text);
5603                 print "</div>\n";
5604         }
5605         print $cgi->startform(-method => "get") .
5606               "<p class=\"projsearch\">Search:\n" .
5607               $cgi->textfield(-name => "s", -value => $searchtext) . "\n" .
5608               "</p>" .
5609               $cgi->end_form() . "\n";
5610         git_project_list_body(\@list, $order);
5611         git_footer_html();
5614 sub git_forks {
5615         my $order = $input_params{'order'};
5616         if (defined $order && $order !~ m/none|project|descr|owner|age/) {
5617                 die_error(400, "Unknown order parameter");
5618         }
5620         my @list = git_get_projects_list($project);
5621         if (!@list) {
5622                 die_error(404, "No forks found");
5623         }
5625         git_header_html();
5626         git_print_page_nav('','');
5627         git_print_header_div('summary', "$project forks");
5628         git_project_list_body(\@list, $order);
5629         git_footer_html();
5632 sub git_project_index {
5633         my @projects = git_get_projects_list();
5634         if (!@projects) {
5635                 die_error(404, "No projects found");
5636         }
5638         print $cgi->header(
5639                 -type => 'text/plain',
5640                 -charset => 'utf-8',
5641                 -content_disposition => 'inline; filename="index.aux"');
5643         foreach my $pr (@projects) {
5644                 if (!exists $pr->{'owner'}) {
5645                         $pr->{'owner'} = git_get_project_owner("$pr->{'path'}");
5646                 }
5648                 my ($path, $owner) = ($pr->{'path'}, $pr->{'owner'});
5649                 # quote as in CGI::Util::encode, but keep the slash, and use '+' for ' '
5650                 $path  =~ s/([^a-zA-Z0-9_.\-\/ ])/sprintf("%%%02X", ord($1))/eg;
5651                 $owner =~ s/([^a-zA-Z0-9_.\-\/ ])/sprintf("%%%02X", ord($1))/eg;
5652                 $path  =~ s/ /\+/g;
5653                 $owner =~ s/ /\+/g;
5655                 print "$path $owner\n";
5656         }
5659 sub git_summary {
5660         my $descr = git_get_project_description($project) || "none";
5661         my %co = parse_commit("HEAD");
5662         my %cd = %co ? parse_date($co{'committer_epoch'}, $co{'committer_tz'}) : ();
5663         my $head = $co{'id'};
5664         my $remote_heads = gitweb_check_feature('remote_heads');
5666         my $owner = git_get_project_owner($project);
5668         my $refs = git_get_references();
5669         # These get_*_list functions return one more to allow us to see if
5670         # there are more ...
5671         my @taglist  = git_get_tags_list(16);
5672         my @headlist = git_get_heads_list(16);
5673         my %remotedata = $remote_heads ? git_get_remotes_list() : ();
5674         my @forklist;
5675         my $check_forks = gitweb_check_feature('forks');
5677         if ($check_forks) {
5678                 # find forks of a project
5679                 @forklist = git_get_projects_list($project);
5680                 # filter out forks of forks
5681                 @forklist = filter_forks_from_projects_list(\@forklist)
5682                         if (@forklist);
5683         }
5685         git_header_html();
5686         git_print_page_nav('summary','', $head);
5688         print "<div class=\"title\">&nbsp;</div>\n";
5689         print "<table class=\"projects_list\">\n" .
5690               "<tr id=\"metadata_desc\"><td>description</td><td>" . esc_html($descr) . "</td></tr>\n" .
5691               "<tr id=\"metadata_owner\"><td>owner</td><td>" . esc_html($owner) . "</td></tr>\n";
5692         if (defined $cd{'rfc2822'}) {
5693                 print "<tr id=\"metadata_lchange\"><td>last change</td>" .
5694                       "<td>".format_timestamp_html(\%cd)."</td></tr>\n";
5695         }
5697         # use per project git URL list in $projectroot/$project/cloneurl
5698         # or make project git URL from git base URL and project name
5699         my $url_tag = "URL";
5700         my @url_list = git_get_project_url_list($project);
5701         @url_list = map { "$_/$project" } @git_base_url_list unless @url_list;
5702         foreach my $git_url (@url_list) {
5703                 next unless $git_url;
5704                 print format_repo_url($url_tag, $git_url);
5705                 $url_tag = "";
5706         }
5708         # Tag cloud
5709         my $show_ctags = gitweb_check_feature('ctags');
5710         if ($show_ctags) {
5711                 my $ctags = git_get_project_ctags($project);
5712                 if (%$ctags) {
5713                         # without ability to add tags, don't show if there are none
5714                         my $cloud = git_populate_project_tagcloud($ctags);
5715                         print "<tr id=\"metadata_ctags\">" .
5716                               "<td>content tags</td>" .
5717                               "<td>".git_show_project_tagcloud($cloud, 48)."</td>" .
5718                               "</tr>\n";
5719                 }
5720         }
5722         print "</table>\n";
5724         # If XSS prevention is on, we don't include README.html.
5725         # TODO: Allow a readme in some safe format.
5726         if (!$prevent_xss && -s "$projectroot/$project/README.html") {
5727                 print "<div class=\"title\">readme</div>\n" .
5728                       "<div class=\"readme\">\n";
5729                 insert_file("$projectroot/$project/README.html");
5730                 print "\n</div>\n"; # class="readme"
5731         }
5733         # we need to request one more than 16 (0..15) to check if
5734         # those 16 are all
5735         my @commitlist = $head ? parse_commits($head, 17) : ();
5736         if (@commitlist) {
5737                 git_print_header_div('shortlog');
5738                 git_shortlog_body(\@commitlist, 0, 15, $refs,
5739                                   $#commitlist <=  15 ? undef :
5740                                   $cgi->a({-href => href(action=>"shortlog")}, "..."));
5741         }
5743         if (@taglist) {
5744                 git_print_header_div('tags');
5745                 git_tags_body(\@taglist, 0, 15,
5746                               $#taglist <=  15 ? undef :
5747                               $cgi->a({-href => href(action=>"tags")}, "..."));
5748         }
5750         if (@headlist) {
5751                 git_print_header_div('heads');
5752                 git_heads_body(\@headlist, $head, 0, 15,
5753                                $#headlist <= 15 ? undef :
5754                                $cgi->a({-href => href(action=>"heads")}, "..."));
5755         }
5757         if (%remotedata) {
5758                 git_print_header_div('remotes');
5759                 git_remotes_body(\%remotedata, 15, $head);
5760         }
5762         if (@forklist) {
5763                 git_print_header_div('forks');
5764                 git_project_list_body(\@forklist, 'age', 0, 15,
5765                                       $#forklist <= 15 ? undef :
5766                                       $cgi->a({-href => href(action=>"forks")}, "..."),
5767                                       'no_header');
5768         }
5770         git_footer_html();
5773 sub git_tag {
5774         my %tag = parse_tag($hash);
5776         if (! %tag) {
5777                 die_error(404, "Unknown tag object");
5778         }
5780         my $head = git_get_head_hash($project);
5781         git_header_html();
5782         git_print_page_nav('','', $head,undef,$head);
5783         git_print_header_div('commit', esc_html($tag{'name'}), $hash);
5784         print "<div class=\"title_text\">\n" .
5785               "<table class=\"object_header\">\n" .
5786               "<tr>\n" .
5787               "<td>object</td>\n" .
5788               "<td>" . $cgi->a({-class => "list", -href => href(action=>$tag{'type'}, hash=>$tag{'object'})},
5789                                $tag{'object'}) . "</td>\n" .
5790               "<td class=\"link\">" . $cgi->a({-href => href(action=>$tag{'type'}, hash=>$tag{'object'})},
5791                                               $tag{'type'}) . "</td>\n" .
5792               "</tr>\n";
5793         if (defined($tag{'author'})) {
5794                 git_print_authorship_rows(\%tag, 'author');
5795         }
5796         print "</table>\n\n" .
5797               "</div>\n";
5798         print "<div class=\"page_body\">";
5799         my $comment = $tag{'comment'};
5800         foreach my $line (@$comment) {
5801                 chomp $line;
5802                 print esc_html($line, -nbsp=>1) . "<br/>\n";
5803         }
5804         print "</div>\n";
5805         git_footer_html();
5808 sub git_blame_common {
5809         my $format = shift || 'porcelain';
5810         if ($format eq 'porcelain' && $cgi->param('js')) {
5811                 $format = 'incremental';
5812                 $action = 'blame_incremental'; # for page title etc
5813         }
5815         # permissions
5816         gitweb_check_feature('blame')
5817                 or die_error(403, "Blame view not allowed");
5819         # error checking
5820         die_error(400, "No file name given") unless $file_name;
5821         $hash_base ||= git_get_head_hash($project);
5822         die_error(404, "Couldn't find base commit") unless $hash_base;
5823         my %co = parse_commit($hash_base)
5824                 or die_error(404, "Commit not found");
5825         my $ftype = "blob";
5826         if (!defined $hash) {
5827                 $hash = git_get_hash_by_path($hash_base, $file_name, "blob")
5828                         or die_error(404, "Error looking up file");
5829         } else {
5830                 $ftype = git_get_type($hash);
5831                 if ($ftype !~ "blob") {
5832                         die_error(400, "Object is not a blob");
5833                 }
5834         }
5836         my $fd;
5837         if ($format eq 'incremental') {
5838                 # get file contents (as base)
5839                 open $fd, "-|", git_cmd(), 'cat-file', 'blob', $hash
5840                         or die_error(500, "Open git-cat-file failed");
5841         } elsif ($format eq 'data') {
5842                 # run git-blame --incremental
5843                 open $fd, "-|", git_cmd(), "blame", "--incremental",
5844                         $hash_base, "--", $file_name
5845                         or die_error(500, "Open git-blame --incremental failed");
5846         } else {
5847                 # run git-blame --porcelain
5848                 open $fd, "-|", git_cmd(), "blame", '-p',
5849                         $hash_base, '--', $file_name
5850                         or die_error(500, "Open git-blame --porcelain failed");
5851         }
5853         # incremental blame data returns early
5854         if ($format eq 'data') {
5855                 print $cgi->header(
5856                         -type=>"text/plain", -charset => "utf-8",
5857                         -status=> "200 OK");
5858                 local $| = 1; # output autoflush
5859                 print while <$fd>;
5860                 close $fd
5861                         or print "ERROR $!\n";
5863                 print 'END';
5864                 if (defined $t0 && gitweb_check_feature('timed')) {
5865                         print ' '.
5866                               tv_interval($t0, [ gettimeofday() ]).
5867                               ' '.$number_of_git_cmds;
5868                 }
5869                 print "\n";
5871                 return;
5872         }
5874         # page header
5875         git_header_html();
5876         my $formats_nav =
5877                 $cgi->a({-href => href(action=>"blob", -replay=>1)},
5878                         "blob") .
5879                 " | ";
5880         if ($format eq 'incremental') {
5881                 $formats_nav .=
5882                         $cgi->a({-href => href(action=>"blame", javascript=>0, -replay=>1)},
5883                                 "blame") . " (non-incremental)";
5884         } else {
5885                 $formats_nav .=
5886                         $cgi->a({-href => href(action=>"blame_incremental", -replay=>1)},
5887                                 "blame") . " (incremental)";
5888         }
5889         $formats_nav .=
5890                 " | " .
5891                 $cgi->a({-href => href(action=>"history", -replay=>1)},
5892                         "history") .
5893                 " | " .
5894                 $cgi->a({-href => href(action=>$action, file_name=>$file_name)},
5895                         "HEAD");
5896         git_print_page_nav('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
5897         git_print_header_div('commit', esc_html($co{'title'}), $hash_base);
5898         git_print_page_path($file_name, $ftype, $hash_base);
5900         # page body
5901         if ($format eq 'incremental') {
5902                 print "<noscript>\n<div class=\"error\"><center><b>\n".
5903                       "This page requires JavaScript to run.\n Use ".
5904                       $cgi->a({-href => href(action=>'blame',javascript=>0,-replay=>1)},
5905                               'this page').
5906                       " instead.\n".
5907                       "</b></center></div>\n</noscript>\n";
5909                 print qq!<div id="progress_bar" style="width: 100%; background-color: yellow"></div>\n!;
5910         }
5912         print qq!<div class="page_body">\n!;
5913         print qq!<div id="progress_info">... / ...</div>\n!
5914                 if ($format eq 'incremental');
5915         print qq!<table id="blame_table" class="blame" width="100%">\n!.
5916               #qq!<col width="5.5em" /><col width="2.5em" /><col width="*" />\n!.
5917               qq!<thead>\n!.
5918               qq!<tr><th>Commit</th><th>Line</th><th>Data</th></tr>\n!.
5919               qq!</thead>\n!.
5920               qq!<tbody>\n!;
5922         my @rev_color = qw(light dark);
5923         my $num_colors = scalar(@rev_color);
5924         my $current_color = 0;
5926         if ($format eq 'incremental') {
5927                 my $color_class = $rev_color[$current_color];
5929                 #contents of a file
5930                 my $linenr = 0;
5931         LINE:
5932                 while (my $line = <$fd>) {
5933                         chomp $line;
5934                         $linenr++;
5936                         print qq!<tr id="l$linenr" class="$color_class">!.
5937                               qq!<td class="sha1"><a href=""> </a></td>!.
5938                               qq!<td class="linenr">!.
5939                               qq!<a class="linenr" href="">$linenr</a></td>!;
5940                         print qq!<td class="pre">! . esc_html($line) . "</td>\n";
5941                         print qq!</tr>\n!;
5942                 }
5944         } else { # porcelain, i.e. ordinary blame
5945                 my %metainfo = (); # saves information about commits
5947                 # blame data
5948         LINE:
5949                 while (my $line = <$fd>) {
5950                         chomp $line;
5951                         # the header: <SHA-1> <src lineno> <dst lineno> [<lines in group>]
5952                         # no <lines in group> for subsequent lines in group of lines
5953                         my ($full_rev, $orig_lineno, $lineno, $group_size) =
5954                            ($line =~ /^([0-9a-f]{40}) (\d+) (\d+)(?: (\d+))?$/);
5955                         if (!exists $metainfo{$full_rev}) {
5956                                 $metainfo{$full_rev} = { 'nprevious' => 0 };
5957                         }
5958                         my $meta = $metainfo{$full_rev};
5959                         my $data;
5960                         while ($data = <$fd>) {
5961                                 chomp $data;
5962                                 last if ($data =~ s/^\t//); # contents of line
5963                                 if ($data =~ /^(\S+)(?: (.*))?$/) {
5964                                         $meta->{$1} = $2 unless exists $meta->{$1};
5965                                 }
5966                                 if ($data =~ /^previous /) {
5967                                         $meta->{'nprevious'}++;
5968                                 }
5969                         }
5970                         my $short_rev = substr($full_rev, 0, 8);
5971                         my $author = $meta->{'author'};
5972                         my %date =
5973                                 parse_date($meta->{'author-time'}, $meta->{'author-tz'});
5974                         my $date = $date{'iso-tz'};
5975                         if ($group_size) {
5976                                 $current_color = ($current_color + 1) % $num_colors;
5977                         }
5978                         my $tr_class = $rev_color[$current_color];
5979                         $tr_class .= ' boundary' if (exists $meta->{'boundary'});
5980                         $tr_class .= ' no-previous' if ($meta->{'nprevious'} == 0);
5981                         $tr_class .= ' multiple-previous' if ($meta->{'nprevious'} > 1);
5982                         print "<tr id=\"l$lineno\" class=\"$tr_class\">\n";
5983                         if ($group_size) {
5984                                 print "<td class=\"sha1\"";
5985                                 print " title=\"". esc_html($author) . ", $date\"";
5986                                 print " rowspan=\"$group_size\"" if ($group_size > 1);
5987                                 print ">";
5988                                 print $cgi->a({-href => href(action=>"commit",
5989                                                              hash=>$full_rev,
5990                                                              file_name=>$file_name)},
5991                                               esc_html($short_rev));
5992                                 if ($group_size >= 2) {
5993                                         my @author_initials = ($author =~ /\b([[:upper:]])\B/g);
5994                                         if (@author_initials) {
5995                                                 print "<br />" .
5996                                                       esc_html(join('', @author_initials));
5997                                                 #           or join('.', ...)
5998                                         }
5999                                 }
6000                                 print "</td>\n";
6001                         }
6002                         # 'previous' <sha1 of parent commit> <filename at commit>
6003                         if (exists $meta->{'previous'} &&
6004                             $meta->{'previous'} =~ /^([a-fA-F0-9]{40}) (.*)$/) {
6005                                 $meta->{'parent'} = $1;
6006                                 $meta->{'file_parent'} = unquote($2);
6007                         }
6008                         my $linenr_commit =
6009                                 exists($meta->{'parent'}) ?
6010                                 $meta->{'parent'} : $full_rev;
6011                         my $linenr_filename =
6012                                 exists($meta->{'file_parent'}) ?
6013                                 $meta->{'file_parent'} : unquote($meta->{'filename'});
6014                         my $blamed = href(action => 'blame',
6015                                           file_name => $linenr_filename,
6016                                           hash_base => $linenr_commit);
6017                         print "<td class=\"linenr\">";
6018                         print $cgi->a({ -href => "$blamed#l$orig_lineno",
6019                                         -class => "linenr" },
6020                                       esc_html($lineno));
6021                         print "</td>";
6022                         print "<td class=\"pre\">" . esc_html($data) . "</td>\n";
6023                         print "</tr>\n";
6024                 } # end while
6026         }
6028         # footer
6029         print "</tbody>\n".
6030               "</table>\n"; # class="blame"
6031         print "</div>\n";   # class="blame_body"
6032         close $fd
6033                 or print "Reading blob failed\n";
6035         git_footer_html();
6038 sub git_blame {
6039         git_blame_common();
6042 sub git_blame_incremental {
6043         git_blame_common('incremental');
6046 sub git_blame_data {
6047         git_blame_common('data');
6050 sub git_tags {
6051         my $head = git_get_head_hash($project);
6052         git_header_html();
6053         git_print_page_nav('','', $head,undef,$head,format_ref_views('tags'));
6054         git_print_header_div('summary', $project);
6056         my @tagslist = git_get_tags_list();
6057         if (@tagslist) {
6058                 git_tags_body(\@tagslist);
6059         }
6060         git_footer_html();
6063 sub git_heads {
6064         my $head = git_get_head_hash($project);
6065         git_header_html();
6066         git_print_page_nav('','', $head,undef,$head,format_ref_views('heads'));
6067         git_print_header_div('summary', $project);
6069         my @headslist = git_get_heads_list();
6070         if (@headslist) {
6071                 git_heads_body(\@headslist, $head);
6072         }
6073         git_footer_html();
6076 # used both for single remote view and for list of all the remotes
6077 sub git_remotes {
6078         gitweb_check_feature('remote_heads')
6079                 or die_error(403, "Remote heads view is disabled");
6081         my $head = git_get_head_hash($project);
6082         my $remote = $input_params{'hash'};
6084         my $remotedata = git_get_remotes_list($remote);
6085         die_error(500, "Unable to get remote information") unless defined $remotedata;
6087         unless (%$remotedata) {
6088                 die_error(404, defined $remote ?
6089                         "Remote $remote not found" :
6090                         "No remotes found");
6091         }
6093         git_header_html(undef, undef, -action_extra => $remote);
6094         git_print_page_nav('', '',  $head, undef, $head,
6095                 format_ref_views($remote ? '' : 'remotes'));
6097         fill_remote_heads($remotedata);
6098         if (defined $remote) {
6099                 git_print_header_div('remotes', "$remote remote for $project");
6100                 git_remote_block($remote, $remotedata->{$remote}, undef, $head);
6101         } else {
6102                 git_print_header_div('summary', "$project remotes");
6103                 git_remotes_body($remotedata, undef, $head);
6104         }
6106         git_footer_html();
6109 sub git_blob_plain {
6110         my $type = shift;
6111         my $expires;
6113         if (!defined $hash) {
6114                 if (defined $file_name) {
6115                         my $base = $hash_base || git_get_head_hash($project);
6116                         $hash = git_get_hash_by_path($base, $file_name, "blob")
6117                                 or die_error(404, "Cannot find file");
6118                 } else {
6119                         die_error(400, "No file name defined");
6120                 }
6121         } elsif ($hash =~ m/^[0-9a-fA-F]{40}$/) {
6122                 # blobs defined by non-textual hash id's can be cached
6123                 $expires = "+1d";
6124         }
6126         open my $fd, "-|", git_cmd(), "cat-file", "blob", $hash
6127                 or die_error(500, "Open git-cat-file blob '$hash' failed");
6129         # content-type (can include charset)
6130         $type = blob_contenttype($fd, $file_name, $type);
6132         # "save as" filename, even when no $file_name is given
6133         my $save_as = "$hash";
6134         if (defined $file_name) {
6135                 $save_as = $file_name;
6136         } elsif ($type =~ m/^text\//) {
6137                 $save_as .= '.txt';
6138         }
6140         # With XSS prevention on, blobs of all types except a few known safe
6141         # ones are served with "Content-Disposition: attachment" to make sure
6142         # they don't run in our security domain.  For certain image types,
6143         # blob view writes an <img> tag referring to blob_plain view, and we
6144         # want to be sure not to break that by serving the image as an
6145         # attachment (though Firefox 3 doesn't seem to care).
6146         my $sandbox = $prevent_xss &&
6147                 $type !~ m!^(?:text/[a-z]+|image/(?:gif|png|jpeg))(?:[ ;]|$)!;
6149         # serve text/* as text/plain
6150         if ($prevent_xss &&
6151             ($type =~ m!^text/[a-z]+\b(.*)$! ||
6152              ($type =~ m!^[a-z]+/[a-z]\+xml\b(.*)$! && -T $fd))) {
6153                 my $rest = $1;
6154                 $rest = defined $rest ? $rest : '';
6155                 $type = "text/plain$rest";
6156         }
6158         print $cgi->header(
6159                 -type => $type,
6160                 -expires => $expires,
6161                 -content_disposition =>
6162                         ($sandbox ? 'attachment' : 'inline')
6163                         . '; filename="' . $save_as . '"');
6164         local $/ = undef;
6165         binmode STDOUT, ':raw';
6166         print <$fd>;
6167         binmode STDOUT, ':utf8'; # as set at the beginning of gitweb.cgi
6168         close $fd;
6171 sub git_blob {
6172         my $expires;
6174         if (!defined $hash) {
6175                 if (defined $file_name) {
6176                         my $base = $hash_base || git_get_head_hash($project);
6177                         $hash = git_get_hash_by_path($base, $file_name, "blob")
6178                                 or die_error(404, "Cannot find file");
6179                 } else {
6180                         die_error(400, "No file name defined");
6181                 }
6182         } elsif ($hash =~ m/^[0-9a-fA-F]{40}$/) {
6183                 # blobs defined by non-textual hash id's can be cached
6184                 $expires = "+1d";
6185         }
6187         my $have_blame = gitweb_check_feature('blame');
6188         open my $fd, "-|", git_cmd(), "cat-file", "blob", $hash
6189                 or die_error(500, "Couldn't cat $file_name, $hash");
6190         my $mimetype = blob_mimetype($fd, $file_name);
6191         # use 'blob_plain' (aka 'raw') view for files that cannot be displayed
6192         if ($mimetype !~ m!^(?:text/|image/(?:gif|png|jpeg)$)! && -B $fd) {
6193                 close $fd;
6194                 return git_blob_plain($mimetype);
6195         }
6196         # we can have blame only for text/* mimetype
6197         $have_blame &&= ($mimetype =~ m!^text/!);
6199         my $highlight = gitweb_check_feature('highlight');
6200         my $syntax = guess_file_syntax($highlight, $mimetype, $file_name);
6201         $fd = run_highlighter($fd, $highlight, $syntax)
6202                 if $syntax;
6204         git_header_html(undef, $expires);
6205         my $formats_nav = '';
6206         if (defined $hash_base && (my %co = parse_commit($hash_base))) {
6207                 if (defined $file_name) {
6208                         if ($have_blame) {
6209                                 $formats_nav .=
6210                                         $cgi->a({-href => href(action=>"blame", -replay=>1)},
6211                                                 "blame") .
6212                                         " | ";
6213                         }
6214                         $formats_nav .=
6215                                 $cgi->a({-href => href(action=>"history", -replay=>1)},
6216                                         "history") .
6217                                 " | " .
6218                                 $cgi->a({-href => href(action=>"blob_plain", -replay=>1)},
6219                                         "raw") .
6220                                 " | " .
6221                                 $cgi->a({-href => href(action=>"blob",
6222                                                        hash_base=>"HEAD", file_name=>$file_name)},
6223                                         "HEAD");
6224                 } else {
6225                         $formats_nav .=
6226                                 $cgi->a({-href => href(action=>"blob_plain", -replay=>1)},
6227                                         "raw");
6228                 }
6229                 git_print_page_nav('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
6230                 git_print_header_div('commit', esc_html($co{'title'}), $hash_base);
6231         } else {
6232                 print "<div class=\"page_nav\">\n" .
6233                       "<br/><br/></div>\n" .
6234                       "<div class=\"title\">".esc_html($hash)."</div>\n";
6235         }
6236         git_print_page_path($file_name, "blob", $hash_base);
6237         print "<div class=\"page_body\">\n";
6238         if ($mimetype =~ m!^image/!) {
6239                 print qq!<img type="!.esc_attr($mimetype).qq!"!;
6240                 if ($file_name) {
6241                         print qq! alt="!.esc_attr($file_name).qq!" title="!.esc_attr($file_name).qq!"!;
6242                 }
6243                 print qq! src="! .
6244                       href(action=>"blob_plain", hash=>$hash,
6245                            hash_base=>$hash_base, file_name=>$file_name) .
6246                       qq!" />\n!;
6247         } else {
6248                 my $nr;
6249                 while (my $line = <$fd>) {
6250                         chomp $line;
6251                         $nr++;
6252                         $line = untabify($line);
6253                         printf qq!<div class="pre"><a id="l%i" href="%s#l%i" class="linenr">%4i</a> %s</div>\n!,
6254                                $nr, esc_attr(href(-replay => 1)), $nr, $nr, $syntax ? $line : esc_html($line, -nbsp=>1);
6255                 }
6256         }
6257         close $fd
6258                 or print "Reading blob failed.\n";
6259         print "</div>";
6260         git_footer_html();
6263 sub git_tree {
6264         if (!defined $hash_base) {
6265                 $hash_base = "HEAD";
6266         }
6267         if (!defined $hash) {
6268                 if (defined $file_name) {
6269                         $hash = git_get_hash_by_path($hash_base, $file_name, "tree");
6270                 } else {
6271                         $hash = $hash_base;
6272                 }
6273         }
6274         die_error(404, "No such tree") unless defined($hash);
6276         my $show_sizes = gitweb_check_feature('show-sizes');
6277         my $have_blame = gitweb_check_feature('blame');
6279         my @entries = ();
6280         {
6281                 local $/ = "\0";
6282                 open my $fd, "-|", git_cmd(), "ls-tree", '-z',
6283                         ($show_sizes ? '-l' : ()), @extra_options, $hash
6284                         or die_error(500, "Open git-ls-tree failed");
6285                 @entries = map { chomp; $_ } <$fd>;
6286                 close $fd
6287                         or die_error(404, "Reading tree failed");
6288         }
6290         my $refs = git_get_references();
6291         my $ref = format_ref_marker($refs, $hash_base);
6292         git_header_html();
6293         my $basedir = '';
6294         if (defined $hash_base && (my %co = parse_commit($hash_base))) {
6295                 my @views_nav = ();
6296                 if (defined $file_name) {
6297                         push @views_nav,
6298                                 $cgi->a({-href => href(action=>"history", -replay=>1)},
6299                                         "history"),
6300                                 $cgi->a({-href => href(action=>"tree",
6301                                                        hash_base=>"HEAD", file_name=>$file_name)},
6302                                         "HEAD"),
6303                 }
6304                 my $snapshot_links = format_snapshot_links($hash);
6305                 if (defined $snapshot_links) {
6306                         # FIXME: Should be available when we have no hash base as well.
6307                         push @views_nav, $snapshot_links;
6308                 }
6309                 git_print_page_nav('tree','', $hash_base, undef, undef,
6310                                    join(' | ', @views_nav));
6311                 git_print_header_div('commit', esc_html($co{'title'}) . $ref, $hash_base);
6312         } else {
6313                 undef $hash_base;
6314                 print "<div class=\"page_nav\">\n";
6315                 print "<br/><br/></div>\n";
6316                 print "<div class=\"title\">".esc_html($hash)."</div>\n";
6317         }
6318         if (defined $file_name) {
6319                 $basedir = $file_name;
6320                 if ($basedir ne '' && substr($basedir, -1) ne '/') {
6321                         $basedir .= '/';
6322                 }
6323                 git_print_page_path($file_name, 'tree', $hash_base);
6324         }
6325         print "<div class=\"page_body\">\n";
6326         print "<table class=\"tree\">\n";
6327         my $alternate = 1;
6328         # '..' (top directory) link if possible
6329         if (defined $hash_base &&
6330             defined $file_name && $file_name =~ m![^/]+$!) {
6331                 if ($alternate) {
6332                         print "<tr class=\"dark\">\n";
6333                 } else {
6334                         print "<tr class=\"light\">\n";
6335                 }
6336                 $alternate ^= 1;
6338                 my $up = $file_name;
6339                 $up =~ s!/?[^/]+$!!;
6340                 undef $up unless $up;
6341                 # based on git_print_tree_entry
6342                 print '<td class="mode">' . mode_str('040000') . "</td>\n";
6343                 print '<td class="size">&nbsp;</td>'."\n" if $show_sizes;
6344                 print '<td class="list">';
6345                 print $cgi->a({-href => href(action=>"tree",
6346                                              hash_base=>$hash_base,
6347                                              file_name=>$up)},
6348                               "..");
6349                 print "</td>\n";
6350                 print "<td class=\"link\"></td>\n";
6352                 print "</tr>\n";
6353         }
6354         foreach my $line (@entries) {
6355                 my %t = parse_ls_tree_line($line, -z => 1, -l => $show_sizes);
6357                 if ($alternate) {
6358                         print "<tr class=\"dark\">\n";
6359                 } else {
6360                         print "<tr class=\"light\">\n";
6361                 }
6362                 $alternate ^= 1;
6364                 git_print_tree_entry(\%t, $basedir, $hash_base, $have_blame);
6366                 print "</tr>\n";
6367         }
6368         print "</table>\n" .
6369               "</div>";
6370         git_footer_html();
6373 sub snapshot_name {
6374         my ($project, $hash) = @_;
6376         # path/to/project.git  -> project
6377         # path/to/project/.git -> project
6378         my $name = to_utf8($project);
6379         $name =~ s,([^/])/*\.git$,$1,;
6380         $name = basename($name);
6381         # sanitize name
6382         $name =~ s/[[:cntrl:]]/?/g;
6384         my $ver = $hash;
6385         if ($hash =~ /^[0-9a-fA-F]+$/) {
6386                 # shorten SHA-1 hash
6387                 my $full_hash = git_get_full_hash($project, $hash);
6388                 if ($full_hash =~ /^$hash/ && length($hash) > 7) {
6389                         $ver = git_get_short_hash($project, $hash);
6390                 }
6391         } elsif ($hash =~ m!^refs/tags/(.*)$!) {
6392                 # tags don't need shortened SHA-1 hash
6393                 $ver = $1;
6394         } else {
6395                 # branches and other need shortened SHA-1 hash
6396                 if ($hash =~ m!^refs/(?:heads|remotes)/(.*)$!) {
6397                         $ver = $1;
6398                 }
6399                 $ver .= '-' . git_get_short_hash($project, $hash);
6400         }
6401         # in case of hierarchical branch names
6402         $ver =~ s!/!.!g;
6404         # name = project-version_string
6405         $name = "$name-$ver";
6407         return wantarray ? ($name, $name) : $name;
6410 sub git_snapshot {
6411         my $format = $input_params{'snapshot_format'};
6412         if (!@snapshot_fmts) {
6413                 die_error(403, "Snapshots not allowed");
6414         }
6415         # default to first supported snapshot format
6416         $format ||= $snapshot_fmts[0];
6417         if ($format !~ m/^[a-z0-9]+$/) {
6418                 die_error(400, "Invalid snapshot format parameter");
6419         } elsif (!exists($known_snapshot_formats{$format})) {
6420                 die_error(400, "Unknown snapshot format");
6421         } elsif ($known_snapshot_formats{$format}{'disabled'}) {
6422                 die_error(403, "Snapshot format not allowed");
6423         } elsif (!grep($_ eq $format, @snapshot_fmts)) {
6424                 die_error(403, "Unsupported snapshot format");
6425         }
6427         my $type = git_get_type("$hash^{}");
6428         if (!$type) {
6429                 die_error(404, 'Object does not exist');
6430         }  elsif ($type eq 'blob') {
6431                 die_error(400, 'Object is not a tree-ish');
6432         }
6434         my ($name, $prefix) = snapshot_name($project, $hash);
6435         my $filename = "$name$known_snapshot_formats{$format}{'suffix'}";
6436         my $cmd = quote_command(
6437                 git_cmd(), 'archive',
6438                 "--format=$known_snapshot_formats{$format}{'format'}",
6439                 "--prefix=$prefix/", $hash);
6440         if (exists $known_snapshot_formats{$format}{'compressor'}) {
6441                 $cmd .= ' | ' . quote_command(@{$known_snapshot_formats{$format}{'compressor'}});
6442         }
6444         $filename =~ s/(["\\])/\\$1/g;
6445         print $cgi->header(
6446                 -type => $known_snapshot_formats{$format}{'type'},
6447                 -content_disposition => 'inline; filename="' . $filename . '"',
6448                 -status => '200 OK');
6450         open my $fd, "-|", $cmd
6451                 or die_error(500, "Execute git-archive failed");
6452         binmode STDOUT, ':raw';
6453         print <$fd>;
6454         binmode STDOUT, ':utf8'; # as set at the beginning of gitweb.cgi
6455         close $fd;
6458 sub git_log_generic {
6459         my ($fmt_name, $body_subr, $base, $parent, $file_name, $file_hash) = @_;
6461         my $head = git_get_head_hash($project);
6462         if (!defined $base) {
6463                 $base = $head;
6464         }
6465         if (!defined $page) {
6466                 $page = 0;
6467         }
6468         my $refs = git_get_references();
6470         my $commit_hash = $base;
6471         if (defined $parent) {
6472                 $commit_hash = "$parent..$base";
6473         }
6474         my @commitlist =
6475                 parse_commits($commit_hash, 101, (100 * $page),
6476                               defined $file_name ? ($file_name, "--full-history") : ());
6478         my $ftype;
6479         if (!defined $file_hash && defined $file_name) {
6480                 # some commits could have deleted file in question,
6481                 # and not have it in tree, but one of them has to have it
6482                 for (my $i = 0; $i < @commitlist; $i++) {
6483                         $file_hash = git_get_hash_by_path($commitlist[$i]{'id'}, $file_name);
6484                         last if defined $file_hash;
6485                 }
6486         }
6487         if (defined $file_hash) {
6488                 $ftype = git_get_type($file_hash);
6489         }
6490         if (defined $file_name && !defined $ftype) {
6491                 die_error(500, "Unknown type of object");
6492         }
6493         my %co;
6494         if (defined $file_name) {
6495                 %co = parse_commit($base)
6496                         or die_error(404, "Unknown commit object");
6497         }
6500         my $paging_nav = format_paging_nav($fmt_name, $page, $#commitlist >= 100);
6501         my $next_link = '';
6502         if ($#commitlist >= 100) {
6503                 $next_link =
6504                         $cgi->a({-href => href(-replay=>1, page=>$page+1),
6505                                  -accesskey => "n", -title => "Alt-n"}, "next");
6506         }
6507         my $patch_max = gitweb_get_feature('patches');
6508         if ($patch_max && !defined $file_name) {
6509                 if ($patch_max < 0 || @commitlist <= $patch_max) {
6510                         $paging_nav .= " &sdot; " .
6511                                 $cgi->a({-href => href(action=>"patches", -replay=>1)},
6512                                         "patches");
6513                 }
6514         }
6516         git_header_html();
6517         git_print_page_nav($fmt_name,'', $hash,$hash,$hash, $paging_nav);
6518         if (defined $file_name) {
6519                 git_print_header_div('commit', esc_html($co{'title'}), $base);
6520         } else {
6521                 git_print_header_div('summary', $project)
6522         }
6523         git_print_page_path($file_name, $ftype, $hash_base)
6524                 if (defined $file_name);
6526         $body_subr->(\@commitlist, 0, 99, $refs, $next_link,
6527                      $file_name, $file_hash, $ftype);
6529         git_footer_html();
6532 sub git_log {
6533         git_log_generic('log', \&git_log_body,
6534                         $hash, $hash_parent);
6537 sub git_commit {
6538         $hash ||= $hash_base || "HEAD";
6539         my %co = parse_commit($hash)
6540             or die_error(404, "Unknown commit object");
6542         my $parent  = $co{'parent'};
6543         my $parents = $co{'parents'}; # listref
6545         # we need to prepare $formats_nav before any parameter munging
6546         my $formats_nav;
6547         if (!defined $parent) {
6548                 # --root commitdiff
6549                 $formats_nav .= '(initial)';
6550         } elsif (@$parents == 1) {
6551                 # single parent commit
6552                 $formats_nav .=
6553                         '(parent: ' .
6554                         $cgi->a({-href => href(action=>"commit",
6555                                                hash=>$parent)},
6556                                 esc_html(substr($parent, 0, 7))) .
6557                         ')';
6558         } else {
6559                 # merge commit
6560                 $formats_nav .=
6561                         '(merge: ' .
6562                         join(' ', map {
6563                                 $cgi->a({-href => href(action=>"commit",
6564                                                        hash=>$_)},
6565                                         esc_html(substr($_, 0, 7)));
6566                         } @$parents ) .
6567                         ')';
6568         }
6569         if (gitweb_check_feature('patches') && @$parents <= 1) {
6570                 $formats_nav .= " | " .
6571                         $cgi->a({-href => href(action=>"patch", -replay=>1)},
6572                                 "patch");
6573         }
6575         if (!defined $parent) {
6576                 $parent = "--root";
6577         }
6578         my @difftree;
6579         open my $fd, "-|", git_cmd(), "diff-tree", '-r', "--no-commit-id",
6580                 @diff_opts,
6581                 (@$parents <= 1 ? $parent : '-c'),
6582                 $hash, "--"
6583                 or die_error(500, "Open git-diff-tree failed");
6584         @difftree = map { chomp; $_ } <$fd>;
6585         close $fd or die_error(404, "Reading git-diff-tree failed");
6587         # non-textual hash id's can be cached
6588         my $expires;
6589         if ($hash =~ m/^[0-9a-fA-F]{40}$/) {
6590                 $expires = "+1d";
6591         }
6592         my $refs = git_get_references();
6593         my $ref = format_ref_marker($refs, $co{'id'});
6595         git_header_html(undef, $expires);
6596         git_print_page_nav('commit', '',
6597                            $hash, $co{'tree'}, $hash,
6598                            $formats_nav);
6600         if (defined $co{'parent'}) {
6601                 git_print_header_div('commitdiff', esc_html($co{'title'}) . $ref, $hash);
6602         } else {
6603                 git_print_header_div('tree', esc_html($co{'title'}) . $ref, $co{'tree'}, $hash);
6604         }
6605         print "<div class=\"title_text\">\n" .
6606               "<table class=\"object_header\">\n";
6607         git_print_authorship_rows(\%co);
6608         print "<tr><td>commit</td><td class=\"sha1\">$co{'id'}</td></tr>\n";
6609         print "<tr>" .
6610               "<td>tree</td>" .
6611               "<td class=\"sha1\">" .
6612               $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'}, hash_base=>$hash),
6613                        class => "list"}, $co{'tree'}) .
6614               "</td>" .
6615               "<td class=\"link\">" .
6616               $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'}, hash_base=>$hash)},
6617                       "tree");
6618         my $snapshot_links = format_snapshot_links($hash);
6619         if (defined $snapshot_links) {
6620                 print " | " . $snapshot_links;
6621         }
6622         print "</td>" .
6623               "</tr>\n";
6625         foreach my $par (@$parents) {
6626                 print "<tr>" .
6627                       "<td>parent</td>" .
6628                       "<td class=\"sha1\">" .
6629                       $cgi->a({-href => href(action=>"commit", hash=>$par),
6630                                class => "list"}, $par) .
6631                       "</td>" .
6632                       "<td class=\"link\">" .
6633                       $cgi->a({-href => href(action=>"commit", hash=>$par)}, "commit") .
6634                       " | " .
6635                       $cgi->a({-href => href(action=>"commitdiff", hash=>$hash, hash_parent=>$par)}, "diff") .
6636                       "</td>" .
6637                       "</tr>\n";
6638         }
6639         print "</table>".
6640               "</div>\n";
6642         print "<div class=\"page_body\">\n";
6643         git_print_log($co{'comment'});
6644         print "</div>\n";
6646         git_difftree_body(\@difftree, $hash, @$parents);
6648         git_footer_html();
6651 sub git_object {
6652         # object is defined by:
6653         # - hash or hash_base alone
6654         # - hash_base and file_name
6655         my $type;
6657         # - hash or hash_base alone
6658         if ($hash || ($hash_base && !defined $file_name)) {
6659                 my $object_id = $hash || $hash_base;
6661                 open my $fd, "-|", quote_command(
6662                         git_cmd(), 'cat-file', '-t', $object_id) . ' 2> /dev/null'
6663                         or die_error(404, "Object does not exist");
6664                 $type = <$fd>;
6665                 chomp $type;
6666                 close $fd
6667                         or die_error(404, "Object does not exist");
6669         # - hash_base and file_name
6670         } elsif ($hash_base && defined $file_name) {
6671                 $file_name =~ s,/+$,,;
6673                 system(git_cmd(), "cat-file", '-e', $hash_base) == 0
6674                         or die_error(404, "Base object does not exist");
6676                 # here errors should not hapen
6677                 open my $fd, "-|", git_cmd(), "ls-tree", $hash_base, "--", $file_name
6678                         or die_error(500, "Open git-ls-tree failed");
6679                 my $line = <$fd>;
6680                 close $fd;
6682                 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa  panic.c'
6683                 unless ($line && $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t/) {
6684                         die_error(404, "File or directory for given base does not exist");
6685                 }
6686                 $type = $2;
6687                 $hash = $3;
6688         } else {
6689                 die_error(400, "Not enough information to find object");
6690         }
6692         print $cgi->redirect(-uri => href(action=>$type, -full=>1,
6693                                           hash=>$hash, hash_base=>$hash_base,
6694                                           file_name=>$file_name),
6695                              -status => '302 Found');
6698 sub git_blobdiff {
6699         my $format = shift || 'html';
6701         my $fd;
6702         my @difftree;
6703         my %diffinfo;
6704         my $expires;
6706         # preparing $fd and %diffinfo for git_patchset_body
6707         # new style URI
6708         if (defined $hash_base && defined $hash_parent_base) {
6709                 if (defined $file_name) {
6710                         # read raw output
6711                         open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
6712                                 $hash_parent_base, $hash_base,
6713                                 "--", (defined $file_parent ? $file_parent : ()), $file_name
6714                                 or die_error(500, "Open git-diff-tree failed");
6715                         @difftree = map { chomp; $_ } <$fd>;
6716                         close $fd
6717                                 or die_error(404, "Reading git-diff-tree failed");
6718                         @difftree
6719                                 or die_error(404, "Blob diff not found");
6721                 } elsif (defined $hash &&
6722                          $hash =~ /[0-9a-fA-F]{40}/) {
6723                         # try to find filename from $hash
6725                         # read filtered raw output
6726                         open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
6727                                 $hash_parent_base, $hash_base, "--"
6728                                 or die_error(500, "Open git-diff-tree failed");
6729                         @difftree =
6730                                 # ':100644 100644 03b21826... 3b93d5e7... M     ls-files.c'
6731                                 # $hash == to_id
6732                                 grep { /^:[0-7]{6} [0-7]{6} [0-9a-fA-F]{40} $hash/ }
6733                                 map { chomp; $_ } <$fd>;
6734                         close $fd
6735                                 or die_error(404, "Reading git-diff-tree failed");
6736                         @difftree
6737                                 or die_error(404, "Blob diff not found");
6739                 } else {
6740                         die_error(400, "Missing one of the blob diff parameters");
6741                 }
6743                 if (@difftree > 1) {
6744                         die_error(400, "Ambiguous blob diff specification");
6745                 }
6747                 %diffinfo = parse_difftree_raw_line($difftree[0]);
6748                 $file_parent ||= $diffinfo{'from_file'} || $file_name;
6749                 $file_name   ||= $diffinfo{'to_file'};
6751                 $hash_parent ||= $diffinfo{'from_id'};
6752                 $hash        ||= $diffinfo{'to_id'};
6754                 # non-textual hash id's can be cached
6755                 if ($hash_base =~ m/^[0-9a-fA-F]{40}$/ &&
6756                     $hash_parent_base =~ m/^[0-9a-fA-F]{40}$/) {
6757                         $expires = '+1d';
6758                 }
6760                 # open patch output
6761                 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
6762                         '-p', ($format eq 'html' ? "--full-index" : ()),
6763                         $hash_parent_base, $hash_base,
6764                         "--", (defined $file_parent ? $file_parent : ()), $file_name
6765                         or die_error(500, "Open git-diff-tree failed");
6766         }
6768         # old/legacy style URI -- not generated anymore since 1.4.3.
6769         if (!%diffinfo) {
6770                 die_error('404 Not Found', "Missing one of the blob diff parameters")
6771         }
6773         # header
6774         if ($format eq 'html') {
6775                 my $formats_nav =
6776                         $cgi->a({-href => href(action=>"blobdiff_plain", -replay=>1)},
6777                                 "raw");
6778                 git_header_html(undef, $expires);
6779                 if (defined $hash_base && (my %co = parse_commit($hash_base))) {
6780                         git_print_page_nav('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
6781                         git_print_header_div('commit', esc_html($co{'title'}), $hash_base);
6782                 } else {
6783                         print "<div class=\"page_nav\"><br/>$formats_nav<br/></div>\n";
6784                         print "<div class=\"title\">".esc_html("$hash vs $hash_parent")."</div>\n";
6785                 }
6786                 if (defined $file_name) {
6787                         git_print_page_path($file_name, "blob", $hash_base);
6788                 } else {
6789                         print "<div class=\"page_path\"></div>\n";
6790                 }
6792         } elsif ($format eq 'plain') {
6793                 print $cgi->header(
6794                         -type => 'text/plain',
6795                         -charset => 'utf-8',
6796                         -expires => $expires,
6797                         -content_disposition => 'inline; filename="' . "$file_name" . '.patch"');
6799                 print "X-Git-Url: " . $cgi->self_url() . "\n\n";
6801         } else {
6802                 die_error(400, "Unknown blobdiff format");
6803         }
6805         # patch
6806         if ($format eq 'html') {
6807                 print "<div class=\"page_body\">\n";
6809                 git_patchset_body($fd, [ \%diffinfo ], $hash_base, $hash_parent_base);
6810                 close $fd;
6812                 print "</div>\n"; # class="page_body"
6813                 git_footer_html();
6815         } else {
6816                 while (my $line = <$fd>) {
6817                         $line =~ s!a/($hash|$hash_parent)!'a/'.esc_path($diffinfo{'from_file'})!eg;
6818                         $line =~ s!b/($hash|$hash_parent)!'b/'.esc_path($diffinfo{'to_file'})!eg;
6820                         print $line;
6822                         last if $line =~ m!^\+\+\+!;
6823                 }
6824                 local $/ = undef;
6825                 print <$fd>;
6826                 close $fd;
6827         }
6830 sub git_blobdiff_plain {
6831         git_blobdiff('plain');
6834 sub git_commitdiff {
6835         my %params = @_;
6836         my $format = $params{-format} || 'html';
6838         my ($patch_max) = gitweb_get_feature('patches');
6839         if ($format eq 'patch') {
6840                 die_error(403, "Patch view not allowed") unless $patch_max;
6841         }
6843         $hash ||= $hash_base || "HEAD";
6844         my %co = parse_commit($hash)
6845             or die_error(404, "Unknown commit object");
6847         # choose format for commitdiff for merge
6848         if (! defined $hash_parent && @{$co{'parents'}} > 1) {
6849                 $hash_parent = '--cc';
6850         }
6851         # we need to prepare $formats_nav before almost any parameter munging
6852         my $formats_nav;
6853         if ($format eq 'html') {
6854                 $formats_nav =
6855                         $cgi->a({-href => href(action=>"commitdiff_plain", -replay=>1)},
6856                                 "raw");
6857                 if ($patch_max && @{$co{'parents'}} <= 1) {
6858                         $formats_nav .= " | " .
6859                                 $cgi->a({-href => href(action=>"patch", -replay=>1)},
6860                                         "patch");
6861                 }
6863                 if (defined $hash_parent &&
6864                     $hash_parent ne '-c' && $hash_parent ne '--cc') {
6865                         # commitdiff with two commits given
6866                         my $hash_parent_short = $hash_parent;
6867                         if ($hash_parent =~ m/^[0-9a-fA-F]{40}$/) {
6868                                 $hash_parent_short = substr($hash_parent, 0, 7);
6869                         }
6870                         $formats_nav .=
6871                                 ' (from';
6872                         for (my $i = 0; $i < @{$co{'parents'}}; $i++) {
6873                                 if ($co{'parents'}[$i] eq $hash_parent) {
6874                                         $formats_nav .= ' parent ' . ($i+1);
6875                                         last;
6876                                 }
6877                         }
6878                         $formats_nav .= ': ' .
6879                                 $cgi->a({-href => href(action=>"commitdiff",
6880                                                        hash=>$hash_parent)},
6881                                         esc_html($hash_parent_short)) .
6882                                 ')';
6883                 } elsif (!$co{'parent'}) {
6884                         # --root commitdiff
6885                         $formats_nav .= ' (initial)';
6886                 } elsif (scalar @{$co{'parents'}} == 1) {
6887                         # single parent commit
6888                         $formats_nav .=
6889                                 ' (parent: ' .
6890                                 $cgi->a({-href => href(action=>"commitdiff",
6891                                                        hash=>$co{'parent'})},
6892                                         esc_html(substr($co{'parent'}, 0, 7))) .
6893                                 ')';
6894                 } else {
6895                         # merge commit
6896                         if ($hash_parent eq '--cc') {
6897                                 $formats_nav .= ' | ' .
6898                                         $cgi->a({-href => href(action=>"commitdiff",
6899                                                                hash=>$hash, hash_parent=>'-c')},
6900                                                 'combined');
6901                         } else { # $hash_parent eq '-c'
6902                                 $formats_nav .= ' | ' .
6903                                         $cgi->a({-href => href(action=>"commitdiff",
6904                                                                hash=>$hash, hash_parent=>'--cc')},
6905                                                 'compact');
6906                         }
6907                         $formats_nav .=
6908                                 ' (merge: ' .
6909                                 join(' ', map {
6910                                         $cgi->a({-href => href(action=>"commitdiff",
6911                                                                hash=>$_)},
6912                                                 esc_html(substr($_, 0, 7)));
6913                                 } @{$co{'parents'}} ) .
6914                                 ')';
6915                 }
6916         }
6918         my $hash_parent_param = $hash_parent;
6919         if (!defined $hash_parent_param) {
6920                 # --cc for multiple parents, --root for parentless
6921                 $hash_parent_param =
6922                         @{$co{'parents'}} > 1 ? '--cc' : $co{'parent'} || '--root';
6923         }
6925         # read commitdiff
6926         my $fd;
6927         my @difftree;
6928         if ($format eq 'html') {
6929                 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
6930                         "--no-commit-id", "--patch-with-raw", "--full-index",
6931                         $hash_parent_param, $hash, "--"
6932                         or die_error(500, "Open git-diff-tree failed");
6934                 while (my $line = <$fd>) {
6935                         chomp $line;
6936                         # empty line ends raw part of diff-tree output
6937                         last unless $line;
6938                         push @difftree, scalar parse_difftree_raw_line($line);
6939                 }
6941         } elsif ($format eq 'plain') {
6942                 open $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
6943                         '-p', $hash_parent_param, $hash, "--"
6944                         or die_error(500, "Open git-diff-tree failed");
6945         } elsif ($format eq 'patch') {
6946                 # For commit ranges, we limit the output to the number of
6947                 # patches specified in the 'patches' feature.
6948                 # For single commits, we limit the output to a single patch,
6949                 # diverging from the git-format-patch default.
6950                 my @commit_spec = ();
6951                 if ($hash_parent) {
6952                         if ($patch_max > 0) {
6953                                 push @commit_spec, "-$patch_max";
6954                         }
6955                         push @commit_spec, '-n', "$hash_parent..$hash";
6956                 } else {
6957                         if ($params{-single}) {
6958                                 push @commit_spec, '-1';
6959                         } else {
6960                                 if ($patch_max > 0) {
6961                                         push @commit_spec, "-$patch_max";
6962                                 }
6963                                 push @commit_spec, "-n";
6964                         }
6965                         push @commit_spec, '--root', $hash;
6966                 }
6967                 open $fd, "-|", git_cmd(), "format-patch", @diff_opts,
6968                         '--encoding=utf8', '--stdout', @commit_spec
6969                         or die_error(500, "Open git-format-patch failed");
6970         } else {
6971                 die_error(400, "Unknown commitdiff format");
6972         }
6974         # non-textual hash id's can be cached
6975         my $expires;
6976         if ($hash =~ m/^[0-9a-fA-F]{40}$/) {
6977                 $expires = "+1d";
6978         }
6980         # write commit message
6981         if ($format eq 'html') {
6982                 my $refs = git_get_references();
6983                 my $ref = format_ref_marker($refs, $co{'id'});
6985                 git_header_html(undef, $expires);
6986                 git_print_page_nav('commitdiff','', $hash,$co{'tree'},$hash, $formats_nav);
6987                 git_print_header_div('commit', esc_html($co{'title'}) . $ref, $hash);
6988                 print "<div class=\"title_text\">\n" .
6989                       "<table class=\"object_header\">\n";
6990                 git_print_authorship_rows(\%co);
6991                 print "</table>".
6992                       "</div>\n";
6993                 print "<div class=\"page_body\">\n";
6994                 if (@{$co{'comment'}} > 1) {
6995                         print "<div class=\"log\">\n";
6996                         git_print_log($co{'comment'}, -final_empty_line=> 1, -remove_title => 1);
6997                         print "</div>\n"; # class="log"
6998                 }
7000         } elsif ($format eq 'plain') {
7001                 my $refs = git_get_references("tags");
7002                 my $tagname = git_get_rev_name_tags($hash);
7003                 my $filename = basename($project) . "-$hash.patch";
7005                 print $cgi->header(
7006                         -type => 'text/plain',
7007                         -charset => 'utf-8',
7008                         -expires => $expires,
7009                         -content_disposition => 'inline; filename="' . "$filename" . '"');
7010                 my %ad = parse_date($co{'author_epoch'}, $co{'author_tz'});
7011                 print "From: " . to_utf8($co{'author'}) . "\n";
7012                 print "Date: $ad{'rfc2822'} ($ad{'tz_local'})\n";
7013                 print "Subject: " . to_utf8($co{'title'}) . "\n";
7015                 print "X-Git-Tag: $tagname\n" if $tagname;
7016                 print "X-Git-Url: " . $cgi->self_url() . "\n\n";
7018                 foreach my $line (@{$co{'comment'}}) {
7019                         print to_utf8($line) . "\n";
7020                 }
7021                 print "---\n\n";
7022         } elsif ($format eq 'patch') {
7023                 my $filename = basename($project) . "-$hash.patch";
7025                 print $cgi->header(
7026                         -type => 'text/plain',
7027                         -charset => 'utf-8',
7028                         -expires => $expires,
7029                         -content_disposition => 'inline; filename="' . "$filename" . '"');
7030         }
7032         # write patch
7033         if ($format eq 'html') {
7034                 my $use_parents = !defined $hash_parent ||
7035                         $hash_parent eq '-c' || $hash_parent eq '--cc';
7036                 git_difftree_body(\@difftree, $hash,
7037                                   $use_parents ? @{$co{'parents'}} : $hash_parent);
7038                 print "<br/>\n";
7040                 git_patchset_body($fd, \@difftree, $hash,
7041                                   $use_parents ? @{$co{'parents'}} : $hash_parent);
7042                 close $fd;
7043                 print "</div>\n"; # class="page_body"
7044                 git_footer_html();
7046         } elsif ($format eq 'plain') {
7047                 local $/ = undef;
7048                 print <$fd>;
7049                 close $fd
7050                         or print "Reading git-diff-tree failed\n";
7051         } elsif ($format eq 'patch') {
7052                 local $/ = undef;
7053                 print <$fd>;
7054                 close $fd
7055                         or print "Reading git-format-patch failed\n";
7056         }
7059 sub git_commitdiff_plain {
7060         git_commitdiff(-format => 'plain');
7063 # format-patch-style patches
7064 sub git_patch {
7065         git_commitdiff(-format => 'patch', -single => 1);
7068 sub git_patches {
7069         git_commitdiff(-format => 'patch');
7072 sub git_history {
7073         git_log_generic('history', \&git_history_body,
7074                         $hash_base, $hash_parent_base,
7075                         $file_name, $hash);
7078 sub git_search {
7079         gitweb_check_feature('search') or die_error(403, "Search is disabled");
7080         if (!defined $searchtext) {
7081                 die_error(400, "Text field is empty");
7082         }
7083         if (!defined $hash) {
7084                 $hash = git_get_head_hash($project);
7085         }
7086         my %co = parse_commit($hash);
7087         if (!%co) {
7088                 die_error(404, "Unknown commit object");
7089         }
7090         if (!defined $page) {
7091                 $page = 0;
7092         }
7094         $searchtype ||= 'commit';
7095         if ($searchtype eq 'pickaxe') {
7096                 # pickaxe may take all resources of your box and run for several minutes
7097                 # with every query - so decide by yourself how public you make this feature
7098                 gitweb_check_feature('pickaxe')
7099                     or die_error(403, "Pickaxe is disabled");
7100         }
7101         if ($searchtype eq 'grep') {
7102                 gitweb_check_feature('grep')
7103                     or die_error(403, "Grep is disabled");
7104         }
7106         git_header_html();
7108         if ($searchtype eq 'commit' or $searchtype eq 'author' or $searchtype eq 'committer') {
7109                 my $greptype;
7110                 if ($searchtype eq 'commit') {
7111                         $greptype = "--grep=";
7112                 } elsif ($searchtype eq 'author') {
7113                         $greptype = "--author=";
7114                 } elsif ($searchtype eq 'committer') {
7115                         $greptype = "--committer=";
7116                 }
7117                 $greptype .= $searchtext;
7118                 my @commitlist = parse_commits($hash, 101, (100 * $page), undef,
7119                                                $greptype, '--regexp-ignore-case',
7120                                                $search_use_regexp ? '--extended-regexp' : '--fixed-strings');
7122                 my $paging_nav = '';
7123                 if ($page > 0) {
7124                         $paging_nav .=
7125                                 $cgi->a({-href => href(action=>"search", hash=>$hash,
7126                                                        searchtext=>$searchtext,
7127                                                        searchtype=>$searchtype)},
7128                                         "first");
7129                         $paging_nav .= " &sdot; " .
7130                                 $cgi->a({-href => href(-replay=>1, page=>$page-1),
7131                                          -accesskey => "p", -title => "Alt-p"}, "prev");
7132                 } else {
7133                         $paging_nav .= "first";
7134                         $paging_nav .= " &sdot; prev";
7135                 }
7136                 my $next_link = '';
7137                 if ($#commitlist >= 100) {
7138                         $next_link =
7139                                 $cgi->a({-href => href(-replay=>1, page=>$page+1),
7140                                          -accesskey => "n", -title => "Alt-n"}, "next");
7141                         $paging_nav .= " &sdot; $next_link";
7142                 } else {
7143                         $paging_nav .= " &sdot; next";
7144                 }
7146                 git_print_page_nav('','', $hash,$co{'tree'},$hash, $paging_nav);
7147                 git_print_header_div('commit', esc_html($co{'title'}), $hash);
7148                 if ($page == 0 && !@commitlist) {
7149                         print "<p>No match.</p>\n";
7150                 } else {
7151                         git_search_grep_body(\@commitlist, 0, 99, $next_link);
7152                 }
7153         }
7155         if ($searchtype eq 'pickaxe') {
7156                 git_print_page_nav('','', $hash,$co{'tree'},$hash);
7157                 git_print_header_div('commit', esc_html($co{'title'}), $hash);
7159                 print "<table class=\"pickaxe search\">\n";
7160                 my $alternate = 1;
7161                 local $/ = "\n";
7162                 open my $fd, '-|', git_cmd(), '--no-pager', 'log', @diff_opts,
7163                         '--pretty=format:%H', '--no-abbrev', '--raw', "-S$searchtext",
7164                         ($search_use_regexp ? '--pickaxe-regex' : ());
7165                 undef %co;
7166                 my @files;
7167                 while (my $line = <$fd>) {
7168                         chomp $line;
7169                         next unless $line;
7171                         my %set = parse_difftree_raw_line($line);
7172                         if (defined $set{'commit'}) {
7173                                 # finish previous commit
7174                                 if (%co) {
7175                                         print "</td>\n" .
7176                                               "<td class=\"link\">" .
7177                                               $cgi->a({-href => href(action=>"commit", hash=>$co{'id'})}, "commit") .
7178                                               " | " .
7179                                               $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'}, hash_base=>$co{'id'})}, "tree");
7180                                         print "</td>\n" .
7181                                               "</tr>\n";
7182                                 }
7184                                 if ($alternate) {
7185                                         print "<tr class=\"dark\">\n";
7186                                 } else {
7187                                         print "<tr class=\"light\">\n";
7188                                 }
7189                                 $alternate ^= 1;
7190                                 %co = parse_commit($set{'commit'});
7191                                 my $author = chop_and_escape_str($co{'author_name'}, 15, 5);
7192                                 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
7193                                       "<td><i>$author</i></td>\n" .
7194                                       "<td>" .
7195                                       $cgi->a({-href => href(action=>"commit", hash=>$co{'id'}),
7196                                               -class => "list subject"},
7197                                               chop_and_escape_str($co{'title'}, 50) . "<br/>");
7198                         } elsif (defined $set{'to_id'}) {
7199                                 next if ($set{'to_id'} =~ m/^0{40}$/);
7201                                 print $cgi->a({-href => href(action=>"blob", hash_base=>$co{'id'},
7202                                                              hash=>$set{'to_id'}, file_name=>$set{'to_file'}),
7203                                               -class => "list"},
7204                                               "<span class=\"match\">" . esc_path($set{'file'}) . "</span>") .
7205                                       "<br/>\n";
7206                         }
7207                 }
7208                 close $fd;
7210                 # finish last commit (warning: repetition!)
7211                 if (%co) {
7212                         print "</td>\n" .
7213                               "<td class=\"link\">" .
7214                               $cgi->a({-href => href(action=>"commit", hash=>$co{'id'})}, "commit") .
7215                               " | " .
7216                               $cgi->a({-href => href(action=>"tree", hash=>$co{'tree'}, hash_base=>$co{'id'})}, "tree");
7217                         print "</td>\n" .
7218                               "</tr>\n";
7219                 }
7221                 print "</table>\n";
7222         }
7224         if ($searchtype eq 'grep') {
7225                 git_print_page_nav('','', $hash,$co{'tree'},$hash);
7226                 git_print_header_div('commit', esc_html($co{'title'}), $hash);
7228                 print "<table class=\"grep_search\">\n";
7229                 my $alternate = 1;
7230                 my $matches = 0;
7231                 local $/ = "\n";
7232                 open my $fd, "-|", git_cmd(), 'grep', '-n',
7233                         $search_use_regexp ? ('-E', '-i') : '-F',
7234                         $searchtext, $co{'tree'};
7235                 my $lastfile = '';
7236                 while (my $line = <$fd>) {
7237                         chomp $line;
7238                         my ($file, $lno, $ltext, $binary);
7239                         last if ($matches++ > 1000);
7240                         if ($line =~ /^Binary file (.+) matches$/) {
7241                                 $file = $1;
7242                                 $binary = 1;
7243                         } else {
7244                                 (undef, $file, $lno, $ltext) = split(/:/, $line, 4);
7245                         }
7246                         if ($file ne $lastfile) {
7247                                 $lastfile and print "</td></tr>\n";
7248                                 if ($alternate++) {
7249                                         print "<tr class=\"dark\">\n";
7250                                 } else {
7251                                         print "<tr class=\"light\">\n";
7252                                 }
7253                                 print "<td class=\"list\">".
7254                                         $cgi->a({-href => href(action=>"blob", hash=>$co{'hash'},
7255                                                                file_name=>"$file"),
7256                                                 -class => "list"}, esc_path($file));
7257                                 print "</td><td>\n";
7258                                 $lastfile = $file;
7259                         }
7260                         if ($binary) {
7261                                 print "<div class=\"binary\">Binary file</div>\n";
7262                         } else {
7263                                 $ltext = untabify($ltext);
7264                                 if ($ltext =~ m/^(.*)($search_regexp)(.*)$/i) {
7265                                         $ltext = esc_html($1, -nbsp=>1);
7266                                         $ltext .= '<span class="match">';
7267                                         $ltext .= esc_html($2, -nbsp=>1);
7268                                         $ltext .= '</span>';
7269                                         $ltext .= esc_html($3, -nbsp=>1);
7270                                 } else {
7271                                         $ltext = esc_html($ltext, -nbsp=>1);
7272                                 }
7273                                 print "<div class=\"pre\">" .
7274                                         $cgi->a({-href => href(action=>"blob", hash=>$co{'hash'},
7275                                                                file_name=>"$file").'#l'.$lno,
7276                                                 -class => "linenr"}, sprintf('%4i', $lno))
7277                                         . ' ' .  $ltext . "</div>\n";
7278                         }
7279                 }
7280                 if ($lastfile) {
7281                         print "</td></tr>\n";
7282                         if ($matches > 1000) {
7283                                 print "<div class=\"diff nodifferences\">Too many matches, listing trimmed</div>\n";
7284                         }
7285                 } else {
7286                         print "<div class=\"diff nodifferences\">No matches found</div>\n";
7287                 }
7288                 close $fd;
7290                 print "</table>\n";
7291         }
7292         git_footer_html();
7295 sub git_search_help {
7296         git_header_html();
7297         git_print_page_nav('','', $hash,$hash,$hash);
7298         print <<EOT;
7299 <p><strong>Pattern</strong> is by default a normal string that is matched precisely (but without
7300 regard to case, except in the case of pickaxe). However, when you check the <em>re</em> checkbox,
7301 the pattern entered is recognized as the POSIX extended
7302 <a href="http://en.wikipedia.org/wiki/Regular_expression">regular expression</a> (also case
7303 insensitive).</p>
7304 <dl>
7305 <dt><b>commit</b></dt>
7306 <dd>The commit messages and authorship information will be scanned for the given pattern.</dd>
7307 EOT
7308         my $have_grep = gitweb_check_feature('grep');
7309         if ($have_grep) {
7310                 print <<EOT;
7311 <dt><b>grep</b></dt>
7312 <dd>All files in the currently selected tree (HEAD unless you are explicitly browsing
7313     a different one) are searched for the given pattern. On large trees, this search can take
7314 a while and put some strain on the server, so please use it with some consideration. Note that
7315 due to git-grep peculiarity, currently if regexp mode is turned off, the matches are
7316 case-sensitive.</dd>
7317 EOT
7318         }
7319         print <<EOT;
7320 <dt><b>author</b></dt>
7321 <dd>Name and e-mail of the change author and date of birth of the patch will be scanned for the given pattern.</dd>
7322 <dt><b>committer</b></dt>
7323 <dd>Name and e-mail of the committer and date of commit will be scanned for the given pattern.</dd>
7324 EOT
7325         my $have_pickaxe = gitweb_check_feature('pickaxe');
7326         if ($have_pickaxe) {
7327                 print <<EOT;
7328 <dt><b>pickaxe</b></dt>
7329 <dd>All commits that caused the string to appear or disappear from any file (changes that
7330 added, removed or "modified" the string) will be listed. This search can take a while and
7331 takes a lot of strain on the server, so please use it wisely. Note that since you may be
7332 interested even in changes just changing the case as well, this search is case sensitive.</dd>
7333 EOT
7334         }
7335         print "</dl>\n";
7336         git_footer_html();
7339 sub git_shortlog {
7340         git_log_generic('shortlog', \&git_shortlog_body,
7341                         $hash, $hash_parent);
7344 ## ......................................................................
7345 ## feeds (RSS, Atom; OPML)
7347 sub git_feed {
7348         my $format = shift || 'atom';
7349         my $have_blame = gitweb_check_feature('blame');
7351         # Atom: http://www.atomenabled.org/developers/syndication/
7352         # RSS:  http://www.notestips.com/80256B3A007F2692/1/NAMO5P9UPQ
7353         if ($format ne 'rss' && $format ne 'atom') {
7354                 die_error(400, "Unknown web feed format");
7355         }
7357         # log/feed of current (HEAD) branch, log of given branch, history of file/directory
7358         my $head = $hash || 'HEAD';
7359         my @commitlist = parse_commits($head, 150, 0, $file_name);
7361         my %latest_commit;
7362         my %latest_date;
7363         my $content_type = "application/$format+xml";
7364         if (defined $cgi->http('HTTP_ACCEPT') &&
7365                  $cgi->Accept('text/xml') > $cgi->Accept($content_type)) {
7366                 # browser (feed reader) prefers text/xml
7367                 $content_type = 'text/xml';
7368         }
7369         if (defined($commitlist[0])) {
7370                 %latest_commit = %{$commitlist[0]};
7371                 my $latest_epoch = $latest_commit{'committer_epoch'};
7372                 %latest_date   = parse_date($latest_epoch, $latest_commit{'comitter_tz'});
7373                 my $if_modified = $cgi->http('IF_MODIFIED_SINCE');
7374                 if (defined $if_modified) {
7375                         my $since;
7376                         if (eval { require HTTP::Date; 1; }) {
7377                                 $since = HTTP::Date::str2time($if_modified);
7378                         } elsif (eval { require Time::ParseDate; 1; }) {
7379                                 $since = Time::ParseDate::parsedate($if_modified, GMT => 1);
7380                         }
7381                         if (defined $since && $latest_epoch <= $since) {
7382                                 print $cgi->header(
7383                                         -type => $content_type,
7384                                         -charset => 'utf-8',
7385                                         -last_modified => $latest_date{'rfc2822'},
7386                                         -status => '304 Not Modified');
7387                                 return;
7388                         }
7389                 }
7390                 print $cgi->header(
7391                         -type => $content_type,
7392                         -charset => 'utf-8',
7393                         -last_modified => $latest_date{'rfc2822'});
7394         } else {
7395                 print $cgi->header(
7396                         -type => $content_type,
7397                         -charset => 'utf-8');
7398         }
7400         # Optimization: skip generating the body if client asks only
7401         # for Last-Modified date.
7402         return if ($cgi->request_method() eq 'HEAD');
7404         # header variables
7405         my $title = "$site_name - $project/$action";
7406         my $feed_type = 'log';
7407         if (defined $hash) {
7408                 $title .= " - '$hash'";
7409                 $feed_type = 'branch log';
7410                 if (defined $file_name) {
7411                         $title .= " :: $file_name";
7412                         $feed_type = 'history';
7413                 }
7414         } elsif (defined $file_name) {
7415                 $title .= " - $file_name";
7416                 $feed_type = 'history';
7417         }
7418         $title .= " $feed_type";
7419         my $descr = git_get_project_description($project);
7420         if (defined $descr) {
7421                 $descr = esc_html($descr);
7422         } else {
7423                 $descr = "$project " .
7424                          ($format eq 'rss' ? 'RSS' : 'Atom') .
7425                          " feed";
7426         }
7427         my $owner = git_get_project_owner($project);
7428         $owner = esc_html($owner);
7430         #header
7431         my $alt_url;
7432         if (defined $file_name) {
7433                 $alt_url = href(-full=>1, action=>"history", hash=>$hash, file_name=>$file_name);
7434         } elsif (defined $hash) {
7435                 $alt_url = href(-full=>1, action=>"log", hash=>$hash);
7436         } else {
7437                 $alt_url = href(-full=>1, action=>"summary");
7438         }
7439         print qq!<?xml version="1.0" encoding="utf-8"?>\n!;
7440         if ($format eq 'rss') {
7441                 print <<XML;
7442 <rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/">
7443 <channel>
7444 XML
7445                 print "<title>$title</title>\n" .
7446                       "<link>$alt_url</link>\n" .
7447                       "<description>$descr</description>\n" .
7448                       "<language>en</language>\n" .
7449                       # project owner is responsible for 'editorial' content
7450                       "<managingEditor>$owner</managingEditor>\n";
7451                 if (defined $logo || defined $favicon) {
7452                         # prefer the logo to the favicon, since RSS
7453                         # doesn't allow both
7454                         my $img = esc_url($logo || $favicon);
7455                         print "<image>\n" .
7456                               "<url>$img</url>\n" .
7457                               "<title>$title</title>\n" .
7458                               "<link>$alt_url</link>\n" .
7459                               "</image>\n";
7460                 }
7461                 if (%latest_date) {
7462                         print "<pubDate>$latest_date{'rfc2822'}</pubDate>\n";
7463                         print "<lastBuildDate>$latest_date{'rfc2822'}</lastBuildDate>\n";
7464                 }
7465                 print "<generator>gitweb v.$version/$git_version</generator>\n";
7466         } elsif ($format eq 'atom') {
7467                 print <<XML;
7468 <feed xmlns="http://www.w3.org/2005/Atom">
7469 XML
7470                 print "<title>$title</title>\n" .
7471                       "<subtitle>$descr</subtitle>\n" .
7472                       '<link rel="alternate" type="text/html" href="' .
7473                       $alt_url . '" />' . "\n" .
7474                       '<link rel="self" type="' . $content_type . '" href="' .
7475                       $cgi->self_url() . '" />' . "\n" .
7476                       "<id>" . href(-full=>1) . "</id>\n" .
7477                       # use project owner for feed author
7478                       "<author><name>$owner</name></author>\n";
7479                 if (defined $favicon) {
7480                         print "<icon>" . esc_url($favicon) . "</icon>\n";
7481                 }
7482                 if (defined $logo) {
7483                         # not twice as wide as tall: 72 x 27 pixels
7484                         print "<logo>" . esc_url($logo) . "</logo>\n";
7485                 }
7486                 if (! %latest_date) {
7487                         # dummy date to keep the feed valid until commits trickle in:
7488                         print "<updated>1970-01-01T00:00:00Z</updated>\n";
7489                 } else {
7490                         print "<updated>$latest_date{'iso-8601'}</updated>\n";
7491                 }
7492                 print "<generator version='$version/$git_version'>gitweb</generator>\n";
7493         }
7495         # contents
7496         for (my $i = 0; $i <= $#commitlist; $i++) {
7497                 my %co = %{$commitlist[$i]};
7498                 my $commit = $co{'id'};
7499                 # we read 150, we always show 30 and the ones more recent than 48 hours
7500                 if (($i >= 20) && ((time - $co{'author_epoch'}) > 48*60*60)) {
7501                         last;
7502                 }
7503                 my %cd = parse_date($co{'author_epoch'}, $co{'author_tz'});
7505                 # get list of changed files
7506                 open my $fd, "-|", git_cmd(), "diff-tree", '-r', @diff_opts,
7507                         $co{'parent'} || "--root",
7508                         $co{'id'}, "--", (defined $file_name ? $file_name : ())
7509                         or next;
7510                 my @difftree = map { chomp; $_ } <$fd>;
7511                 close $fd
7512                         or next;
7514                 # print element (entry, item)
7515                 my $co_url = href(-full=>1, action=>"commitdiff", hash=>$commit);
7516                 if ($format eq 'rss') {
7517                         print "<item>\n" .
7518                               "<title>" . esc_html($co{'title'}) . "</title>\n" .
7519                               "<author>" . esc_html($co{'author'}) . "</author>\n" .
7520                               "<pubDate>$cd{'rfc2822'}</pubDate>\n" .
7521                               "<guid isPermaLink=\"true\">$co_url</guid>\n" .
7522                               "<link>$co_url</link>\n" .
7523                               "<description>" . esc_html($co{'title'}) . "</description>\n" .
7524                               "<content:encoded>" .
7525                               "<![CDATA[\n";
7526                 } elsif ($format eq 'atom') {
7527                         print "<entry>\n" .
7528                               "<title type=\"html\">" . esc_html($co{'title'}) . "</title>\n" .
7529                               "<updated>$cd{'iso-8601'}</updated>\n" .
7530                               "<author>\n" .
7531                               "  <name>" . esc_html($co{'author_name'}) . "</name>\n";
7532                         if ($co{'author_email'}) {
7533                                 print "  <email>" . esc_html($co{'author_email'}) . "</email>\n";
7534                         }
7535                         print "</author>\n" .
7536                               # use committer for contributor
7537                               "<contributor>\n" .
7538                               "  <name>" . esc_html($co{'committer_name'}) . "</name>\n";
7539                         if ($co{'committer_email'}) {
7540                                 print "  <email>" . esc_html($co{'committer_email'}) . "</email>\n";
7541                         }
7542                         print "</contributor>\n" .
7543                               "<published>$cd{'iso-8601'}</published>\n" .
7544                               "<link rel=\"alternate\" type=\"text/html\" href=\"$co_url\" />\n" .
7545                               "<id>$co_url</id>\n" .
7546                               "<content type=\"xhtml\" xml:base=\"" . esc_url($my_url) . "\">\n" .
7547                               "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n";
7548                 }
7549                 my $comment = $co{'comment'};
7550                 print "<pre>\n";
7551                 foreach my $line (@$comment) {
7552                         $line = esc_html($line);
7553                         print "$line\n";
7554                 }
7555                 print "</pre><ul>\n";
7556                 foreach my $difftree_line (@difftree) {
7557                         my %difftree = parse_difftree_raw_line($difftree_line);
7558                         next if !$difftree{'from_id'};
7560                         my $file = $difftree{'file'} || $difftree{'to_file'};
7562                         print "<li>" .
7563                               "[" .
7564                               $cgi->a({-href => href(-full=>1, action=>"blobdiff",
7565                                                      hash=>$difftree{'to_id'}, hash_parent=>$difftree{'from_id'},
7566                                                      hash_base=>$co{'id'}, hash_parent_base=>$co{'parent'},
7567                                                      file_name=>$file, file_parent=>$difftree{'from_file'}),
7568                                       -title => "diff"}, 'D');
7569                         if ($have_blame) {
7570                                 print $cgi->a({-href => href(-full=>1, action=>"blame",
7571                                                              file_name=>$file, hash_base=>$commit),
7572                                               -title => "blame"}, 'B');
7573                         }
7574                         # if this is not a feed of a file history
7575                         if (!defined $file_name || $file_name ne $file) {
7576                                 print $cgi->a({-href => href(-full=>1, action=>"history",
7577                                                              file_name=>$file, hash=>$commit),
7578                                               -title => "history"}, 'H');
7579                         }
7580                         $file = esc_path($file);
7581                         print "] ".
7582                               "$file</li>\n";
7583                 }
7584                 if ($format eq 'rss') {
7585                         print "</ul>]]>\n" .
7586                               "</content:encoded>\n" .
7587                               "</item>\n";
7588                 } elsif ($format eq 'atom') {
7589                         print "</ul>\n</div>\n" .
7590                               "</content>\n" .
7591                               "</entry>\n";
7592                 }
7593         }
7595         # end of feed
7596         if ($format eq 'rss') {
7597                 print "</channel>\n</rss>\n";
7598         } elsif ($format eq 'atom') {
7599                 print "</feed>\n";
7600         }
7603 sub git_rss {
7604         git_feed('rss');
7607 sub git_atom {
7608         git_feed('atom');
7611 sub git_opml {
7612         my @list = git_get_projects_list();
7613         if (!@list) {
7614                 die_error(404, "No projects found");
7615         }
7617         print $cgi->header(
7618                 -type => 'text/xml',
7619                 -charset => 'utf-8',
7620                 -content_disposition => 'inline; filename="opml.xml"');
7622         print <<XML;
7623 <?xml version="1.0" encoding="utf-8"?>
7624 <opml version="1.0">
7625 <head>
7626   <title>$site_name OPML Export</title>
7627 </head>
7628 <body>
7629 <outline text="git RSS feeds">
7630 XML
7632         foreach my $pr (@list) {
7633                 my %proj = %$pr;
7634                 my $head = git_get_head_hash($proj{'path'});
7635                 if (!defined $head) {
7636                         next;
7637                 }
7638                 $git_dir = "$projectroot/$proj{'path'}";
7639                 my %co = parse_commit($head);
7640                 if (!%co) {
7641                         next;
7642                 }
7644                 my $path = esc_html(chop_str($proj{'path'}, 25, 5));
7645                 my $rss  = href('project' => $proj{'path'}, 'action' => 'rss', -full => 1);
7646                 my $html = href('project' => $proj{'path'}, 'action' => 'summary', -full => 1);
7647                 print "<outline type=\"rss\" text=\"$path\" title=\"$path\" xmlUrl=\"$rss\" htmlUrl=\"$html\"/>\n";
7648         }
7649         print <<XML;
7650 </outline>
7651 </body>
7652 </opml>
7653 XML