3 # gitweb - simple web interface to track changes in git repositories
5 # (C) 2005-2006, Kay Sievers <kay.sievers@vrfy.org>
6 # (C) 2005, Christian Gierke
8 # This program is licensed under the GPLv2
12 use CGI
qw(:standard :escapeHTML -nosticky);
13 use CGI
::Util
qw(unescape);
14 use CGI
::Carp
qw(fatalsToBrowser);
18 use File
::Basename
qw(basename);
19 binmode STDOUT
, ':utf8';
22 CGI
->compile() if $ENV{'MOD_PERL'};
26 our $version = "++GIT_VERSION++";
27 our $my_url = $cgi->url();
28 our $my_uri = $cgi->url(-absolute
=> 1);
30 # if we're called with PATH_INFO, we have to strip that
31 # from the URL to find our real URL
32 # we make $path_info global because it's also used later on
33 our $path_info = $ENV{"PATH_INFO"};
35 $my_url =~ s
,\Q
$path_info\E
$,,;
36 $my_uri =~ s
,\Q
$path_info\E
$,,;
39 # core git executable to use
40 # this can just be "git" if your webserver has a sensible PATH
41 our $GIT = "++GIT_BINDIR++/git";
43 # absolute fs-path which will be prepended to the project path
44 #our $projectroot = "/pub/scm";
45 our $projectroot = "++GITWEB_PROJECTROOT++";
47 # fs traversing limit for getting project list
48 # the number is relative to the projectroot
49 our $project_maxdepth = "++GITWEB_PROJECT_MAXDEPTH++";
51 # target of the home link on top of all pages
52 our $home_link = $my_uri || "/";
54 # string of the home link on top of all pages
55 our $home_link_str = "++GITWEB_HOME_LINK_STR++";
57 # name of your site or organization to appear in page titles
58 # replace this with something more descriptive for clearer bookmarks
59 our $site_name = "++GITWEB_SITENAME++"
60 || ($ENV{'SERVER_NAME'} || "Untitled") . " Git";
62 # filename of html text to include at top of each page
63 our $site_header = "++GITWEB_SITE_HEADER++";
64 # html text to include at home page
65 our $home_text = "++GITWEB_HOMETEXT++";
66 # filename of html text to include at bottom of each page
67 our $site_footer = "++GITWEB_SITE_FOOTER++";
70 our @stylesheets = ("++GITWEB_CSS++");
71 # URI of a single stylesheet, which can be overridden in GITWEB_CONFIG.
72 our $stylesheet = undef;
73 # URI of GIT logo (72x27 size)
74 our $logo = "++GITWEB_LOGO++";
75 # URI of GIT favicon, assumed to be image/png type
76 our $favicon = "++GITWEB_FAVICON++";
78 # URI and label (title) of GIT logo link
79 #our $logo_url = "http://www.kernel.org/pub/software/scm/git/docs/";
80 #our $logo_label = "git documentation";
81 our $logo_url = "http://git.or.cz/";
82 our $logo_label = "git homepage";
84 # source of projects list
85 our $projects_list = "++GITWEB_LIST++";
87 # the width (in characters) of the projects list "Description" column
88 our $projects_list_description_width = 25;
90 # default order of projects list
91 # valid values are none, project, descr, owner, and age
92 our $default_projects_order = "project";
94 # show repository only if this file exists
95 # (only effective if this variable evaluates to true)
96 our $export_ok = "++GITWEB_EXPORT_OK++";
98 # show repository only if this subroutine returns true
99 # when given the path to the project, for example:
100 # sub { return -e "$_[0]/git-daemon-export-ok"; }
101 our $export_auth_hook = undef;
103 # only allow viewing of repositories also shown on the overview page
104 our $strict_export = "++GITWEB_STRICT_EXPORT++";
106 # list of git base URLs used for URL to where fetch project from,
107 # i.e. full URL is "$git_base_url/$project"
108 our @git_base_url_list = grep { $_ ne '' } ("++GITWEB_BASE_URL++");
110 # default blob_plain mimetype and default charset for text/plain blob
111 our $default_blob_plain_mimetype = 'text/plain';
112 our $default_text_plain_charset = undef;
114 # file to use for guessing MIME types before trying /etc/mime.types
115 # (relative to the current git repository)
116 our $mimetypes_file = undef;
118 # assume this charset if line contains non-UTF-8 characters;
119 # it should be valid encoding (see Encoding::Supported(3pm) for list),
120 # for which encoding all byte sequences are valid, for example
121 # 'iso-8859-1' aka 'latin1' (it is decoded without checking, so it
122 # could be even 'utf-8' for the old behavior)
123 our $fallback_encoding = 'latin1';
125 # rename detection options for git-diff and git-diff-tree
126 # - default is '-M', with the cost proportional to
127 # (number of removed files) * (number of new files).
128 # - more costly is '-C' (which implies '-M'), with the cost proportional to
129 # (number of changed files + number of removed files) * (number of new files)
130 # - even more costly is '-C', '--find-copies-harder' with cost
131 # (number of files in the original tree) * (number of new files)
132 # - one might want to include '-B' option, e.g. '-B', '-M'
133 our @diff_opts = ('-M'); # taken from git_commit
135 # information about snapshot formats that gitweb is capable of serving
136 our %known_snapshot_formats = (
138 # 'display' => display name,
139 # 'type' => mime type,
140 # 'suffix' => filename suffix,
141 # 'format' => --format for git-archive,
142 # 'compressor' => [compressor command and arguments]
143 # (array reference, optional)}
146 'display' => 'tar.gz',
147 'type' => 'application/x-gzip',
148 'suffix' => '.tar.gz',
150 'compressor' => ['gzip']},
153 'display' => 'tar.bz2',
154 'type' => 'application/x-bzip2',
155 'suffix' => '.tar.bz2',
157 'compressor' => ['bzip2']},
161 'type' => 'application/x-zip',
166 # Aliases so we understand old gitweb.snapshot values in repository
168 our %known_snapshot_format_aliases = (
172 # backward compatibility: legacy gitweb config support
173 'x-gzip' => undef, 'gz' => undef,
174 'x-bzip2' => undef, 'bz2' => undef,
175 'x-zip' => undef, '' => undef,
178 # You define site-wide feature defaults here; override them with
179 # $GITWEB_CONFIG as necessary.
182 # 'sub' => feature-sub (subroutine),
183 # 'override' => allow-override (boolean),
184 # 'default' => [ default options...] (array reference)}
186 # if feature is overridable (it means that allow-override has true value),
187 # then feature-sub will be called with default options as parameters;
188 # return value of feature-sub indicates if to enable specified feature
190 # if there is no 'sub' key (no feature-sub), then feature cannot be
193 # use gitweb_get_feature(<feature>) to retrieve the <feature> value
194 # (an array) or gitweb_check_feature(<feature>) to check if <feature>
197 # Enable the 'blame' blob view, showing the last commit that modified
198 # each line in the file. This can be very CPU-intensive.
200 # To enable system wide have in $GITWEB_CONFIG
201 # $feature{'blame'}{'default'} = [1];
202 # To have project specific config enable override in $GITWEB_CONFIG
203 # $feature{'blame'}{'override'} = 1;
204 # and in project config gitweb.blame = 0|1;
206 'sub' => \
&feature_blame
,
210 # Enable the 'snapshot' link, providing a compressed archive of any
211 # tree. This can potentially generate high traffic if you have large
214 # Value is a list of formats defined in %known_snapshot_formats that
216 # To disable system wide have in $GITWEB_CONFIG
217 # $feature{'snapshot'}{'default'} = [];
218 # To have project specific config enable override in $GITWEB_CONFIG
219 # $feature{'snapshot'}{'override'} = 1;
220 # and in project config, a comma-separated list of formats or "none"
221 # to disable. Example: gitweb.snapshot = tbz2,zip;
223 'sub' => \
&feature_snapshot
,
225 'default' => ['tgz']},
227 # Enable text search, which will list the commits which match author,
228 # committer or commit text to a given string. Enabled by default.
229 # Project specific override is not supported.
234 # Enable grep search, which will list the files in currently selected
235 # tree containing the given string. Enabled by default. This can be
236 # potentially CPU-intensive, of course.
238 # To enable system wide have in $GITWEB_CONFIG
239 # $feature{'grep'}{'default'} = [1];
240 # To have project specific config enable override in $GITWEB_CONFIG
241 # $feature{'grep'}{'override'} = 1;
242 # and in project config gitweb.grep = 0|1;
247 # Enable the pickaxe search, which will list the commits that modified
248 # a given string in a file. This can be practical and quite faster
249 # alternative to 'blame', but still potentially CPU-intensive.
251 # To enable system wide have in $GITWEB_CONFIG
252 # $feature{'pickaxe'}{'default'} = [1];
253 # To have project specific config enable override in $GITWEB_CONFIG
254 # $feature{'pickaxe'}{'override'} = 1;
255 # and in project config gitweb.pickaxe = 0|1;
257 'sub' => \
&feature_pickaxe
,
261 # Make gitweb use an alternative format of the URLs which can be
262 # more readable and natural-looking: project name is embedded
263 # directly in the path and the query string contains other
264 # auxiliary information. All gitweb installations recognize
265 # URL in either format; this configures in which formats gitweb
268 # To enable system wide have in $GITWEB_CONFIG
269 # $feature{'pathinfo'}{'default'} = [1];
270 # Project specific override is not supported.
272 # Note that you will need to change the default location of CSS,
273 # favicon, logo and possibly other files to an absolute URL. Also,
274 # if gitweb.cgi serves as your indexfile, you will need to force
275 # $my_uri to contain the script name in your $GITWEB_CONFIG.
280 # Make gitweb consider projects in project root subdirectories
281 # to be forks of existing projects. Given project $projname.git,
282 # projects matching $projname/*.git will not be shown in the main
283 # projects list, instead a '+' mark will be added to $projname
284 # there and a 'forks' view will be enabled for the project, listing
285 # all the forks. If project list is taken from a file, forks have
286 # to be listed after the main project.
288 # To enable system wide have in $GITWEB_CONFIG
289 # $feature{'forks'}{'default'} = [1];
290 # Project specific override is not supported.
295 # Insert custom links to the action bar of all project pages.
296 # This enables you mainly to link to third-party scripts integrating
297 # into gitweb; e.g. git-browser for graphical history representation
298 # or custom web-based repository administration interface.
300 # The 'default' value consists of a list of triplets in the form
301 # (label, link, position) where position is the label after which
302 # to insert the link and link is a format string where %n expands
303 # to the project name, %f to the project path within the filesystem,
304 # %h to the current hash (h gitweb parameter) and %b to the current
305 # hash base (hb gitweb parameter); %% expands to %.
307 # To enable system wide have in $GITWEB_CONFIG e.g.
308 # $feature{'actions'}{'default'} = [('graphiclog',
309 # '/git-browser/by-commit.html?r=%n', 'summary')];
310 # Project specific override is not supported.
315 # Allow gitweb scan project content tags described in ctags/
316 # of project repository, and display the popular Web 2.0-ish
317 # "tag cloud" near the project list. Note that this is something
318 # COMPLETELY different from the normal Git tags.
320 # gitweb by itself can show existing tags, but it does not handle
321 # tagging itself; you need an external application for that.
322 # For an example script, check Girocco's cgi/tagproj.cgi.
323 # You may want to install the HTML::TagCloud Perl module to get
324 # a pretty tag cloud instead of just a list of tags.
326 # To enable system wide have in $GITWEB_CONFIG
327 # $feature{'ctags'}{'default'} = ['path_to_tag_script'];
328 # Project specific override is not supported.
334 sub gitweb_get_feature
{
336 return unless exists $feature{$name};
337 my ($sub, $override, @defaults) = (
338 $feature{$name}{'sub'},
339 $feature{$name}{'override'},
340 @
{$feature{$name}{'default'}});
341 if (!$override) { return @defaults; }
343 warn "feature $name is not overrideable";
346 return $sub->(@defaults);
349 # A wrapper to check if a given feature is enabled.
350 # With this, you can say
352 # my $bool_feat = gitweb_check_feature('bool_feat');
353 # gitweb_check_feature('bool_feat') or somecode;
357 # my ($bool_feat) = gitweb_get_feature('bool_feat');
358 # (gitweb_get_feature('bool_feat'))[0] or somecode;
360 sub gitweb_check_feature
{
361 return (gitweb_get_feature
(@_))[0];
366 my ($val) = git_get_project_config
('blame', '--bool');
368 if ($val eq 'true') {
370 } elsif ($val eq 'false') {
377 sub feature_snapshot
{
380 my ($val) = git_get_project_config
('snapshot');
383 @fmts = ($val eq 'none' ?
() : split /\s*[,\s]\s*/, $val);
390 my ($val) = git_get_project_config
('grep', '--bool');
392 if ($val eq 'true') {
394 } elsif ($val eq 'false') {
401 sub feature_pickaxe
{
402 my ($val) = git_get_project_config
('pickaxe', '--bool');
404 if ($val eq 'true') {
406 } elsif ($val eq 'false') {
413 # checking HEAD file with -e is fragile if the repository was
414 # initialized long time ago (i.e. symlink HEAD) and was pack-ref'ed
416 sub check_head_link
{
418 my $headfile = "$dir/HEAD";
419 return ((-e
$headfile) ||
420 (-l
$headfile && readlink($headfile) =~ /^refs\/heads\
//));
423 sub check_export_ok
{
425 return (check_head_link
($dir) &&
426 (!$export_ok || -e
"$dir/$export_ok") &&
427 (!$export_auth_hook || $export_auth_hook->($dir)));
430 # process alternate names for backward compatibility
431 # filter out unsupported (unknown) snapshot formats
432 sub filter_snapshot_fmts
{
436 exists $known_snapshot_format_aliases{$_} ?
437 $known_snapshot_format_aliases{$_} : $_} @fmts;
438 @fmts = grep(exists $known_snapshot_formats{$_}, @fmts);
442 our $GITWEB_CONFIG = $ENV{'GITWEB_CONFIG'} || "++GITWEB_CONFIG++";
443 if (-e
$GITWEB_CONFIG) {
446 our $GITWEB_CONFIG_SYSTEM = $ENV{'GITWEB_CONFIG_SYSTEM'} || "++GITWEB_CONFIG_SYSTEM++";
447 do $GITWEB_CONFIG_SYSTEM if -e
$GITWEB_CONFIG_SYSTEM;
450 # version of the core git binary
451 our $git_version = qx("$GIT" --version
) =~ m/git version (.*)$/ ?
$1 : "unknown";
453 $projects_list ||= $projectroot;
455 # ======================================================================
456 # input validation and dispatch
458 # input parameters can be collected from a variety of sources (presently, CGI
459 # and PATH_INFO), so we define an %input_params hash that collects them all
460 # together during validation: this allows subsequent uses (e.g. href()) to be
461 # agnostic of the parameter origin
463 our %input_params = ();
465 # input parameters are stored with the long parameter name as key. This will
466 # also be used in the href subroutine to convert parameters to their CGI
467 # equivalent, and since the href() usage is the most frequent one, we store
468 # the name -> CGI key mapping here, instead of the reverse.
470 # XXX: Warning: If you touch this, check the search form for updating,
473 our @cgi_param_mapping = (
481 hash_parent_base
=> "hpb",
486 snapshot_format
=> "sf",
487 extra_options
=> "opt",
488 search_use_regexp
=> "sr",
490 our %cgi_param_mapping = @cgi_param_mapping;
492 # we will also need to know the possible actions, for validation
494 "blame" => \
&git_blame
,
495 "blobdiff" => \
&git_blobdiff
,
496 "blobdiff_plain" => \
&git_blobdiff_plain
,
497 "blob" => \
&git_blob
,
498 "blob_plain" => \
&git_blob_plain
,
499 "commitdiff" => \
&git_commitdiff
,
500 "commitdiff_plain" => \
&git_commitdiff_plain
,
501 "commit" => \
&git_commit
,
502 "forks" => \
&git_forks
,
503 "heads" => \
&git_heads
,
504 "history" => \
&git_history
,
507 "atom" => \
&git_atom
,
508 "search" => \
&git_search
,
509 "search_help" => \
&git_search_help
,
510 "shortlog" => \
&git_shortlog
,
511 "summary" => \
&git_summary
,
513 "tags" => \
&git_tags
,
514 "tree" => \
&git_tree
,
515 "snapshot" => \
&git_snapshot
,
516 "object" => \
&git_object
,
517 # those below don't need $project
518 "opml" => \
&git_opml
,
519 "project_list" => \
&git_project_list
,
520 "project_index" => \
&git_project_index
,
523 # finally, we have the hash of allowed extra_options for the commands that
525 our %allowed_options = (
526 "--no-merges" => [ qw(rss atom log shortlog history) ],
529 # fill %input_params with the CGI parameters. All values except for 'opt'
530 # should be single values, but opt can be an array. We should probably
531 # build an array of parameters that can be multi-valued, but since for the time
532 # being it's only this one, we just single it out
533 while (my ($name, $symbol) = each %cgi_param_mapping) {
534 if ($symbol eq 'opt') {
535 $input_params{$name} = [ $cgi->param($symbol) ];
537 $input_params{$name} = $cgi->param($symbol);
541 # now read PATH_INFO and update the parameter list for missing parameters
542 sub evaluate_path_info
{
543 return if defined $input_params{'project'};
544 return if !$path_info;
545 $path_info =~ s
,^/+,,;
546 return if !$path_info;
548 # find which part of PATH_INFO is project
549 my $project = $path_info;
551 while ($project && !check_head_link
("$projectroot/$project")) {
552 $project =~ s
,/*[^/]*$,,;
554 return unless $project;
555 $input_params{'project'} = $project;
557 # do not change any parameters if an action is given using the query string
558 return if $input_params{'action'};
559 $path_info =~ s
,^\Q
$project\E
/*,,;
561 # next, check if we have an action
562 my $action = $path_info;
564 if (exists $actions{$action}) {
565 $path_info =~ s
,^$action/*,,;
566 $input_params{'action'} = $action;
569 # list of actions that want hash_base instead of hash, but can have no
570 # pathname (f) parameter
577 # [$hash_parent_base[:$file_parent]..]$hash_parent[:$file_name]
578 my ($parentrefname, $parentpathname, $refname, $pathname) =
579 ($path_info =~ /^(?:(.+?)(?::(.+))?\.\.)?(.+?)(?::(.+))?$/);
581 # first, analyze the 'current' part
582 if (defined $pathname) {
583 # we got "branch:filename" or "branch:dir/"
584 # we could use git_get_type(branch:pathname), but:
585 # - it needs $git_dir
586 # - it does a git() call
587 # - the convention of terminating directories with a slash
588 # makes it superfluous
589 # - embedding the action in the PATH_INFO would make it even
591 $pathname =~ s
,^/+,,;
592 if (!$pathname || substr($pathname, -1) eq "/") {
593 $input_params{'action'} ||= "tree";
596 # the default action depends on whether we had parent info
598 if ($parentrefname) {
599 $input_params{'action'} ||= "blobdiff_plain";
601 $input_params{'action'} ||= "blob_plain";
604 $input_params{'hash_base'} ||= $refname;
605 $input_params{'file_name'} ||= $pathname;
606 } elsif (defined $refname) {
607 # we got "branch". In this case we have to choose if we have to
608 # set hash or hash_base.
610 # Most of the actions without a pathname only want hash to be
611 # set, except for the ones specified in @wants_base that want
612 # hash_base instead. It should also be noted that hand-crafted
613 # links having 'history' as an action and no pathname or hash
614 # set will fail, but that happens regardless of PATH_INFO.
615 $input_params{'action'} ||= "shortlog";
616 if (grep { $_ eq $input_params{'action'} } @wants_base) {
617 $input_params{'hash_base'} ||= $refname;
619 $input_params{'hash'} ||= $refname;
623 # next, handle the 'parent' part, if present
624 if (defined $parentrefname) {
625 # a missing pathspec defaults to the 'current' filename, allowing e.g.
626 # someproject/blobdiff/oldrev..newrev:/filename
627 if ($parentpathname) {
628 $parentpathname =~ s
,^/+,,;
629 $parentpathname =~ s
,/$,,;
630 $input_params{'file_parent'} ||= $parentpathname;
632 $input_params{'file_parent'} ||= $input_params{'file_name'};
634 # we assume that hash_parent_base is wanted if a path was specified,
635 # or if the action wants hash_base instead of hash
636 if (defined $input_params{'file_parent'} ||
637 grep { $_ eq $input_params{'action'} } @wants_base) {
638 $input_params{'hash_parent_base'} ||= $parentrefname;
640 $input_params{'hash_parent'} ||= $parentrefname;
644 # for the snapshot action, we allow URLs in the form
645 # $project/snapshot/$hash.ext
646 # where .ext determines the snapshot and gets removed from the
647 # passed $refname to provide the $hash.
649 # To be able to tell that $refname includes the format extension, we
650 # require the following two conditions to be satisfied:
651 # - the hash input parameter MUST have been set from the $refname part
652 # of the URL (i.e. they must be equal)
653 # - the snapshot format MUST NOT have been defined already (e.g. from
655 # It's also useless to try any matching unless $refname has a dot,
656 # so we check for that too
657 if (defined $input_params{'action'} &&
658 $input_params{'action'} eq 'snapshot' &&
659 defined $refname && index($refname, '.') != -1 &&
660 $refname eq $input_params{'hash'} &&
661 !defined $input_params{'snapshot_format'}) {
662 # We loop over the known snapshot formats, checking for
663 # extensions. Allowed extensions are both the defined suffix
664 # (which includes the initial dot already) and the snapshot
665 # format key itself, with a prepended dot
666 while (my ($fmt, %opt) = each %known_snapshot_formats) {
669 $hash =~ s/(\Q$opt{'suffix'}\E|\Q.$fmt\E)$//;
670 next unless $sfx = $1;
671 # a valid suffix was found, so set the snapshot format
672 # and reset the hash parameter
673 $input_params{'snapshot_format'} = $fmt;
674 $input_params{'hash'} = $hash;
675 # we also set the format suffix to the one requested
676 # in the URL: this way a request for e.g. .tgz returns
677 # a .tgz instead of a .tar.gz
678 $known_snapshot_formats{$fmt}{'suffix'} = $sfx;
683 evaluate_path_info
();
685 our $action = $input_params{'action'};
686 if (defined $action) {
687 if (!validate_action
($action)) {
688 die_error
(400, "Invalid action parameter");
692 # parameters which are pathnames
693 our $project = $input_params{'project'};
694 if (defined $project) {
695 if (!validate_project
($project)) {
697 die_error
(404, "No such project");
701 our $file_name = $input_params{'file_name'};
702 if (defined $file_name) {
703 if (!validate_pathname
($file_name)) {
704 die_error
(400, "Invalid file parameter");
708 our $file_parent = $input_params{'file_parent'};
709 if (defined $file_parent) {
710 if (!validate_pathname
($file_parent)) {
711 die_error
(400, "Invalid file parent parameter");
715 # parameters which are refnames
716 our $hash = $input_params{'hash'};
718 if (!validate_refname
($hash)) {
719 die_error
(400, "Invalid hash parameter");
723 our $hash_parent = $input_params{'hash_parent'};
724 if (defined $hash_parent) {
725 if (!validate_refname
($hash_parent)) {
726 die_error
(400, "Invalid hash parent parameter");
730 our $hash_base = $input_params{'hash_base'};
731 if (defined $hash_base) {
732 if (!validate_refname
($hash_base)) {
733 die_error
(400, "Invalid hash base parameter");
737 our @extra_options = @
{$input_params{'extra_options'}};
738 # @extra_options is always defined, since it can only be (currently) set from
739 # CGI, and $cgi->param() returns the empty array in array context if the param
741 foreach my $opt (@extra_options) {
742 if (not exists $allowed_options{$opt}) {
743 die_error
(400, "Invalid option parameter");
745 if (not grep(/^$action$/, @
{$allowed_options{$opt}})) {
746 die_error
(400, "Invalid option parameter for this action");
750 our $hash_parent_base = $input_params{'hash_parent_base'};
751 if (defined $hash_parent_base) {
752 if (!validate_refname
($hash_parent_base)) {
753 die_error
(400, "Invalid hash parent base parameter");
758 our $page = $input_params{'page'};
760 if ($page =~ m/[^0-9]/) {
761 die_error
(400, "Invalid page parameter");
765 our $searchtype = $input_params{'searchtype'};
766 if (defined $searchtype) {
767 if ($searchtype =~ m/[^a-z]/) {
768 die_error
(400, "Invalid searchtype parameter");
772 our $search_use_regexp = $input_params{'search_use_regexp'};
774 our $searchtext = $input_params{'searchtext'};
776 if (defined $searchtext) {
777 if (length($searchtext) < 2) {
778 die_error
(403, "At least two characters are required for search parameter");
780 $search_regexp = $search_use_regexp ?
$searchtext : quotemeta $searchtext;
783 # path to the current git repository
785 $git_dir = "$projectroot/$project" if $project;
787 # list of supported snapshot formats
788 our @snapshot_fmts = gitweb_get_feature
('snapshot');
789 @snapshot_fmts = filter_snapshot_fmts
(@snapshot_fmts);
792 if (!defined $action) {
794 $action = git_get_type
($hash);
795 } elsif (defined $hash_base && defined $file_name) {
796 $action = git_get_type
("$hash_base:$file_name");
797 } elsif (defined $project) {
800 $action = 'project_list';
803 if (!defined($actions{$action})) {
804 die_error
(400, "Unknown action");
806 if ($action !~ m/^(opml|project_list|project_index)$/ &&
808 die_error
(400, "Project needed");
810 $actions{$action}->();
813 ## ======================================================================
818 # default is to use -absolute url() i.e. $my_uri
819 my $href = $params{-full
} ?
$my_url : $my_uri;
821 $params{'project'} = $project unless exists $params{'project'};
823 if ($params{-replay
}) {
824 while (my ($name, $symbol) = each %cgi_param_mapping) {
825 if (!exists $params{$name}) {
826 $params{$name} = $input_params{$name};
831 my $use_pathinfo = gitweb_check_feature
('pathinfo');
833 # try to put as many parameters as possible in PATH_INFO:
836 # - hash_parent or hash_parent_base:/file_parent
837 # - hash or hash_base:/filename
838 # - the snapshot_format as an appropriate suffix
840 # When the script is the root DirectoryIndex for the domain,
841 # $href here would be something like http://gitweb.example.com/
842 # Thus, we strip any trailing / from $href, to spare us double
843 # slashes in the final URL
846 # Then add the project name, if present
847 $href .= "/".esc_url
($params{'project'}) if defined $params{'project'};
848 delete $params{'project'};
850 # since we destructively absorb parameters, we keep this
851 # boolean that remembers if we're handling a snapshot
852 my $is_snapshot = $params{'action'} eq 'snapshot';
854 # Summary just uses the project path URL, any other action is
856 if (defined $params{'action'}) {
857 $href .= "/".esc_url
($params{'action'}) unless $params{'action'} eq 'summary';
858 delete $params{'action'};
861 # Next, we put hash_parent_base:/file_parent..hash_base:/file_name,
862 # stripping nonexistent or useless pieces
863 $href .= "/" if ($params{'hash_base'} || $params{'hash_parent_base'}
864 || $params{'hash_parent'} || $params{'hash'});
865 if (defined $params{'hash_base'}) {
866 if (defined $params{'hash_parent_base'}) {
867 $href .= esc_url
($params{'hash_parent_base'});
868 # skip the file_parent if it's the same as the file_name
869 delete $params{'file_parent'} if $params{'file_parent'} eq $params{'file_name'};
870 if (defined $params{'file_parent'} && $params{'file_parent'} !~ /\.\./) {
871 $href .= ":/".esc_url
($params{'file_parent'});
872 delete $params{'file_parent'};
875 delete $params{'hash_parent'};
876 delete $params{'hash_parent_base'};
877 } elsif (defined $params{'hash_parent'}) {
878 $href .= esc_url
($params{'hash_parent'}). "..";
879 delete $params{'hash_parent'};
882 $href .= esc_url
($params{'hash_base'});
883 if (defined $params{'file_name'} && $params{'file_name'} !~ /\.\./) {
884 $href .= ":/".esc_url
($params{'file_name'});
885 delete $params{'file_name'};
887 delete $params{'hash'};
888 delete $params{'hash_base'};
889 } elsif (defined $params{'hash'}) {
890 $href .= esc_url
($params{'hash'});
891 delete $params{'hash'};
894 # If the action was a snapshot, we can absorb the
895 # snapshot_format parameter too
897 my $fmt = $params{'snapshot_format'};
898 # snapshot_format should always be defined when href()
899 # is called, but just in case some code forgets, we
900 # fall back to the default
901 $fmt ||= $snapshot_fmts[0];
902 $href .= $known_snapshot_formats{$fmt}{'suffix'};
903 delete $params{'snapshot_format'};
907 # now encode the parameters explicitly
909 for (my $i = 0; $i < @cgi_param_mapping; $i += 2) {
910 my ($name, $symbol) = ($cgi_param_mapping[$i], $cgi_param_mapping[$i+1]);
911 if (defined $params{$name}) {
912 if (ref($params{$name}) eq "ARRAY") {
913 foreach my $par (@
{$params{$name}}) {
914 push @result, $symbol . "=" . esc_param
($par);
917 push @result, $symbol . "=" . esc_param
($params{$name});
921 $href .= "?" . join(';', @result) if scalar @result;
927 ## ======================================================================
928 ## validation, quoting/unquoting and escaping
930 sub validate_action
{
931 my $input = shift || return undef;
932 return undef unless exists $actions{$input};
936 sub validate_project
{
937 my $input = shift || return undef;
938 if (!validate_pathname
($input) ||
939 !(-d
"$projectroot/$input") ||
940 !check_export_ok
("$projectroot/$input") ||
941 ($strict_export && !project_in_list
($input))) {
948 sub validate_pathname
{
949 my $input = shift || return undef;
951 # no '.' or '..' as elements of path, i.e. no '.' nor '..'
952 # at the beginning, at the end, and between slashes.
953 # also this catches doubled slashes
954 if ($input =~ m!(^|/)(|\.|\.\.)(/|$)!) {
958 if ($input =~ m!\0!) {
964 sub validate_refname
{
965 my $input = shift || return undef;
967 # textual hashes are O.K.
968 if ($input =~ m/^[0-9a-fA-F]{40}$/) {
971 # it must be correct pathname
972 $input = validate_pathname
($input)
974 # restrictions on ref name according to git-check-ref-format
975 if ($input =~ m!(/\.|\.\.|[\000-\040\177 ~^:?*\[]|/$)!) {
981 # decode sequences of octets in utf8 into Perl's internal form,
982 # which is utf-8 with utf8 flag set if needed. gitweb writes out
983 # in utf-8 thanks to "binmode STDOUT, ':utf8'" at beginning
986 if (utf8
::valid
($str)) {
990 return decode
($fallback_encoding, $str, Encode
::FB_DEFAULT
);
994 # quote unsafe chars, but keep the slash, even when it's not
995 # correct, but quoted slashes look too horrible in bookmarks
998 $str =~ s/([^A-Za-z0-9\-_.~()\/:@])/sprintf
("%%%02X", ord($1))/eg
;
1004 # quote unsafe chars in whole URL, so some charactrs cannot be quoted
1007 $str =~ s/([^A-Za-z0-9\-_.~();\/;?:@&=])/sprintf
("%%%02X", ord($1))/eg
;
1013 # replace invalid utf8 character with SUBSTITUTION sequence
1014 sub esc_html
($;%) {
1018 $str = to_utf8
($str);
1019 $str = $cgi->escapeHTML($str);
1020 if ($opts{'-nbsp'}) {
1021 $str =~ s/ / /g;
1023 $str =~ s
|([[:cntrl
:]])|(($1 ne "\t") ? quot_cec
($1) : $1)|eg
;
1027 # quote control characters and escape filename to HTML
1032 $str = to_utf8
($str);
1033 $str = $cgi->escapeHTML($str);
1034 if ($opts{'-nbsp'}) {
1035 $str =~ s/ / /g;
1037 $str =~ s
|([[:cntrl
:]])|quot_cec
($1)|eg
;
1041 # Make control characters "printable", using character escape codes (CEC)
1045 my %es = ( # character escape codes, aka escape sequences
1046 "\t" => '\t', # tab (HT)
1047 "\n" => '\n', # line feed (LF)
1048 "\r" => '\r', # carrige return (CR)
1049 "\f" => '\f', # form feed (FF)
1050 "\b" => '\b', # backspace (BS)
1051 "\a" => '\a', # alarm (bell) (BEL)
1052 "\e" => '\e', # escape (ESC)
1053 "\013" => '\v', # vertical tab (VT)
1054 "\000" => '\0', # nul character (NUL)
1056 my $chr = ( (exists $es{$cntrl})
1058 : sprintf('\%2x', ord($cntrl)) );
1059 if ($opts{-nohtml
}) {
1062 return "<span class=\"cntrl\">$chr</span>";
1066 # Alternatively use unicode control pictures codepoints,
1067 # Unicode "printable representation" (PR)
1072 my $chr = sprintf('&#%04d;', 0x2400+ord($cntrl));
1073 if ($opts{-nohtml
}) {
1076 return "<span class=\"cntrl\">$chr</span>";
1080 # git may return quoted and escaped filenames
1086 my %es = ( # character escape codes, aka escape sequences
1087 't' => "\t", # tab (HT, TAB)
1088 'n' => "\n", # newline (NL)
1089 'r' => "\r", # return (CR)
1090 'f' => "\f", # form feed (FF)
1091 'b' => "\b", # backspace (BS)
1092 'a' => "\a", # alarm (bell) (BEL)
1093 'e' => "\e", # escape (ESC)
1094 'v' => "\013", # vertical tab (VT)
1097 if ($seq =~ m/^[0-7]{1,3}$/) {
1098 # octal char sequence
1099 return chr(oct($seq));
1100 } elsif (exists $es{$seq}) {
1101 # C escape sequence, aka character escape code
1104 # quoted ordinary character
1108 if ($str =~ m/^"(.*)"$/) {
1111 $str =~ s/\\([^0-7]|[0-7]{1,3})/unq($1)/eg;
1116 # escape tabs (convert tabs to spaces)
1120 while ((my $pos = index($line, "\t")) != -1) {
1121 if (my $count = (8 - ($pos % 8))) {
1122 my $spaces = ' ' x
$count;
1123 $line =~ s/\t/$spaces/;
1130 sub project_in_list
{
1131 my $project = shift;
1132 my @list = git_get_projects_list
();
1133 return @list && scalar(grep { $_->{'path'} eq $project } @list);
1136 ## ----------------------------------------------------------------------
1137 ## HTML aware string manipulation
1139 # Try to chop given string on a word boundary between position
1140 # $len and $len+$add_len. If there is no word boundary there,
1141 # chop at $len+$add_len. Do not chop if chopped part plus ellipsis
1142 # (marking chopped part) would be longer than given string.
1146 my $add_len = shift || 10;
1147 my $where = shift || 'right'; # 'left' | 'center' | 'right'
1149 # Make sure perl knows it is utf8 encoded so we don't
1150 # cut in the middle of a utf8 multibyte char.
1151 $str = to_utf8
($str);
1153 # allow only $len chars, but don't cut a word if it would fit in $add_len
1154 # if it doesn't fit, cut it if it's still longer than the dots we would add
1155 # remove chopped character entities entirely
1157 # when chopping in the middle, distribute $len into left and right part
1158 # return early if chopping wouldn't make string shorter
1159 if ($where eq 'center') {
1160 return $str if ($len + 5 >= length($str)); # filler is length 5
1163 return $str if ($len + 4 >= length($str)); # filler is length 4
1166 # regexps: ending and beginning with word part up to $add_len
1167 my $endre = qr/.{$len}\w{0,$add_len}/;
1168 my $begre = qr/\w{0,$add_len}.{$len}/;
1170 if ($where eq 'left') {
1171 $str =~ m/^(.*?)($begre)$/;
1172 my ($lead, $body) = ($1, $2);
1173 if (length($lead) > 4) {
1174 $body =~ s/^[^;]*;// if ($lead =~ m/&[^;]*$/);
1177 return "$lead$body";
1179 } elsif ($where eq 'center') {
1180 $str =~ m/^($endre)(.*)$/;
1181 my ($left, $str) = ($1, $2);
1182 $str =~ m/^(.*?)($begre)$/;
1183 my ($mid, $right) = ($1, $2);
1184 if (length($mid) > 5) {
1185 $left =~ s/&[^;]*$//;
1186 $right =~ s/^[^;]*;// if ($mid =~ m/&[^;]*$/);
1189 return "$left$mid$right";
1192 $str =~ m/^($endre)(.*)$/;
1195 if (length($tail) > 4) {
1196 $body =~ s/&[^;]*$//;
1199 return "$body$tail";
1203 # takes the same arguments as chop_str, but also wraps a <span> around the
1204 # result with a title attribute if it does get chopped. Additionally, the
1205 # string is HTML-escaped.
1206 sub chop_and_escape_str
{
1209 my $chopped = chop_str
(@_);
1210 if ($chopped eq $str) {
1211 return esc_html
($chopped);
1213 $str =~ s/([[:cntrl:]])/?/g;
1214 return $cgi->span({-title
=>$str}, esc_html
($chopped));
1218 ## ----------------------------------------------------------------------
1219 ## functions returning short strings
1221 # CSS class for given age value (in seconds)
1225 if (!defined $age) {
1227 } elsif ($age < 60*60*2) {
1229 } elsif ($age < 60*60*24*2) {
1236 # convert age in seconds to "nn units ago" string
1241 if ($age > 60*60*24*365*2) {
1242 $age_str = (int $age/60/60/24/365);
1243 $age_str .= " years ago";
1244 } elsif ($age > 60*60*24*(365/12)*2) {
1245 $age_str = int $age/60/60/24/(365/12);
1246 $age_str .= " months ago";
1247 } elsif ($age > 60*60*24*7*2) {
1248 $age_str = int $age/60/60/24/7;
1249 $age_str .= " weeks ago";
1250 } elsif ($age > 60*60*24*2) {
1251 $age_str = int $age/60/60/24;
1252 $age_str .= " days ago";
1253 } elsif ($age > 60*60*2) {
1254 $age_str = int $age/60/60;
1255 $age_str .= " hours ago";
1256 } elsif ($age > 60*2) {
1257 $age_str = int $age/60;
1258 $age_str .= " min ago";
1259 } elsif ($age > 2) {
1260 $age_str = int $age;
1261 $age_str .= " sec ago";
1263 $age_str .= " right now";
1269 S_IFINVALID
=> 0030000,
1270 S_IFGITLINK
=> 0160000,
1273 # submodule/subproject, a commit object reference
1274 sub S_ISGITLINK
($) {
1277 return (($mode & S_IFMT
) == S_IFGITLINK
)
1280 # convert file mode in octal to symbolic file mode string
1282 my $mode = oct shift;
1284 if (S_ISGITLINK
($mode)) {
1285 return 'm---------';
1286 } elsif (S_ISDIR
($mode & S_IFMT
)) {
1287 return 'drwxr-xr-x';
1288 } elsif (S_ISLNK
($mode)) {
1289 return 'lrwxrwxrwx';
1290 } elsif (S_ISREG
($mode)) {
1291 # git cares only about the executable bit
1292 if ($mode & S_IXUSR
) {
1293 return '-rwxr-xr-x';
1295 return '-rw-r--r--';
1298 return '----------';
1302 # convert file mode in octal to file type string
1306 if ($mode !~ m/^[0-7]+$/) {
1312 if (S_ISGITLINK
($mode)) {
1314 } elsif (S_ISDIR
($mode & S_IFMT
)) {
1316 } elsif (S_ISLNK
($mode)) {
1318 } elsif (S_ISREG
($mode)) {
1325 # convert file mode in octal to file type description string
1326 sub file_type_long
{
1329 if ($mode !~ m/^[0-7]+$/) {
1335 if (S_ISGITLINK
($mode)) {
1337 } elsif (S_ISDIR
($mode & S_IFMT
)) {
1339 } elsif (S_ISLNK
($mode)) {
1341 } elsif (S_ISREG
($mode)) {
1342 if ($mode & S_IXUSR
) {
1343 return "executable";
1353 ## ----------------------------------------------------------------------
1354 ## functions returning short HTML fragments, or transforming HTML fragments
1355 ## which don't belong to other sections
1357 # format line of commit message.
1358 sub format_log_line_html
{
1361 $line = esc_html
($line, -nbsp
=>1);
1362 if ($line =~ m/([0-9a-fA-F]{8,40})/) {
1365 $cgi->a({-href
=> href
(action
=>"object", hash
=>$hash_text),
1366 -class => "text"}, $hash_text);
1367 $line =~ s/$hash_text/$link/;
1372 # format marker of refs pointing to given object
1374 # the destination action is chosen based on object type and current context:
1375 # - for annotated tags, we choose the tag view unless it's the current view
1376 # already, in which case we go to shortlog view
1377 # - for other refs, we keep the current view if we're in history, shortlog or
1378 # log view, and select shortlog otherwise
1379 sub format_ref_marker
{
1380 my ($refs, $id) = @_;
1383 if (defined $refs->{$id}) {
1384 foreach my $ref (@
{$refs->{$id}}) {
1385 # this code exploits the fact that non-lightweight tags are the
1386 # only indirect objects, and that they are the only objects for which
1387 # we want to use tag instead of shortlog as action
1388 my ($type, $name) = qw();
1389 my $indirect = ($ref =~ s/\^\{\}$//);
1390 # e.g. tags/v2.6.11 or heads/next
1391 if ($ref =~ m!^(.*?)s?/(.*)$!) {
1400 $class .= " indirect" if $indirect;
1402 my $dest_action = "shortlog";
1405 $dest_action = "tag" unless $action eq "tag";
1406 } elsif ($action =~ /^(history|(short)?log)$/) {
1407 $dest_action = $action;
1411 $dest .= "refs/" unless $ref =~ m
!^refs
/!;
1414 my $link = $cgi->a({
1416 action
=>$dest_action,
1420 $markers .= " <span class=\"$class\" title=\"$ref\">" .
1426 return ' <span class="refs">'. $markers . '</span>';
1432 # format, perhaps shortened and with markers, title line
1433 sub format_subject_html
{
1434 my ($long, $short, $href, $extra) = @_;
1435 $extra = '' unless defined($extra);
1437 if (length($short) < length($long)) {
1438 return $cgi->a({-href
=> $href, -class => "list subject",
1439 -title
=> to_utf8
($long)},
1440 esc_html
($short) . $extra);
1442 return $cgi->a({-href
=> $href, -class => "list subject"},
1443 esc_html
($long) . $extra);
1447 # format git diff header line, i.e. "diff --(git|combined|cc) ..."
1448 sub format_git_diff_header_line
{
1450 my $diffinfo = shift;
1451 my ($from, $to) = @_;
1453 if ($diffinfo->{'nparents'}) {
1455 $line =~ s!^(diff (.*?) )"?.*$!$1!;
1456 if ($to->{'href'}) {
1457 $line .= $cgi->a({-href
=> $to->{'href'}, -class => "path"},
1458 esc_path
($to->{'file'}));
1459 } else { # file was deleted (no href)
1460 $line .= esc_path
($to->{'file'});
1464 $line =~ s!^(diff (.*?) )"?a/.*$!$1!;
1465 if ($from->{'href'}) {
1466 $line .= $cgi->a({-href
=> $from->{'href'}, -class => "path"},
1467 'a/' . esc_path
($from->{'file'}));
1468 } else { # file was added (no href)
1469 $line .= 'a/' . esc_path
($from->{'file'});
1472 if ($to->{'href'}) {
1473 $line .= $cgi->a({-href
=> $to->{'href'}, -class => "path"},
1474 'b/' . esc_path
($to->{'file'}));
1475 } else { # file was deleted
1476 $line .= 'b/' . esc_path
($to->{'file'});
1480 return "<div class=\"diff header\">$line</div>\n";
1483 # format extended diff header line, before patch itself
1484 sub format_extended_diff_header_line
{
1486 my $diffinfo = shift;
1487 my ($from, $to) = @_;
1490 if ($line =~ s!^((copy|rename) from ).*$!$1! && $from->{'href'}) {
1491 $line .= $cgi->a({-href
=>$from->{'href'}, -class=>"path"},
1492 esc_path
($from->{'file'}));
1494 if ($line =~ s!^((copy|rename) to ).*$!$1! && $to->{'href'}) {
1495 $line .= $cgi->a({-href
=>$to->{'href'}, -class=>"path"},
1496 esc_path
($to->{'file'}));
1498 # match single <mode>
1499 if ($line =~ m/\s(\d{6})$/) {
1500 $line .= '<span class="info"> (' .
1501 file_type_long
($1) .
1505 if ($line =~ m/^index [0-9a-fA-F]{40},[0-9a-fA-F]{40}/) {
1506 # can match only for combined diff
1508 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
1509 if ($from->{'href'}[$i]) {
1510 $line .= $cgi->a({-href
=>$from->{'href'}[$i],
1512 substr($diffinfo->{'from_id'}[$i],0,7));
1517 $line .= ',' if ($i < $diffinfo->{'nparents'} - 1);
1520 if ($to->{'href'}) {
1521 $line .= $cgi->a({-href
=>$to->{'href'}, -class=>"hash"},
1522 substr($diffinfo->{'to_id'},0,7));
1527 } elsif ($line =~ m/^index [0-9a-fA-F]{40}..[0-9a-fA-F]{40}/) {
1528 # can match only for ordinary diff
1529 my ($from_link, $to_link);
1530 if ($from->{'href'}) {
1531 $from_link = $cgi->a({-href
=>$from->{'href'}, -class=>"hash"},
1532 substr($diffinfo->{'from_id'},0,7));
1534 $from_link = '0' x
7;
1536 if ($to->{'href'}) {
1537 $to_link = $cgi->a({-href
=>$to->{'href'}, -class=>"hash"},
1538 substr($diffinfo->{'to_id'},0,7));
1542 my ($from_id, $to_id) = ($diffinfo->{'from_id'}, $diffinfo->{'to_id'});
1543 $line =~ s!$from_id\.\.$to_id!$from_link..$to_link!;
1546 return $line . "<br/>\n";
1549 # format from-file/to-file diff header
1550 sub format_diff_from_to_header
{
1551 my ($from_line, $to_line, $diffinfo, $from, $to, @parents) = @_;
1556 #assert($line =~ m/^---/) if DEBUG;
1557 # no extra formatting for "^--- /dev/null"
1558 if (! $diffinfo->{'nparents'}) {
1559 # ordinary (single parent) diff
1560 if ($line =~ m!^--- "?a/!) {
1561 if ($from->{'href'}) {
1563 $cgi->a({-href
=>$from->{'href'}, -class=>"path"},
1564 esc_path
($from->{'file'}));
1567 esc_path
($from->{'file'});
1570 $result .= qq!<div
class="diff from_file">$line</div
>\n!;
1573 # combined diff (merge commit)
1574 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
1575 if ($from->{'href'}[$i]) {
1577 $cgi->a({-href
=>href
(action
=>"blobdiff",
1578 hash_parent
=>$diffinfo->{'from_id'}[$i],
1579 hash_parent_base
=>$parents[$i],
1580 file_parent
=>$from->{'file'}[$i],
1581 hash
=>$diffinfo->{'to_id'},
1583 file_name
=>$to->{'file'}),
1585 -title
=>"diff" . ($i+1)},
1588 $cgi->a({-href
=>$from->{'href'}[$i], -class=>"path"},
1589 esc_path
($from->{'file'}[$i]));
1591 $line = '--- /dev/null';
1593 $result .= qq!<div
class="diff from_file">$line</div
>\n!;
1598 #assert($line =~ m/^\+\+\+/) if DEBUG;
1599 # no extra formatting for "^+++ /dev/null"
1600 if ($line =~ m!^\+\+\+ "?b/!) {
1601 if ($to->{'href'}) {
1603 $cgi->a({-href
=>$to->{'href'}, -class=>"path"},
1604 esc_path
($to->{'file'}));
1607 esc_path
($to->{'file'});
1610 $result .= qq!<div
class="diff to_file">$line</div
>\n!;
1615 # create note for patch simplified by combined diff
1616 sub format_diff_cc_simplified
{
1617 my ($diffinfo, @parents) = @_;
1620 $result .= "<div class=\"diff header\">" .
1622 if (!is_deleted
($diffinfo)) {
1623 $result .= $cgi->a({-href
=> href
(action
=>"blob",
1625 hash
=>$diffinfo->{'to_id'},
1626 file_name
=>$diffinfo->{'to_file'}),
1628 esc_path
($diffinfo->{'to_file'}));
1630 $result .= esc_path
($diffinfo->{'to_file'});
1632 $result .= "</div>\n" . # class="diff header"
1633 "<div class=\"diff nodifferences\">" .
1635 "</div>\n"; # class="diff nodifferences"
1640 # format patch (diff) line (not to be used for diff headers)
1641 sub format_diff_line
{
1643 my ($from, $to) = @_;
1644 my $diff_class = "";
1648 if ($from && $to && ref($from->{'href'}) eq "ARRAY") {
1650 my $prefix = substr($line, 0, scalar @
{$from->{'href'}});
1651 if ($line =~ m/^\@{3}/) {
1652 $diff_class = " chunk_header";
1653 } elsif ($line =~ m/^\\/) {
1654 $diff_class = " incomplete";
1655 } elsif ($prefix =~ tr/+/+/) {
1656 $diff_class = " add";
1657 } elsif ($prefix =~ tr/-/-/) {
1658 $diff_class = " rem";
1661 # assume ordinary diff
1662 my $char = substr($line, 0, 1);
1664 $diff_class = " add";
1665 } elsif ($char eq '-') {
1666 $diff_class = " rem";
1667 } elsif ($char eq '@') {
1668 $diff_class = " chunk_header";
1669 } elsif ($char eq "\\") {
1670 $diff_class = " incomplete";
1673 $line = untabify
($line);
1674 if ($from && $to && $line =~ m/^\@{2} /) {
1675 my ($from_text, $from_start, $from_lines, $to_text, $to_start, $to_lines, $section) =
1676 $line =~ m/^\@{2} (-(\d+)(?:,(\d+))?) (\+(\d+)(?:,(\d+))?) \@{2}(.*)$/;
1678 $from_lines = 0 unless defined $from_lines;
1679 $to_lines = 0 unless defined $to_lines;
1681 if ($from->{'href'}) {
1682 $from_text = $cgi->a({-href
=>"$from->{'href'}#l$from_start",
1683 -class=>"list"}, $from_text);
1685 if ($to->{'href'}) {
1686 $to_text = $cgi->a({-href
=>"$to->{'href'}#l$to_start",
1687 -class=>"list"}, $to_text);
1689 $line = "<span class=\"chunk_info\">@@ $from_text $to_text @@</span>" .
1690 "<span class=\"section\">" . esc_html
($section, -nbsp
=>1) . "</span>";
1691 return "<div class=\"diff$diff_class\">$line</div>\n";
1692 } elsif ($from && $to && $line =~ m/^\@{3}/) {
1693 my ($prefix, $ranges, $section) = $line =~ m/^(\@+) (.*?) \@+(.*)$/;
1694 my (@from_text, @from_start, @from_nlines, $to_text, $to_start, $to_nlines);
1696 @from_text = split(' ', $ranges);
1697 for (my $i = 0; $i < @from_text; ++$i) {
1698 ($from_start[$i], $from_nlines[$i]) =
1699 (split(',', substr($from_text[$i], 1)), 0);
1702 $to_text = pop @from_text;
1703 $to_start = pop @from_start;
1704 $to_nlines = pop @from_nlines;
1706 $line = "<span class=\"chunk_info\">$prefix ";
1707 for (my $i = 0; $i < @from_text; ++$i) {
1708 if ($from->{'href'}[$i]) {
1709 $line .= $cgi->a({-href
=>"$from->{'href'}[$i]#l$from_start[$i]",
1710 -class=>"list"}, $from_text[$i]);
1712 $line .= $from_text[$i];
1716 if ($to->{'href'}) {
1717 $line .= $cgi->a({-href
=>"$to->{'href'}#l$to_start",
1718 -class=>"list"}, $to_text);
1722 $line .= " $prefix</span>" .
1723 "<span class=\"section\">" . esc_html
($section, -nbsp
=>1) . "</span>";
1724 return "<div class=\"diff$diff_class\">$line</div>\n";
1726 return "<div class=\"diff$diff_class\">" . esc_html
($line, -nbsp
=>1) . "</div>\n";
1729 # Generates undef or something like "_snapshot_" or "snapshot (_tbz2_ _zip_)",
1730 # linked. Pass the hash of the tree/commit to snapshot.
1731 sub format_snapshot_links
{
1733 my $num_fmts = @snapshot_fmts;
1734 if ($num_fmts > 1) {
1735 # A parenthesized list of links bearing format names.
1736 # e.g. "snapshot (_tar.gz_ _zip_)"
1737 return "snapshot (" . join(' ', map
1744 }, $known_snapshot_formats{$_}{'display'})
1745 , @snapshot_fmts) . ")";
1746 } elsif ($num_fmts == 1) {
1747 # A single "snapshot" link whose tooltip bears the format name.
1749 my ($fmt) = @snapshot_fmts;
1755 snapshot_format
=>$fmt
1757 -title
=> "in format: $known_snapshot_formats{$fmt}{'display'}"
1759 } else { # $num_fmts == 0
1764 ## ......................................................................
1765 ## functions returning values to be passed, perhaps after some
1766 ## transformation, to other functions; e.g. returning arguments to href()
1768 # returns hash to be passed to href to generate gitweb URL
1769 # in -title key it returns description of link
1771 my $format = shift || 'Atom';
1772 my %res = (action
=> lc($format));
1774 # feed links are possible only for project views
1775 return unless (defined $project);
1776 # some views should link to OPML, or to generic project feed,
1777 # or don't have specific feed yet (so they should use generic)
1778 return if ($action =~ /^(?:tags|heads|forks|tag|search)$/x);
1781 # branches refs uses 'refs/heads/' prefix (fullname) to differentiate
1782 # from tag links; this also makes possible to detect branch links
1783 if ((defined $hash_base && $hash_base =~ m!^refs/heads/(.*)$!) ||
1784 (defined $hash && $hash =~ m!^refs/heads/(.*)$!)) {
1787 # find log type for feed description (title)
1789 if (defined $file_name) {
1790 $type = "history of $file_name";
1791 $type .= "/" if ($action eq 'tree');
1792 $type .= " on '$branch'" if (defined $branch);
1794 $type = "log of $branch" if (defined $branch);
1797 $res{-title
} = $type;
1798 $res{'hash'} = (defined $branch ?
"refs/heads/$branch" : undef);
1799 $res{'file_name'} = $file_name;
1804 ## ----------------------------------------------------------------------
1805 ## git utility subroutines, invoking git commands
1807 # returns path to the core git executable and the --git-dir parameter as list
1809 return $GIT, '--git-dir='.$git_dir;
1812 # quote the given arguments for passing them to the shell
1813 # quote_command("command", "arg 1", "arg with ' and ! characters")
1814 # => "'command' 'arg 1' 'arg with '\'' and '\!' characters'"
1815 # Try to avoid using this function wherever possible.
1818 map( { my $a = $_; $a =~ s/(['!])/'\\$1'/g; "'$a'" } @_ ));
1821 # get HEAD ref of given project as hash
1822 sub git_get_head_hash
{
1823 my $project = shift;
1824 my $o_git_dir = $git_dir;
1826 $git_dir = "$projectroot/$project";
1827 if (open my $fd, "-|", git_cmd
(), "rev-parse", "--verify", "HEAD") {
1830 if (defined $head && $head =~ /^([0-9a-fA-F]{40})$/) {
1834 if (defined $o_git_dir) {
1835 $git_dir = $o_git_dir;
1840 # get type of given object
1844 open my $fd, "-|", git_cmd
(), "cat-file", '-t', $hash or return;
1846 close $fd or return;
1851 # repository configuration
1852 our $config_file = '';
1855 # store multiple values for single key as anonymous array reference
1856 # single values stored directly in the hash, not as [ <value> ]
1857 sub hash_set_multi
{
1858 my ($hash, $key, $value) = @_;
1860 if (!exists $hash->{$key}) {
1861 $hash->{$key} = $value;
1862 } elsif (!ref $hash->{$key}) {
1863 $hash->{$key} = [ $hash->{$key}, $value ];
1865 push @
{$hash->{$key}}, $value;
1869 # return hash of git project configuration
1870 # optionally limited to some section, e.g. 'gitweb'
1871 sub git_parse_project_config
{
1872 my $section_regexp = shift;
1877 open my $fh, "-|", git_cmd
(), "config", '-z', '-l',
1880 while (my $keyval = <$fh>) {
1882 my ($key, $value) = split(/\n/, $keyval, 2);
1884 hash_set_multi
(\
%config, $key, $value)
1885 if (!defined $section_regexp || $key =~ /^(?:$section_regexp)\./o);
1892 # convert config value to boolean, 'true' or 'false'
1893 # no value, number > 0, 'true' and 'yes' values are true
1894 # rest of values are treated as false (never as error)
1895 sub config_to_bool
{
1898 # strip leading and trailing whitespace
1902 return (!defined $val || # section.key
1903 ($val =~ /^\d+$/ && $val) || # section.key = 1
1904 ($val =~ /^(?:true|yes)$/i)); # section.key = true
1907 # convert config value to simple decimal number
1908 # an optional value suffix of 'k', 'm', or 'g' will cause the value
1909 # to be multiplied by 1024, 1048576, or 1073741824
1913 # strip leading and trailing whitespace
1917 if (my ($num, $unit) = ($val =~ /^([0-9]*)([kmg])$/i)) {
1919 # unknown unit is treated as 1
1920 return $num * ($unit eq 'g' ?
1073741824 :
1921 $unit eq 'm' ?
1048576 :
1922 $unit eq 'k' ?
1024 : 1);
1927 # convert config value to array reference, if needed
1928 sub config_to_multi
{
1931 return ref($val) ?
$val : (defined($val) ?
[ $val ] : []);
1934 sub git_get_project_config
{
1935 my ($key, $type) = @_;
1938 return unless ($key);
1939 $key =~ s/^gitweb\.//;
1940 return if ($key =~ m/\W/);
1943 if (defined $type) {
1946 unless ($type eq 'bool' || $type eq 'int');
1950 if (!defined $config_file ||
1951 $config_file ne "$git_dir/config") {
1952 %config = git_parse_project_config
('gitweb');
1953 $config_file = "$git_dir/config";
1957 if (!defined $type) {
1958 return $config{"gitweb.$key"};
1959 } elsif ($type eq 'bool') {
1960 # backward compatibility: 'git config --bool' returns true/false
1961 return config_to_bool
($config{"gitweb.$key"}) ?
'true' : 'false';
1962 } elsif ($type eq 'int') {
1963 return config_to_int
($config{"gitweb.$key"});
1965 return $config{"gitweb.$key"};
1968 # get hash of given path at given ref
1969 sub git_get_hash_by_path
{
1971 my $path = shift || return undef;
1976 open my $fd, "-|", git_cmd
(), "ls-tree", $base, "--", $path
1977 or die_error
(500, "Open git-ls-tree failed");
1979 close $fd or return undef;
1981 if (!defined $line) {
1982 # there is no tree or hash given by $path at $base
1986 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa panic.c'
1987 $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t/;
1988 if (defined $type && $type ne $2) {
1989 # type doesn't match
1995 # get path of entry with given hash at given tree-ish (ref)
1996 # used to get 'from' filename for combined diff (merge commit) for renames
1997 sub git_get_path_by_hash
{
1998 my $base = shift || return;
1999 my $hash = shift || return;
2003 open my $fd, "-|", git_cmd
(), "ls-tree", '-r', '-t', '-z', $base
2005 while (my $line = <$fd>) {
2008 #'040000 tree 595596a6a9117ddba9fe379b6b012b558bac8423 gitweb'
2009 #'100644 blob e02e90f0429be0d2a69b76571101f20b8f75530f gitweb/README'
2010 if ($line =~ m/(?:[0-9]+) (?:.+) $hash\t(.+)$/) {
2019 ## ......................................................................
2020 ## git utility functions, directly accessing git repository
2022 sub git_get_project_description
{
2025 $git_dir = "$projectroot/$path";
2026 open my $fd, "$git_dir/description"
2027 or return git_get_project_config
('description');
2030 if (defined $descr) {
2036 sub git_get_project_ctags
{
2040 $git_dir = "$projectroot/$path";
2041 unless (opendir D
, "$git_dir/ctags") {
2044 foreach (grep { -f
$_ } map { "$git_dir/ctags/$_" } readdir(D
)) {
2045 open CT
, $_ or next;
2049 my $ctag = $_; $ctag =~ s
#.*/##;
2050 $ctags->{$ctag} = $val;
2056 sub git_populate_project_tagcloud
{
2059 # First, merge different-cased tags; tags vote on casing
2061 foreach (keys %$ctags) {
2062 $ctags_lc{lc $_}->{count
} += $ctags->{$_};
2063 if (not $ctags_lc{lc $_}->{topcount
}
2064 or $ctags_lc{lc $_}->{topcount
} < $ctags->{$_}) {
2065 $ctags_lc{lc $_}->{topcount
} = $ctags->{$_};
2066 $ctags_lc{lc $_}->{topname
} = $_;
2071 if (eval { require HTML
::TagCloud
; 1; }) {
2072 $cloud = HTML
::TagCloud
->new;
2073 foreach (sort keys %ctags_lc) {
2074 # Pad the title with spaces so that the cloud looks
2076 my $title = $ctags_lc{$_}->{topname
};
2077 $title =~ s/ / /g;
2078 $title =~ s/^/ /g;
2079 $title =~ s/$/ /g;
2080 $cloud->add($title, $home_link."?by_tag=".$_, $ctags_lc{$_}->{count
});
2083 $cloud = \
%ctags_lc;
2088 sub git_show_project_tagcloud
{
2089 my ($cloud, $count) = @_;
2090 print STDERR
ref($cloud)."..\n";
2091 if (ref $cloud eq 'HTML::TagCloud') {
2092 return $cloud->html_and_css($count);
2094 my @tags = sort { $cloud->{$a}->{count
} <=> $cloud->{$b}->{count
} } keys %$cloud;
2095 return '<p align="center">' . join (', ', map {
2096 "<a href=\"$home_link?by_tag=$_\">$cloud->{$_}->{topname}</a>"
2097 } splice(@tags, 0, $count)) . '</p>';
2101 sub git_get_project_url_list
{
2104 $git_dir = "$projectroot/$path";
2105 open my $fd, "$git_dir/cloneurl"
2106 or return wantarray ?
2107 @
{ config_to_multi
(git_get_project_config
('url')) } :
2108 config_to_multi
(git_get_project_config
('url'));
2109 my @git_project_url_list = map { chomp; $_ } <$fd>;
2112 return wantarray ?
@git_project_url_list : \
@git_project_url_list;
2115 sub git_get_projects_list
{
2120 $filter =~ s/\.git$//;
2122 my $check_forks = gitweb_check_feature
('forks');
2124 if (-d
$projects_list) {
2125 # search in directory
2126 my $dir = $projects_list . ($filter ?
"/$filter" : '');
2127 # remove the trailing "/"
2129 my $pfxlen = length("$dir");
2130 my $pfxdepth = ($dir =~ tr!/!!);
2133 follow_fast
=> 1, # follow symbolic links
2134 follow_skip
=> 2, # ignore duplicates
2135 dangling_symlinks
=> 0, # ignore dangling symlinks, silently
2137 # skip project-list toplevel, if we get it.
2138 return if (m!^[/.]$!);
2139 # only directories can be git repositories
2140 return unless (-d
$_);
2141 # don't traverse too deep (Find is super slow on os x)
2142 if (($File::Find
::name
=~ tr!/!!) - $pfxdepth > $project_maxdepth) {
2143 $File::Find
::prune
= 1;
2147 my $subdir = substr($File::Find
::name
, $pfxlen + 1);
2148 # we check related file in $projectroot
2149 if (check_export_ok
("$projectroot/$filter/$subdir")) {
2150 push @list, { path
=> ($filter ?
"$filter/" : '') . $subdir };
2151 $File::Find
::prune
= 1;
2156 } elsif (-f
$projects_list) {
2157 # read from file(url-encoded):
2158 # 'git%2Fgit.git Linus+Torvalds'
2159 # 'libs%2Fklibc%2Fklibc.git H.+Peter+Anvin'
2160 # 'linux%2Fhotplug%2Fudev.git Greg+Kroah-Hartman'
2162 open my ($fd), $projects_list or return;
2164 while (my $line = <$fd>) {
2166 my ($path, $owner) = split ' ', $line;
2167 $path = unescape
($path);
2168 $owner = unescape
($owner);
2169 if (!defined $path) {
2172 if ($filter ne '') {
2173 # looking for forks;
2174 my $pfx = substr($path, 0, length($filter));
2175 if ($pfx ne $filter) {
2178 my $sfx = substr($path, length($filter));
2179 if ($sfx !~ /^\/.*\
.git
$/) {
2182 } elsif ($check_forks) {
2184 foreach my $filter (keys %paths) {
2185 # looking for forks;
2186 my $pfx = substr($path, 0, length($filter));
2187 if ($pfx ne $filter) {
2190 my $sfx = substr($path, length($filter));
2191 if ($sfx !~ /^\/.*\
.git
$/) {
2194 # is a fork, don't include it in
2199 if (check_export_ok
("$projectroot/$path")) {
2202 owner
=> to_utf8
($owner),
2205 (my $forks_path = $path) =~ s/\.git$//;
2206 $paths{$forks_path}++;
2214 our $gitweb_project_owner = undef;
2215 sub git_get_project_list_from_file
{
2217 return if (defined $gitweb_project_owner);
2219 $gitweb_project_owner = {};
2220 # read from file (url-encoded):
2221 # 'git%2Fgit.git Linus+Torvalds'
2222 # 'libs%2Fklibc%2Fklibc.git H.+Peter+Anvin'
2223 # 'linux%2Fhotplug%2Fudev.git Greg+Kroah-Hartman'
2224 if (-f
$projects_list) {
2225 open (my $fd , $projects_list);
2226 while (my $line = <$fd>) {
2228 my ($pr, $ow) = split ' ', $line;
2229 $pr = unescape
($pr);
2230 $ow = unescape
($ow);
2231 $gitweb_project_owner->{$pr} = to_utf8
($ow);
2237 sub git_get_project_owner
{
2238 my $project = shift;
2241 return undef unless $project;
2242 $git_dir = "$projectroot/$project";
2244 if (!defined $gitweb_project_owner) {
2245 git_get_project_list_from_file
();
2248 if (exists $gitweb_project_owner->{$project}) {
2249 $owner = $gitweb_project_owner->{$project};
2251 if (!defined $owner){
2252 $owner = git_get_project_config
('owner');
2254 if (!defined $owner) {
2255 $owner = get_file_owner
("$git_dir");
2261 sub git_get_last_activity
{
2265 $git_dir = "$projectroot/$path";
2266 open($fd, "-|", git_cmd
(), 'for-each-ref',
2267 '--format=%(committer)',
2268 '--sort=-committerdate',
2270 'refs/heads') or return;
2271 my $most_recent = <$fd>;
2272 close $fd or return;
2273 if (defined $most_recent &&
2274 $most_recent =~ / (\d+) [-+][01]\d\d\d$/) {
2276 my $age = time - $timestamp;
2277 return ($age, age_string
($age));
2279 return (undef, undef);
2282 sub git_get_references
{
2283 my $type = shift || "";
2285 # 5dc01c595e6c6ec9ccda4f6f69c131c0dd945f8c refs/tags/v2.6.11
2286 # c39ae07f393806ccf406ef966e9a15afc43cc36a refs/tags/v2.6.11^{}
2287 open my $fd, "-|", git_cmd
(), "show-ref", "--dereference",
2288 ($type ?
("--", "refs/$type") : ()) # use -- <pattern> if $type
2291 while (my $line = <$fd>) {
2293 if ($line =~ m!^([0-9a-fA-F]{40})\srefs/($type.*)$!) {
2294 if (defined $refs{$1}) {
2295 push @
{$refs{$1}}, $2;
2301 close $fd or return;
2305 sub git_get_rev_name_tags
{
2306 my $hash = shift || return undef;
2308 open my $fd, "-|", git_cmd
(), "name-rev", "--tags", $hash
2310 my $name_rev = <$fd>;
2313 if ($name_rev =~ m
|^$hash tags
/(.*)$|) {
2316 # catches also '$hash undefined' output
2321 ## ----------------------------------------------------------------------
2322 ## parse to hash functions
2326 my $tz = shift || "-0000";
2329 my @months = ("Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec");
2330 my @days = ("Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat");
2331 my ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($epoch);
2332 $date{'hour'} = $hour;
2333 $date{'minute'} = $min;
2334 $date{'mday'} = $mday;
2335 $date{'day'} = $days[$wday];
2336 $date{'month'} = $months[$mon];
2337 $date{'rfc2822'} = sprintf "%s, %d %s %4d %02d:%02d:%02d +0000",
2338 $days[$wday], $mday, $months[$mon], 1900+$year, $hour ,$min, $sec;
2339 $date{'mday-time'} = sprintf "%d %s %02d:%02d",
2340 $mday, $months[$mon], $hour ,$min;
2341 $date{'iso-8601'} = sprintf "%04d-%02d-%02dT%02d:%02d:%02dZ",
2342 1900+$year, 1+$mon, $mday, $hour ,$min, $sec;
2344 $tz =~ m/^([+\-][0-9][0-9])([0-9][0-9])$/;
2345 my $local = $epoch + ((int $1 + ($2/60)) * 3600);
2346 ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($local);
2347 $date{'hour_local'} = $hour;
2348 $date{'minute_local'} = $min;
2349 $date{'tz_local'} = $tz;
2350 $date{'iso-tz'} = sprintf("%04d-%02d-%02d %02d:%02d:%02d %s",
2351 1900+$year, $mon+1, $mday,
2352 $hour, $min, $sec, $tz);
2361 open my $fd, "-|", git_cmd
(), "cat-file", "tag", $tag_id or return;
2362 $tag{'id'} = $tag_id;
2363 while (my $line = <$fd>) {
2365 if ($line =~ m/^object ([0-9a-fA-F]{40})$/) {
2366 $tag{'object'} = $1;
2367 } elsif ($line =~ m/^type (.+)$/) {
2369 } elsif ($line =~ m/^tag (.+)$/) {
2371 } elsif ($line =~ m/^tagger (.*) ([0-9]+) (.*)$/) {
2372 $tag{'author'} = $1;
2375 } elsif ($line =~ m/--BEGIN/) {
2376 push @comment, $line;
2378 } elsif ($line eq "") {
2382 push @comment, <$fd>;
2383 $tag{'comment'} = \
@comment;
2384 close $fd or return;
2385 if (!defined $tag{'name'}) {
2391 sub parse_commit_text
{
2392 my ($commit_text, $withparents) = @_;
2393 my @commit_lines = split '\n', $commit_text;
2396 pop @commit_lines; # Remove '\0'
2398 if (! @commit_lines) {
2402 my $header = shift @commit_lines;
2403 if ($header !~ m/^[0-9a-fA-F]{40}/) {
2406 ($co{'id'}, my @parents) = split ' ', $header;
2407 while (my $line = shift @commit_lines) {
2408 last if $line eq "\n";
2409 if ($line =~ m/^tree ([0-9a-fA-F]{40})$/) {
2411 } elsif ((!defined $withparents) && ($line =~ m/^parent ([0-9a-fA-F]{40})$/)) {
2413 } elsif ($line =~ m/^author (.*) ([0-9]+) (.*)$/) {
2415 $co{'author_epoch'} = $2;
2416 $co{'author_tz'} = $3;
2417 if ($co{'author'} =~ m/^([^<]+) <([^>]*)>/) {
2418 $co{'author_name'} = $1;
2419 $co{'author_email'} = $2;
2421 $co{'author_name'} = $co{'author'};
2423 } elsif ($line =~ m/^committer (.*) ([0-9]+) (.*)$/) {
2424 $co{'committer'} = $1;
2425 $co{'committer_epoch'} = $2;
2426 $co{'committer_tz'} = $3;
2427 $co{'committer_name'} = $co{'committer'};
2428 if ($co{'committer'} =~ m/^([^<]+) <([^>]*)>/) {
2429 $co{'committer_name'} = $1;
2430 $co{'committer_email'} = $2;
2432 $co{'committer_name'} = $co{'committer'};
2436 if (!defined $co{'tree'}) {
2439 $co{'parents'} = \
@parents;
2440 $co{'parent'} = $parents[0];
2442 foreach my $title (@commit_lines) {
2445 $co{'title'} = chop_str
($title, 80, 5);
2446 # remove leading stuff of merges to make the interesting part visible
2447 if (length($title) > 50) {
2448 $title =~ s/^Automatic //;
2449 $title =~ s/^merge (of|with) /Merge ... /i;
2450 if (length($title) > 50) {
2451 $title =~ s/(http|rsync):\/\///;
2453 if (length($title) > 50) {
2454 $title =~ s/(master|www|rsync)\.//;
2456 if (length($title) > 50) {
2457 $title =~ s/kernel.org:?//;
2459 if (length($title) > 50) {
2460 $title =~ s/\/pub\/scm//;
2463 $co{'title_short'} = chop_str
($title, 50, 5);
2467 if (! defined $co{'title'} || $co{'title'} eq "") {
2468 $co{'title'} = $co{'title_short'} = '(no commit message)';
2470 # remove added spaces
2471 foreach my $line (@commit_lines) {
2474 $co{'comment'} = \
@commit_lines;
2476 my $age = time - $co{'committer_epoch'};
2478 $co{'age_string'} = age_string
($age);
2479 my ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday) = gmtime($co{'committer_epoch'});
2480 if ($age > 60*60*24*7*2) {
2481 $co{'age_string_date'} = sprintf "%4i-%02u-%02i", 1900 + $year, $mon+1, $mday;
2482 $co{'age_string_age'} = $co{'age_string'};
2484 $co{'age_string_date'} = $co{'age_string'};
2485 $co{'age_string_age'} = sprintf "%4i-%02u-%02i", 1900 + $year, $mon+1, $mday;
2491 my ($commit_id) = @_;
2496 open my $fd, "-|", git_cmd
(), "rev-list",
2502 or die_error
(500, "Open git-rev-list failed");
2503 %co = parse_commit_text
(<$fd>, 1);
2510 my ($commit_id, $maxcount, $skip, $filename, @args) = @_;
2518 open my $fd, "-|", git_cmd
(), "rev-list",
2521 ("--max-count=" . $maxcount),
2522 ("--skip=" . $skip),
2526 ($filename ?
($filename) : ())
2527 or die_error
(500, "Open git-rev-list failed");
2528 while (my $line = <$fd>) {
2529 my %co = parse_commit_text
($line);
2534 return wantarray ?
@cos : \
@cos;
2537 # parse line of git-diff-tree "raw" output
2538 sub parse_difftree_raw_line
{
2542 # ':100644 100644 03b218260e99b78c6df0ed378e59ed9205ccc96d 3b93d5e7cc7f7dd4ebed13a5cc1a4ad976fc94d8 M ls-files.c'
2543 # ':100644 100644 7f9281985086971d3877aca27704f2aaf9c448ce bc190ebc71bbd923f2b728e505408f5e54bd073a M rev-tree.c'
2544 if ($line =~ m/^:([0-7]{6}) ([0-7]{6}) ([0-9a-fA-F]{40}) ([0-9a-fA-F]{40}) (.)([0-9]{0,3})\t(.*)$/) {
2545 $res{'from_mode'} = $1;
2546 $res{'to_mode'} = $2;
2547 $res{'from_id'} = $3;
2549 $res{'status'} = $5;
2550 $res{'similarity'} = $6;
2551 if ($res{'status'} eq 'R' || $res{'status'} eq 'C') { # renamed or copied
2552 ($res{'from_file'}, $res{'to_file'}) = map { unquote
($_) } split("\t", $7);
2554 $res{'from_file'} = $res{'to_file'} = $res{'file'} = unquote
($7);
2557 # '::100755 100755 100755 60e79ca1b01bc8b057abe17ddab484699a7f5fdb 94067cc5f73388f33722d52ae02f44692bc07490 94067cc5f73388f33722d52ae02f44692bc07490 MR git-gui/git-gui.sh'
2558 # combined diff (for merge commit)
2559 elsif ($line =~ s/^(::+)((?:[0-7]{6} )+)((?:[0-9a-fA-F]{40} )+)([a-zA-Z]+)\t(.*)$//) {
2560 $res{'nparents'} = length($1);
2561 $res{'from_mode'} = [ split(' ', $2) ];
2562 $res{'to_mode'} = pop @
{$res{'from_mode'}};
2563 $res{'from_id'} = [ split(' ', $3) ];
2564 $res{'to_id'} = pop @
{$res{'from_id'}};
2565 $res{'status'} = [ split('', $4) ];
2566 $res{'to_file'} = unquote
($5);
2568 # 'c512b523472485aef4fff9e57b229d9d243c967f'
2569 elsif ($line =~ m/^([0-9a-fA-F]{40})$/) {
2570 $res{'commit'} = $1;
2573 return wantarray ?
%res : \
%res;
2576 # wrapper: return parsed line of git-diff-tree "raw" output
2577 # (the argument might be raw line, or parsed info)
2578 sub parsed_difftree_line
{
2579 my $line_or_ref = shift;
2581 if (ref($line_or_ref) eq "HASH") {
2582 # pre-parsed (or generated by hand)
2583 return $line_or_ref;
2585 return parse_difftree_raw_line
($line_or_ref);
2589 # parse line of git-ls-tree output
2590 sub parse_ls_tree_line
($;%) {
2595 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa panic.c'
2596 $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t(.+)$/s;
2604 $res{'name'} = unquote
($4);
2607 return wantarray ?
%res : \
%res;
2610 # generates _two_ hashes, references to which are passed as 2 and 3 argument
2611 sub parse_from_to_diffinfo
{
2612 my ($diffinfo, $from, $to, @parents) = @_;
2614 if ($diffinfo->{'nparents'}) {
2616 $from->{'file'} = [];
2617 $from->{'href'} = [];
2618 fill_from_file_info
($diffinfo, @parents)
2619 unless exists $diffinfo->{'from_file'};
2620 for (my $i = 0; $i < $diffinfo->{'nparents'}; $i++) {
2621 $from->{'file'}[$i] =
2622 defined $diffinfo->{'from_file'}[$i] ?
2623 $diffinfo->{'from_file'}[$i] :
2624 $diffinfo->{'to_file'};
2625 if ($diffinfo->{'status'}[$i] ne "A") { # not new (added) file
2626 $from->{'href'}[$i] = href
(action
=>"blob",
2627 hash_base
=>$parents[$i],
2628 hash
=>$diffinfo->{'from_id'}[$i],
2629 file_name
=>$from->{'file'}[$i]);
2631 $from->{'href'}[$i] = undef;
2635 # ordinary (not combined) diff
2636 $from->{'file'} = $diffinfo->{'from_file'};
2637 if ($diffinfo->{'status'} ne "A") { # not new (added) file
2638 $from->{'href'} = href
(action
=>"blob", hash_base
=>$hash_parent,
2639 hash
=>$diffinfo->{'from_id'},
2640 file_name
=>$from->{'file'});
2642 delete $from->{'href'};
2646 $to->{'file'} = $diffinfo->{'to_file'};
2647 if (!is_deleted
($diffinfo)) { # file exists in result
2648 $to->{'href'} = href
(action
=>"blob", hash_base
=>$hash,
2649 hash
=>$diffinfo->{'to_id'},
2650 file_name
=>$to->{'file'});
2652 delete $to->{'href'};
2656 ## ......................................................................
2657 ## parse to array of hashes functions
2659 sub git_get_heads_list
{
2663 open my $fd, '-|', git_cmd
(), 'for-each-ref',
2664 ($limit ?
'--count='.($limit+1) : ()), '--sort=-committerdate',
2665 '--format=%(objectname) %(refname) %(subject)%00%(committer)',
2668 while (my $line = <$fd>) {
2672 my ($refinfo, $committerinfo) = split(/\0/, $line);
2673 my ($hash, $name, $title) = split(' ', $refinfo, 3);
2674 my ($committer, $epoch, $tz) =
2675 ($committerinfo =~ /^(.*) ([0-9]+) (.*)$/);
2676 $ref_item{'fullname'} = $name;
2677 $name =~ s!^refs/heads/!!;
2679 $ref_item{'name'} = $name;
2680 $ref_item{'id'} = $hash;
2681 $ref_item{'title'} = $title || '(no commit message)';
2682 $ref_item{'epoch'} = $epoch;
2684 $ref_item{'age'} = age_string
(time - $ref_item{'epoch'});
2686 $ref_item{'age'} = "unknown";
2689 push @headslist, \
%ref_item;
2693 return wantarray ?
@headslist : \
@headslist;
2696 sub git_get_tags_list
{
2700 open my $fd, '-|', git_cmd
(), 'for-each-ref',
2701 ($limit ?
'--count='.($limit+1) : ()), '--sort=-creatordate',
2702 '--format=%(objectname) %(objecttype) %(refname) '.
2703 '%(*objectname) %(*objecttype) %(subject)%00%(creator)',
2706 while (my $line = <$fd>) {
2710 my ($refinfo, $creatorinfo) = split(/\0/, $line);
2711 my ($id, $type, $name, $refid, $reftype, $title) = split(' ', $refinfo, 6);
2712 my ($creator, $epoch, $tz) =
2713 ($creatorinfo =~ /^(.*) ([0-9]+) (.*)$/);
2714 $ref_item{'fullname'} = $name;
2715 $name =~ s!^refs/tags/!!;
2717 $ref_item{'type'} = $type;
2718 $ref_item{'id'} = $id;
2719 $ref_item{'name'} = $name;
2720 if ($type eq "tag") {
2721 $ref_item{'subject'} = $title;
2722 $ref_item{'reftype'} = $reftype;
2723 $ref_item{'refid'} = $refid;
2725 $ref_item{'reftype'} = $type;
2726 $ref_item{'refid'} = $id;
2729 if ($type eq "tag" || $type eq "commit") {
2730 $ref_item{'epoch'} = $epoch;
2732 $ref_item{'age'} = age_string
(time - $ref_item{'epoch'});
2734 $ref_item{'age'} = "unknown";
2738 push @tagslist, \
%ref_item;
2742 return wantarray ?
@tagslist : \
@tagslist;
2745 ## ----------------------------------------------------------------------
2746 ## filesystem-related functions
2748 sub get_file_owner
{
2751 my ($dev, $ino, $mode, $nlink, $st_uid, $st_gid, $rdev, $size) = stat($path);
2752 my ($name, $passwd, $uid, $gid, $quota, $comment, $gcos, $dir, $shell) = getpwuid($st_uid);
2753 if (!defined $gcos) {
2757 $owner =~ s/[,;].*$//;
2758 return to_utf8
($owner);
2761 # assume that file exists
2763 my $filename = shift;
2765 open my $fd, '<', $filename;
2766 print map(to_utf8
, <$fd>);
2770 ## ......................................................................
2771 ## mimetype related functions
2773 sub mimetype_guess_file
{
2774 my $filename = shift;
2775 my $mimemap = shift;
2776 -r
$mimemap or return undef;
2779 open(MIME
, $mimemap) or return undef;
2781 next if m/^#/; # skip comments
2782 my ($mime, $exts) = split(/\t+/);
2783 if (defined $exts) {
2784 my @exts = split(/\s+/, $exts);
2785 foreach my $ext (@exts) {
2786 $mimemap{$ext} = $mime;
2792 $filename =~ /\.([^.]*)$/;
2793 return $mimemap{$1};
2796 sub mimetype_guess
{
2797 my $filename = shift;
2799 $filename =~ /\./ or return undef;
2801 if ($mimetypes_file) {
2802 my $file = $mimetypes_file;
2803 if ($file !~ m!^/!) { # if it is relative path
2804 # it is relative to project
2805 $file = "$projectroot/$project/$file";
2807 $mime = mimetype_guess_file
($filename, $file);
2809 $mime ||= mimetype_guess_file
($filename, '/etc/mime.types');
2815 my $filename = shift;
2818 my $mime = mimetype_guess
($filename);
2819 $mime and return $mime;
2823 return $default_blob_plain_mimetype unless $fd;
2826 return 'text/plain';
2827 } elsif (! $filename) {
2828 return 'application/octet-stream';
2829 } elsif ($filename =~ m/\.png$/i) {
2831 } elsif ($filename =~ m/\.gif$/i) {
2833 } elsif ($filename =~ m/\.jpe?g$/i) {
2834 return 'image/jpeg';
2836 return 'application/octet-stream';
2840 sub blob_contenttype
{
2841 my ($fd, $file_name, $type) = @_;
2843 $type ||= blob_mimetype
($fd, $file_name);
2844 if ($type eq 'text/plain' && defined $default_text_plain_charset) {
2845 $type .= "; charset=$default_text_plain_charset";
2851 ## ======================================================================
2852 ## functions printing HTML: header, footer, error page
2854 sub git_header_html
{
2855 my $status = shift || "200 OK";
2856 my $expires = shift;
2858 my $title = "$site_name";
2859 if (defined $project) {
2860 $title .= " - " . to_utf8
($project);
2861 if (defined $action) {
2862 $title .= "/$action";
2863 if (defined $file_name) {
2864 $title .= " - " . esc_path
($file_name);
2865 if ($action eq "tree" && $file_name !~ m
|/$|) {
2872 # require explicit support from the UA if we are to send the page as
2873 # 'application/xhtml+xml', otherwise send it as plain old 'text/html'.
2874 # we have to do this because MSIE sometimes globs '*/*', pretending to
2875 # support xhtml+xml but choking when it gets what it asked for.
2876 if (defined $cgi->http('HTTP_ACCEPT') &&
2877 $cgi->http('HTTP_ACCEPT') =~ m/(,|;|\s|^)application\/xhtml\
+xml
(,|;|\s
|$)/ &&
2878 $cgi->Accept('application/xhtml+xml') != 0) {
2879 $content_type = 'application/xhtml+xml';
2881 $content_type = 'text/html';
2883 print $cgi->header(-type
=>$content_type, -charset
=> 'utf-8',
2884 -status
=> $status, -expires
=> $expires);
2885 my $mod_perl_version = $ENV{'MOD_PERL'} ?
" $ENV{'MOD_PERL'}" : '';
2887 <?xml version="1.0" encoding="utf-8"?>
2888 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2889 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US" lang="en-US">
2890 <!-- git web interface version $version, (C) 2005-2006, Kay Sievers <kay.sievers\@vrfy.org>, Christian Gierke -->
2891 <!-- git core binaries version $git_version -->
2893 <meta http-equiv="content-type" content="$content_type; charset=utf-8"/>
2894 <meta name="generator" content="gitweb/$version git/$git_version$mod_perl_version"/>
2895 <meta name="robots" content="index, nofollow"/>
2896 <title>$title</title>
2898 # print out each stylesheet that exist
2899 if (defined $stylesheet) {
2900 #provides backwards capability for those people who define style sheet in a config file
2901 print '<link rel="stylesheet" type="text/css" href="'.$stylesheet.'"/>'."\n";
2903 foreach my $stylesheet (@stylesheets) {
2904 next unless $stylesheet;
2905 print '<link rel="stylesheet" type="text/css" href="'.$stylesheet.'"/>'."\n";
2908 if (defined $project) {
2909 my %href_params = get_feed_info
();
2910 if (!exists $href_params{'-title'}) {
2911 $href_params{'-title'} = 'log';
2914 foreach my $format qw(RSS Atom) {
2915 my $type = lc($format);
2917 '-rel' => 'alternate',
2918 '-title' => "$project - $href_params{'-title'} - $format feed",
2919 '-type' => "application/$type+xml"
2922 $href_params{'action'} = $type;
2923 $link_attr{'-href'} = href
(%href_params);
2925 "rel=\"$link_attr{'-rel'}\" ".
2926 "title=\"$link_attr{'-title'}\" ".
2927 "href=\"$link_attr{'-href'}\" ".
2928 "type=\"$link_attr{'-type'}\" ".
2931 $href_params{'extra_options'} = '--no-merges';
2932 $link_attr{'-href'} = href
(%href_params);
2933 $link_attr{'-title'} .= ' (no merges)';
2935 "rel=\"$link_attr{'-rel'}\" ".
2936 "title=\"$link_attr{'-title'}\" ".
2937 "href=\"$link_attr{'-href'}\" ".
2938 "type=\"$link_attr{'-type'}\" ".
2943 printf('<link rel="alternate" title="%s projects list" '.
2944 'href="%s" type="text/plain; charset=utf-8" />'."\n",
2945 $site_name, href
(project
=>undef, action
=>"project_index"));
2946 printf('<link rel="alternate" title="%s projects feeds" '.
2947 'href="%s" type="text/x-opml" />'."\n",
2948 $site_name, href
(project
=>undef, action
=>"opml"));
2950 if (defined $favicon) {
2951 print qq(<link rel
="shortcut icon" href
="$favicon" type
="image/png" />\n);
2957 if (-f
$site_header) {
2958 insert_file
($site_header);
2961 print "<div class=\"page_header\">\n" .
2962 $cgi->a({-href
=> esc_url
($logo_url),
2963 -title
=> $logo_label},
2964 qq(<img src
="$logo" width
="72" height
="27" alt
="git" class="logo"/>));
2965 print $cgi->a({-href
=> esc_url
($home_link)}, $home_link_str) . " / ";
2966 if (defined $project) {
2967 print $cgi->a({-href
=> href
(action
=>"summary")}, esc_html
($project));
2968 if (defined $action) {
2975 my $have_search = gitweb_check_feature
('search');
2976 if (defined $project && $have_search) {
2977 if (!defined $searchtext) {
2981 if (defined $hash_base) {
2982 $search_hash = $hash_base;
2983 } elsif (defined $hash) {
2984 $search_hash = $hash;
2986 $search_hash = "HEAD";
2988 my $action = $my_uri;
2989 my $use_pathinfo = gitweb_check_feature
('pathinfo');
2990 if ($use_pathinfo) {
2991 $action .= "/".esc_url
($project);
2993 print $cgi->startform(-method
=> "get", -action
=> $action) .
2994 "<div class=\"search\">\n" .
2996 $cgi->input({-name
=>"p", -value
=>$project, -type
=>"hidden"}) . "\n") .
2997 $cgi->input({-name
=>"a", -value
=>"search", -type
=>"hidden"}) . "\n" .
2998 $cgi->input({-name
=>"h", -value
=>$search_hash, -type
=>"hidden"}) . "\n" .
2999 $cgi->popup_menu(-name
=> 'st', -default => 'commit',
3000 -values => ['commit', 'grep', 'author', 'committer', 'pickaxe']) .
3001 $cgi->sup($cgi->a({-href
=> href
(action
=>"search_help")}, "?")) .
3003 $cgi->textfield(-name
=> "s", -value
=> $searchtext) . "\n" .
3004 "<span title=\"Extended regular expression\">" .
3005 $cgi->checkbox(-name
=> 'sr', -value
=> 1, -label
=> 're',
3006 -checked
=> $search_use_regexp) .
3009 $cgi->end_form() . "\n";
3013 sub git_footer_html
{
3014 my $feed_class = 'rss_logo';
3016 print "<div class=\"page_footer\">\n";
3017 if (defined $project) {
3018 my $descr = git_get_project_description
($project);
3019 if (defined $descr) {
3020 print "<div class=\"page_footer_text\">" . esc_html
($descr) . "</div>\n";
3023 my %href_params = get_feed_info
();
3024 if (!%href_params) {
3025 $feed_class .= ' generic';
3027 $href_params{'-title'} ||= 'log';
3029 foreach my $format qw(RSS Atom) {
3030 $href_params{'action'} = lc($format);
3031 print $cgi->a({-href
=> href
(%href_params),
3032 -title
=> "$href_params{'-title'} $format feed",
3033 -class => $feed_class}, $format)."\n";
3037 print $cgi->a({-href
=> href
(project
=>undef, action
=>"opml"),
3038 -class => $feed_class}, "OPML") . " ";
3039 print $cgi->a({-href
=> href
(project
=>undef, action
=>"project_index"),
3040 -class => $feed_class}, "TXT") . "\n";
3042 print "</div>\n"; # class="page_footer"
3044 if (-f
$site_footer) {
3045 insert_file
($site_footer);
3052 # die_error(<http_status_code>, <error_message>)
3053 # Example: die_error(404, 'Hash not found')
3054 # By convention, use the following status codes (as defined in RFC 2616):
3055 # 400: Invalid or missing CGI parameters, or
3056 # requested object exists but has wrong type.
3057 # 403: Requested feature (like "pickaxe" or "snapshot") not enabled on
3058 # this server or project.
3059 # 404: Requested object/revision/project doesn't exist.
3060 # 500: The server isn't configured properly, or
3061 # an internal error occurred (e.g. failed assertions caused by bugs), or
3062 # an unknown error occurred (e.g. the git binary died unexpectedly).
3064 my $status = shift || 500;
3065 my $error = shift || "Internal server error";
3067 my %http_responses = (400 => '400 Bad Request',
3068 403 => '403 Forbidden',
3069 404 => '404 Not Found',
3070 500 => '500 Internal Server Error');
3071 git_header_html
($http_responses{$status});
3073 <div class="page_body">
3083 ## ----------------------------------------------------------------------
3084 ## functions printing or outputting HTML: navigation
3086 sub git_print_page_nav
{
3087 my ($current, $suppress, $head, $treehead, $treebase, $extra) = @_;
3088 $extra = '' if !defined $extra; # pager or formats
3090 my @navs = qw(summary shortlog log commit commitdiff tree);
3092 @navs = grep { $_ ne $suppress } @navs;
3095 my %arg = map { $_ => {action
=>$_} } @navs;
3096 if (defined $head) {
3097 for (qw(commit commitdiff)) {
3098 $arg{$_}{'hash'} = $head;
3100 if ($current =~ m/^(tree | log | shortlog | commit | commitdiff | search)$/x) {
3101 for (qw(shortlog log)) {
3102 $arg{$_}{'hash'} = $head;
3107 $arg{'tree'}{'hash'} = $treehead if defined $treehead;
3108 $arg{'tree'}{'hash_base'} = $treebase if defined $treebase;
3110 my @actions = gitweb_get_feature
('actions');
3113 'n' => $project, # project name
3114 'f' => $git_dir, # project path within filesystem
3115 'h' => $treehead || '', # current hash ('h' parameter)
3116 'b' => $treebase || '', # hash base ('hb' parameter)
3119 my ($label, $link, $pos) = splice(@actions,0,3);
3121 @navs = map { $_ eq $pos ?
($_, $label) : $_ } @navs;
3123 $link =~ s/%([%nfhb])/$repl{$1}/g;
3124 $arg{$label}{'_href'} = $link;
3127 print "<div class=\"page_nav\">\n" .
3129 map { $_ eq $current ?
3130 $_ : $cgi->a({-href
=> ($arg{$_}{_href
} ?
$arg{$_}{_href
} : href
(%{$arg{$_}}))}, "$_")
3132 print "<br/>\n$extra<br/>\n" .
3136 sub format_paging_nav
{
3137 my ($action, $hash, $head, $page, $has_next_link) = @_;
3141 if ($hash ne $head || $page) {
3142 $paging_nav .= $cgi->a({-href
=> href
(action
=>$action)}, "HEAD");
3144 $paging_nav .= "HEAD";
3148 $paging_nav .= " ⋅ " .
3149 $cgi->a({-href
=> href
(-replay
=>1, page
=>$page-1),
3150 -accesskey
=> "p", -title
=> "Alt-p"}, "prev");
3152 $paging_nav .= " ⋅ prev";
3155 if ($has_next_link) {
3156 $paging_nav .= " ⋅ " .
3157 $cgi->a({-href
=> href
(-replay
=>1, page
=>$page+1),
3158 -accesskey
=> "n", -title
=> "Alt-n"}, "next");
3160 $paging_nav .= " ⋅ next";
3166 ## ......................................................................
3167 ## functions printing or outputting HTML: div
3169 sub git_print_header_div
{
3170 my ($action, $title, $hash, $hash_base) = @_;
3173 $args{'action'} = $action;
3174 $args{'hash'} = $hash if $hash;
3175 $args{'hash_base'} = $hash_base if $hash_base;
3177 print "<div class=\"header\">\n" .
3178 $cgi->a({-href
=> href
(%args), -class => "title"},
3179 $title ?
$title : $action) .
3183 #sub git_print_authorship (\%) {
3184 sub git_print_authorship
{
3187 my %ad = parse_date
($co->{'author_epoch'}, $co->{'author_tz'});
3188 print "<div class=\"author_date\">" .
3189 esc_html
($co->{'author_name'}) .
3191 if ($ad{'hour_local'} < 6) {
3192 printf(" (<span class=\"atnight\">%02d:%02d</span> %s)",
3193 $ad{'hour_local'}, $ad{'minute_local'}, $ad{'tz_local'});
3195 printf(" (%02d:%02d %s)",
3196 $ad{'hour_local'}, $ad{'minute_local'}, $ad{'tz_local'});
3201 sub git_print_page_path
{
3207 print "<div class=\"page_path\">";
3208 print $cgi->a({-href
=> href
(action
=>"tree", hash_base
=>$hb),
3209 -title
=> 'tree root'}, to_utf8
("[$project]"));
3211 if (defined $name) {
3212 my @dirname = split '/', $name;
3213 my $basename = pop @dirname;
3216 foreach my $dir (@dirname) {
3217 $fullname .= ($fullname ?
'/' : '') . $dir;
3218 print $cgi->a({-href
=> href
(action
=>"tree", file_name
=>$fullname,
3220 -title
=> $fullname}, esc_path
($dir));
3223 if (defined $type && $type eq 'blob') {
3224 print $cgi->a({-href
=> href
(action
=>"blob_plain", file_name
=>$file_name,
3226 -title
=> $name}, esc_path
($basename));
3227 } elsif (defined $type && $type eq 'tree') {
3228 print $cgi->a({-href
=> href
(action
=>"tree", file_name
=>$file_name,
3230 -title
=> $name}, esc_path
($basename));
3233 print esc_path
($basename);
3236 print "<br/></div>\n";
3239 # sub git_print_log (\@;%) {
3240 sub git_print_log
($;%) {
3244 if ($opts{'-remove_title'}) {
3245 # remove title, i.e. first line of log
3248 # remove leading empty lines
3249 while (defined $log->[0] && $log->[0] eq "") {
3256 foreach my $line (@
$log) {
3257 if ($line =~ m/^ *(signed[ \-]off[ \-]by[ :]|acked[ \-]by[ :]|cc[ :])/i) {
3260 if (! $opts{'-remove_signoff'}) {
3261 print "<span class=\"signoff\">" . esc_html
($line) . "</span><br/>\n";
3264 # remove signoff lines
3271 # print only one empty line
3272 # do not print empty line after signoff
3274 next if ($empty || $signoff);
3280 print format_log_line_html
($line) . "<br/>\n";
3283 if ($opts{'-final_empty_line'}) {
3284 # end with single empty line
3285 print "<br/>\n" unless $empty;
3289 # return link target (what link points to)
3290 sub git_get_link_target
{
3295 open my $fd, "-|", git_cmd
(), "cat-file", "blob", $hash
3299 $link_target = <$fd>;
3304 return $link_target;
3307 # given link target, and the directory (basedir) the link is in,
3308 # return target of link relative to top directory (top tree);
3309 # return undef if it is not possible (including absolute links).
3310 sub normalize_link_target
{
3311 my ($link_target, $basedir, $hash_base) = @_;
3313 # we can normalize symlink target only if $hash_base is provided
3314 return unless $hash_base;
3316 # absolute symlinks (beginning with '/') cannot be normalized
3317 return if (substr($link_target, 0, 1) eq '/');
3319 # normalize link target to path from top (root) tree (dir)
3322 $path = $basedir . '/' . $link_target;
3324 # we are in top (root) tree (dir)
3325 $path = $link_target;
3328 # remove //, /./, and /../
3330 foreach my $part (split('/', $path)) {
3331 # discard '.' and ''
3332 next if (!$part || $part eq '.');
3334 if ($part eq '..') {
3338 # link leads outside repository (outside top dir)
3342 push @path_parts, $part;
3345 $path = join('/', @path_parts);
3350 # print tree entry (row of git_tree), but without encompassing <tr> element
3351 sub git_print_tree_entry
{
3352 my ($t, $basedir, $hash_base, $have_blame) = @_;
3355 $base_key{'hash_base'} = $hash_base if defined $hash_base;
3357 # The format of a table row is: mode list link. Where mode is
3358 # the mode of the entry, list is the name of the entry, an href,
3359 # and link is the action links of the entry.
3361 print "<td class=\"mode\">" . mode_str
($t->{'mode'}) . "</td>\n";
3362 if ($t->{'type'} eq "blob") {
3363 print "<td class=\"list\">" .
3364 $cgi->a({-href
=> href
(action
=>"blob", hash
=>$t->{'hash'},
3365 file_name
=>"$basedir$t->{'name'}", %base_key),
3366 -class => "list"}, esc_path
($t->{'name'}));
3367 if (S_ISLNK
(oct $t->{'mode'})) {
3368 my $link_target = git_get_link_target
($t->{'hash'});
3370 my $norm_target = normalize_link_target
($link_target, $basedir, $hash_base);
3371 if (defined $norm_target) {
3373 $cgi->a({-href
=> href
(action
=>"object", hash_base
=>$hash_base,
3374 file_name
=>$norm_target),
3375 -title
=> $norm_target}, esc_path
($link_target));
3377 print " -> " . esc_path
($link_target);
3382 print "<td class=\"link\">";
3383 print $cgi->a({-href
=> href
(action
=>"blob", hash
=>$t->{'hash'},
3384 file_name
=>"$basedir$t->{'name'}", %base_key)},
3388 $cgi->a({-href
=> href
(action
=>"blame", hash
=>$t->{'hash'},
3389 file_name
=>"$basedir$t->{'name'}", %base_key)},
3392 if (defined $hash_base) {
3394 $cgi->a({-href
=> href
(action
=>"history", hash_base
=>$hash_base,
3395 hash
=>$t->{'hash'}, file_name
=>"$basedir$t->{'name'}")},
3399 $cgi->a({-href
=> href
(action
=>"blob_plain", hash_base
=>$hash_base,
3400 file_name
=>"$basedir$t->{'name'}")},
3404 } elsif ($t->{'type'} eq "tree") {
3405 print "<td class=\"list\">";
3406 print $cgi->a({-href
=> href
(action
=>"tree", hash
=>$t->{'hash'},
3407 file_name
=>"$basedir$t->{'name'}", %base_key)},
3408 esc_path
($t->{'name'}));
3410 print "<td class=\"link\">";
3411 print $cgi->a({-href
=> href
(action
=>"tree", hash
=>$t->{'hash'},
3412 file_name
=>"$basedir$t->{'name'}", %base_key)},
3414 if (defined $hash_base) {
3416 $cgi->a({-href
=> href
(action
=>"history", hash_base
=>$hash_base,
3417 file_name
=>"$basedir$t->{'name'}")},
3422 # unknown object: we can only present history for it
3423 # (this includes 'commit' object, i.e. submodule support)
3424 print "<td class=\"list\">" .
3425 esc_path
($t->{'name'}) .
3427 print "<td class=\"link\">";
3428 if (defined $hash_base) {
3429 print $cgi->a({-href
=> href
(action
=>"history",
3430 hash_base
=>$hash_base,
3431 file_name
=>"$basedir$t->{'name'}")},
3438 ## ......................................................................
3439 ## functions printing large fragments of HTML
3441 # get pre-image filenames for merge (combined) diff
3442 sub fill_from_file_info
{
3443 my ($diff, @parents) = @_;
3445 $diff->{'from_file'} = [ ];
3446 $diff->{'from_file'}[$diff->{'nparents'} - 1] = undef;
3447 for (my $i = 0; $i < $diff->{'nparents'}; $i++) {
3448 if ($diff->{'status'}[$i] eq 'R' ||
3449 $diff->{'status'}[$i] eq 'C') {
3450 $diff->{'from_file'}[$i] =
3451 git_get_path_by_hash
($parents[$i], $diff->{'from_id'}[$i]);
3458 # is current raw difftree line of file deletion
3460 my $diffinfo = shift;
3462 return $diffinfo->{'to_id'} eq ('0' x
40);
3465 # does patch correspond to [previous] difftree raw line
3466 # $diffinfo - hashref of parsed raw diff format
3467 # $patchinfo - hashref of parsed patch diff format
3468 # (the same keys as in $diffinfo)
3469 sub is_patch_split
{
3470 my ($diffinfo, $patchinfo) = @_;
3472 return defined $diffinfo && defined $patchinfo
3473 && $diffinfo->{'to_file'} eq $patchinfo->{'to_file'};
3477 sub git_difftree_body
{
3478 my ($difftree, $hash, @parents) = @_;
3479 my ($parent) = $parents[0];
3480 my $have_blame = gitweb_check_feature
('blame');
3481 print "<div class=\"list_head\">\n";
3482 if ($#{$difftree} > 10) {
3483 print(($#{$difftree} + 1) . " files changed:\n");
3487 print "<table class=\"" .
3488 (@parents > 1 ?
"combined " : "") .
3491 # header only for combined diff in 'commitdiff' view
3492 my $has_header = @
$difftree && @parents > 1 && $action eq 'commitdiff';
3495 print "<thead><tr>\n" .
3496 "<th></th><th></th>\n"; # filename, patchN link
3497 for (my $i = 0; $i < @parents; $i++) {
3498 my $par = $parents[$i];
3500 $cgi->a({-href
=> href
(action
=>"commitdiff",
3501 hash
=>$hash, hash_parent
=>$par),
3502 -title
=> 'commitdiff to parent number ' .
3503 ($i+1) . ': ' . substr($par,0,7)},
3507 print "</tr></thead>\n<tbody>\n";
3512 foreach my $line (@
{$difftree}) {
3513 my $diff = parsed_difftree_line
($line);
3516 print "<tr class=\"dark\">\n";
3518 print "<tr class=\"light\">\n";
3522 if (exists $diff->{'nparents'}) { # combined diff
3524 fill_from_file_info
($diff, @parents)
3525 unless exists $diff->{'from_file'};
3527 if (!is_deleted
($diff)) {
3528 # file exists in the result (child) commit
3530 $cgi->a({-href
=> href
(action
=>"blob", hash
=>$diff->{'to_id'},
3531 file_name
=>$diff->{'to_file'},
3533 -class => "list"}, esc_path
($diff->{'to_file'})) .
3537 esc_path
($diff->{'to_file'}) .
3541 if ($action eq 'commitdiff') {
3544 print "<td class=\"link\">" .
3545 $cgi->a({-href
=> "#patch$patchno"}, "patch") .
3550 my $has_history = 0;
3551 my $not_deleted = 0;
3552 for (my $i = 0; $i < $diff->{'nparents'}; $i++) {
3553 my $hash_parent = $parents[$i];
3554 my $from_hash = $diff->{'from_id'}[$i];
3555 my $from_path = $diff->{'from_file'}[$i];
3556 my $status = $diff->{'status'}[$i];
3558 $has_history ||= ($status ne 'A');
3559 $not_deleted ||= ($status ne 'D');
3561 if ($status eq 'A') {
3562 print "<td class=\"link\" align=\"right\"> | </td>\n";
3563 } elsif ($status eq 'D') {
3564 print "<td class=\"link\">" .
3565 $cgi->a({-href
=> href
(action
=>"blob",
3568 file_name
=>$from_path)},
3572 if ($diff->{'to_id'} eq $from_hash) {
3573 print "<td class=\"link nochange\">";
3575 print "<td class=\"link\">";
3577 print $cgi->a({-href
=> href
(action
=>"blobdiff",
3578 hash
=>$diff->{'to_id'},
3579 hash_parent
=>$from_hash,
3581 hash_parent_base
=>$hash_parent,
3582 file_name
=>$diff->{'to_file'},
3583 file_parent
=>$from_path)},
3589 print "<td class=\"link\">";
3591 print $cgi->a({-href
=> href
(action
=>"blob",
3592 hash
=>$diff->{'to_id'},
3593 file_name
=>$diff->{'to_file'},
3596 print " | " if ($has_history);
3599 print $cgi->a({-href
=> href
(action
=>"history",
3600 file_name
=>$diff->{'to_file'},
3607 next; # instead of 'else' clause, to avoid extra indent
3609 # else ordinary diff
3611 my ($to_mode_oct, $to_mode_str, $to_file_type);
3612 my ($from_mode_oct, $from_mode_str, $from_file_type);
3613 if ($diff->{'to_mode'} ne ('0' x
6)) {
3614 $to_mode_oct = oct $diff->{'to_mode'};
3615 if (S_ISREG
($to_mode_oct)) { # only for regular file
3616 $to_mode_str = sprintf("%04o", $to_mode_oct & 0777); # permission bits
3618 $to_file_type = file_type
($diff->{'to_mode'});
3620 if ($diff->{'from_mode'} ne ('0' x
6)) {
3621 $from_mode_oct = oct $diff->{'from_mode'};
3622 if (S_ISREG
($to_mode_oct)) { # only for regular file
3623 $from_mode_str = sprintf("%04o", $from_mode_oct & 0777); # permission bits
3625 $from_file_type = file_type
($diff->{'from_mode'});
3628 if ($diff->{'status'} eq "A") { # created
3629 my $mode_chng = "<span class=\"file_status new\">[new $to_file_type";
3630 $mode_chng .= " with mode: $to_mode_str" if $to_mode_str;
3631 $mode_chng .= "]</span>";
3633 print $cgi->a({-href
=> href
(action
=>"blob", hash
=>$diff->{'to_id'},
3634 hash_base
=>$hash, file_name
=>$diff->{'file'}),
3635 -class => "list"}, esc_path
($diff->{'file'}));
3637 print "<td>$mode_chng</td>\n";
3638 print "<td class=\"link\">";
3639 if ($action eq 'commitdiff') {
3642 print $cgi->a({-href
=> "#patch$patchno"}, "patch");
3645 print $cgi->a({-href
=> href
(action
=>"blob", hash
=>$diff->{'to_id'},
3646 hash_base
=>$hash, file_name
=>$diff->{'file'})},
3650 } elsif ($diff->{'status'} eq "D") { # deleted
3651 my $mode_chng = "<span class=\"file_status deleted\">[deleted $from_file_type]</span>";
3653 print $cgi->a({-href
=> href
(action
=>"blob", hash
=>$diff->{'from_id'},
3654 hash_base
=>$parent, file_name
=>$diff->{'file'}),
3655 -class => "list"}, esc_path
($diff->{'file'}));
3657 print "<td>$mode_chng</td>\n";
3658 print "<td class=\"link\">";
3659 if ($action eq 'commitdiff') {
3662 print $cgi->a({-href
=> "#patch$patchno"}, "patch");
3665 print $cgi->a({-href
=> href
(action
=>"blob", hash
=>$diff->{'from_id'},
3666 hash_base
=>$parent, file_name
=>$diff->{'file'})},
3669 print $cgi->a({-href
=> href
(action
=>"blame", hash_base
=>$parent,
3670 file_name
=>$diff->{'file'})},
3673 print $cgi->a({-href
=> href
(action
=>"history", hash_base
=>$parent,
3674 file_name
=>$diff->{'file'})},
3678 } elsif ($diff->{'status'} eq "M" || $diff->{'status'} eq "T") { # modified, or type changed
3679 my $mode_chnge = "";
3680 if ($diff->{'from_mode'} != $diff->{'to_mode'}) {
3681 $mode_chnge = "<span class=\"file_status mode_chnge\">[changed";
3682 if ($from_file_type ne $to_file_type) {
3683 $mode_chnge .= " from $from_file_type to $to_file_type";
3685 if (($from_mode_oct & 0777) != ($to_mode_oct & 0777)) {
3686 if ($from_mode_str && $to_mode_str) {
3687 $mode_chnge .= " mode: $from_mode_str->$to_mode_str";
3688 } elsif ($to_mode_str) {
3689 $mode_chnge .= " mode: $to_mode_str";
3692 $mode_chnge .= "]</span>\n";
3695 print $cgi->a({-href
=> href
(action
=>"blob", hash
=>$diff->{'to_id'},
3696 hash_base
=>$hash, file_name
=>$diff->{'file'}),
3697 -class => "list"}, esc_path
($diff->{'file'}));
3699 print "<td>$mode_chnge</td>\n";
3700 print "<td class=\"link\">";
3701 if ($action eq 'commitdiff') {
3704 print $cgi->a({-href
=> "#patch$patchno"}, "patch") .
3706 } elsif ($diff->{'to_id'} ne $diff->{'from_id'}) {
3707 # "commit" view and modified file (not onlu mode changed)
3708 print $cgi->a({-href
=> href
(action
=>"blobdiff",
3709 hash
=>$diff->{'to_id'}, hash_parent
=>$diff->{'from_id'},
3710 hash_base
=>$hash, hash_parent_base
=>$parent,
3711 file_name
=>$diff->{'file'})},
3715 print $cgi->a({-href
=> href
(action
=>"blob", hash
=>$diff->{'to_id'},
3716 hash_base
=>$hash, file_name
=>$diff->{'file'})},
3719 print $cgi->a({-href
=> href
(action
=>"blame", hash_base
=>$hash,
3720 file_name
=>$diff->{'file'})},
3723 print $cgi->a({-href
=> href
(action
=>"history", hash_base
=>$hash,
3724 file_name
=>$diff->{'file'})},
3728 } elsif ($diff->{'status'} eq "R" || $diff->{'status'} eq "C") { # renamed or copied
3729 my %status_name = ('R' => 'moved', 'C' => 'copied');
3730 my $nstatus = $status_name{$diff->{'status'}};
3732 if ($diff->{'from_mode'} != $diff->{'to_mode'}) {
3733 # mode also for directories, so we cannot use $to_mode_str
3734 $mode_chng = sprintf(", mode: %04o", $to_mode_oct & 0777);
3737 $cgi->a({-href
=> href
(action
=>"blob", hash_base
=>$hash,
3738 hash
=>$diff->{'to_id'}, file_name
=>$diff->{'to_file'}),
3739 -class => "list"}, esc_path
($diff->{'to_file'})) . "</td>\n" .
3740 "<td><span class=\"file_status $nstatus\">[$nstatus from " .
3741 $cgi->a({-href
=> href
(action
=>"blob", hash_base
=>$parent,
3742 hash
=>$diff->{'from_id'}, file_name
=>$diff->{'from_file'}),
3743 -class => "list"}, esc_path
($diff->{'from_file'})) .
3744 " with " . (int $diff->{'similarity'}) . "% similarity$mode_chng]</span></td>\n" .
3745 "<td class=\"link\">";
3746 if ($action eq 'commitdiff') {
3749 print $cgi->a({-href
=> "#patch$patchno"}, "patch") .
3751 } elsif ($diff->{'to_id'} ne $diff->{'from_id'}) {
3752 # "commit" view and modified file (not only pure rename or copy)
3753 print $cgi->a({-href
=> href
(action
=>"blobdiff",
3754 hash
=>$diff->{'to_id'}, hash_parent
=>$diff->{'from_id'},
3755 hash_base
=>$hash, hash_parent_base
=>$parent,
3756 file_name
=>$diff->{'to_file'}, file_parent
=>$diff->{'from_file'})},
3760 print $cgi->a({-href
=> href
(action
=>"blob", hash
=>$diff->{'to_id'},
3761 hash_base
=>$parent, file_name
=>$diff->{'to_file'})},
3764 print $cgi->a({-href
=> href
(action
=>"blame", hash_base
=>$hash,
3765 file_name
=>$diff->{'to_file'})},
3768 print $cgi->a({-href
=> href
(action
=>"history", hash_base
=>$hash,
3769 file_name
=>$diff->{'to_file'})},
3773 } # we should not encounter Unmerged (U) or Unknown (X) status
3776 print "</tbody>" if $has_header;
3780 sub git_patchset_body
{
3781 my ($fd, $difftree, $hash, @hash_parents) = @_;
3782 my ($hash_parent) = $hash_parents[0];
3784 my $is_combined = (@hash_parents > 1);
3786 my $patch_number = 0;
3792 print "<div class=\"patchset\">\n";
3794 # skip to first patch
3795 while ($patch_line = <$fd>) {
3798 last if ($patch_line =~ m/^diff /);
3802 while ($patch_line) {
3804 # parse "git diff" header line
3805 if ($patch_line =~ m/^diff --git (\"(?:[^\\\"]*(?:\\.[^\\\"]*)*)\"|[^ "]*) (.*)$/) {
3806 # $1 is from_name, which we do not use
3807 $to_name = unquote
($2);
3808 $to_name =~ s!^b/!!;
3809 } elsif ($patch_line =~ m/^diff --(cc|combined) ("?.*"?)$/) {
3810 # $1 is 'cc' or 'combined', which we do not use
3811 $to_name = unquote
($2);
3816 # check if current patch belong to current raw line
3817 # and parse raw git-diff line if needed
3818 if (is_patch_split
($diffinfo, { 'to_file' => $to_name })) {
3819 # this is continuation of a split patch
3820 print "<div class=\"patch cont\">\n";
3822 # advance raw git-diff output if needed
3823 $patch_idx++ if defined $diffinfo;
3825 # read and prepare patch information
3826 $diffinfo = parsed_difftree_line
($difftree->[$patch_idx]);
3828 # compact combined diff output can have some patches skipped
3829 # find which patch (using pathname of result) we are at now;
3831 while ($to_name ne $diffinfo->{'to_file'}) {
3832 print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n" .
3833 format_diff_cc_simplified
($diffinfo, @hash_parents) .
3834 "</div>\n"; # class="patch"
3839 last if $patch_idx > $#$difftree;
3840 $diffinfo = parsed_difftree_line
($difftree->[$patch_idx]);
3844 # modifies %from, %to hashes
3845 parse_from_to_diffinfo
($diffinfo, \
%from, \
%to, @hash_parents);
3847 # this is first patch for raw difftree line with $patch_idx index
3848 # we index @$difftree array from 0, but number patches from 1
3849 print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n";
3853 #assert($patch_line =~ m/^diff /) if DEBUG;
3854 #assert($patch_line !~ m!$/$!) if DEBUG; # is chomp-ed
3856 # print "git diff" header
3857 print format_git_diff_header_line
($patch_line, $diffinfo,
3860 # print extended diff header
3861 print "<div class=\"diff extended_header\">\n";
3863 while ($patch_line = <$fd>) {
3866 last EXTENDED_HEADER
if ($patch_line =~ m/^--- |^diff /);
3868 print format_extended_diff_header_line
($patch_line, $diffinfo,
3871 print "</div>\n"; # class="diff extended_header"
3873 # from-file/to-file diff header
3874 if (! $patch_line) {
3875 print "</div>\n"; # class="patch"
3878 next PATCH
if ($patch_line =~ m/^diff /);
3879 #assert($patch_line =~ m/^---/) if DEBUG;
3881 my $last_patch_line = $patch_line;
3882 $patch_line = <$fd>;
3884 #assert($patch_line =~ m/^\+\+\+/) if DEBUG;
3886 print format_diff_from_to_header
($last_patch_line, $patch_line,
3887 $diffinfo, \
%from, \
%to,
3892 while ($patch_line = <$fd>) {
3895 next PATCH
if ($patch_line =~ m/^diff /);
3897 print format_diff_line
($patch_line, \
%from, \
%to);
3901 print "</div>\n"; # class="patch"
3904 # for compact combined (--cc) format, with chunk and patch simpliciaction
3905 # patchset might be empty, but there might be unprocessed raw lines
3906 for (++$patch_idx if $patch_number > 0;
3907 $patch_idx < @
$difftree;
3909 # read and prepare patch information
3910 $diffinfo = parsed_difftree_line
($difftree->[$patch_idx]);
3912 # generate anchor for "patch" links in difftree / whatchanged part
3913 print "<div class=\"patch\" id=\"patch". ($patch_idx+1) ."\">\n" .
3914 format_diff_cc_simplified
($diffinfo, @hash_parents) .
3915 "</div>\n"; # class="patch"
3920 if ($patch_number == 0) {
3921 if (@hash_parents > 1) {
3922 print "<div class=\"diff nodifferences\">Trivial merge</div>\n";
3924 print "<div class=\"diff nodifferences\">No differences found</div>\n";
3928 print "</div>\n"; # class="patchset"
3931 # . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3933 # fills project list info (age, description, owner, forks) for each
3934 # project in the list, removing invalid projects from returned list
3935 # NOTE: modifies $projlist, but does not remove entries from it
3936 sub fill_project_list_info
{
3937 my ($projlist, $check_forks) = @_;
3940 my $show_ctags = gitweb_check_feature
('ctags');
3942 foreach my $pr (@
$projlist) {
3943 my (@activity) = git_get_last_activity
($pr->{'path'});
3944 unless (@activity) {
3947 ($pr->{'age'}, $pr->{'age_string'}) = @activity;
3948 if (!defined $pr->{'descr'}) {
3949 my $descr = git_get_project_description
($pr->{'path'}) || "";
3950 $descr = to_utf8
($descr);
3951 $pr->{'descr_long'} = $descr;
3952 $pr->{'descr'} = chop_str
($descr, $projects_list_description_width, 5);
3954 if (!defined $pr->{'owner'}) {
3955 $pr->{'owner'} = git_get_project_owner
("$pr->{'path'}") || "";
3958 my $pname = $pr->{'path'};
3959 if (($pname =~ s/\.git$//) &&
3960 ($pname !~ /\/$/) &&
3961 (-d
"$projectroot/$pname")) {
3962 $pr->{'forks'} = "-d $projectroot/$pname";
3967 $show_ctags and $pr->{'ctags'} = git_get_project_ctags
($pr->{'path'});
3968 push @projects, $pr;
3974 # print 'sort by' <th> element, generating 'sort by $name' replay link
3975 # if that order is not selected
3977 my ($name, $order, $header) = @_;
3978 $header ||= ucfirst($name);
3980 if ($order eq $name) {
3981 print "<th>$header</th>\n";
3984 $cgi->a({-href
=> href
(-replay
=>1, order
=>$name),
3985 -class => "header"}, $header) .
3990 sub git_project_list_body
{
3991 # actually uses global variable $project
3992 my ($projlist, $order, $from, $to, $extra, $no_header) = @_;
3994 my $check_forks = gitweb_check_feature
('forks');
3995 my @projects = fill_project_list_info
($projlist, $check_forks);
3997 $order ||= $default_projects_order;
3998 $from = 0 unless defined $from;
3999 $to = $#projects if (!defined $to || $#projects < $to);
4002 project
=> { key
=> 'path', type
=> 'str' },
4003 descr
=> { key
=> 'descr_long', type
=> 'str' },
4004 owner
=> { key
=> 'owner', type
=> 'str' },
4005 age
=> { key
=> 'age', type
=> 'num' }
4007 my $oi = $order_info{$order};
4008 if ($oi->{'type'} eq 'str') {
4009 @projects = sort {$a->{$oi->{'key'}} cmp $b->{$oi->{'key'}}} @projects;
4011 @projects = sort {$a->{$oi->{'key'}} <=> $b->{$oi->{'key'}}} @projects;
4014 my $show_ctags = gitweb_check_feature
('ctags');
4017 foreach my $p (@projects) {
4018 foreach my $ct (keys %{$p->{'ctags'}}) {
4019 $ctags{$ct} += $p->{'ctags'}->{$ct};
4022 my $cloud = git_populate_project_tagcloud
(\
%ctags);
4023 print git_show_project_tagcloud
($cloud, 64);
4026 print "<table class=\"project_list\">\n";
4027 unless ($no_header) {
4030 print "<th></th>\n";
4032 print_sort_th
('project', $order, 'Project');
4033 print_sort_th
('descr', $order, 'Description');
4034 print_sort_th
('owner', $order, 'Owner');
4035 print_sort_th
('age', $order, 'Last Change');
4036 print "<th></th>\n" . # for links
4040 my $tagfilter = $cgi->param('by_tag');
4041 for (my $i = $from; $i <= $to; $i++) {
4042 my $pr = $projects[$i];
4044 next if $tagfilter and $show_ctags and not grep { lc $_ eq lc $tagfilter } keys %{$pr->{'ctags'}};
4045 next if $searchtext and not $pr->{'path'} =~ /$searchtext/
4046 and not $pr->{'descr_long'} =~ /$searchtext/;
4047 # Weed out forks or non-matching entries of search
4049 my $forkbase = $project; $forkbase ||= ''; $forkbase =~ s
#\.git$#/#;
4050 $forkbase="^$forkbase" if $forkbase;
4051 next if not $searchtext and not $tagfilter and $show_ctags
4052 and $pr->{'path'} =~ m
#$forkbase.*/.*#; # regexp-safe
4056 print "<tr class=\"dark\">\n";
4058 print "<tr class=\"light\">\n";
4063 if ($pr->{'forks'}) {
4064 print "<!-- $pr->{'forks'} -->\n";
4065 print $cgi->a({-href
=> href
(project
=>$pr->{'path'}, action
=>"forks")}, "+");
4069 print "<td>" . $cgi->a({-href
=> href
(project
=>$pr->{'path'}, action
=>"summary"),
4070 -class => "list"}, esc_html
($pr->{'path'})) . "</td>\n" .
4071 "<td>" . $cgi->a({-href
=> href
(project
=>$pr->{'path'}, action
=>"summary"),
4072 -class => "list", -title
=> $pr->{'descr_long'}},
4073 esc_html
($pr->{'descr'})) . "</td>\n" .
4074 "<td><i>" . chop_and_escape_str
($pr->{'owner'}, 15) . "</i></td>\n";
4075 print "<td class=\"". age_class
($pr->{'age'}) . "\">" .
4076 (defined $pr->{'age_string'} ?
$pr->{'age_string'} : "No commits") . "</td>\n" .
4077 "<td class=\"link\">" .
4078 $cgi->a({-href
=> href
(project
=>$pr->{'path'}, action
=>"summary")}, "summary") . " | " .
4079 $cgi->a({-href
=> href
(project
=>$pr->{'path'}, action
=>"shortlog")}, "shortlog") . " | " .
4080 $cgi->a({-href
=> href
(project
=>$pr->{'path'}, action
=>"log")}, "log") . " | " .
4081 $cgi->a({-href
=> href
(project
=>$pr->{'path'}, action
=>"tree")}, "tree") .
4082 ($pr->{'forks'} ?
" | " . $cgi->a({-href
=> href
(project
=>$pr->{'path'}, action
=>"forks")}, "forks") : '') .
4086 if (defined $extra) {
4089 print "<td></td>\n";
4091 print "<td colspan=\"5\">$extra</td>\n" .
4097 sub git_shortlog_body
{
4098 # uses global variable $project
4099 my ($commitlist, $from, $to, $refs, $extra) = @_;
4101 $from = 0 unless defined $from;
4102 $to = $#{$commitlist} if (!defined $to || $#{$commitlist} < $to);
4104 print "<table class=\"shortlog\">\n";
4106 for (my $i = $from; $i <= $to; $i++) {
4107 my %co = %{$commitlist->[$i]};
4108 my $commit = $co{'id'};
4109 my $ref = format_ref_marker
($refs, $commit);
4111 print "<tr class=\"dark\">\n";
4113 print "<tr class=\"light\">\n";
4116 my $author = chop_and_escape_str
($co{'author_name'}, 10);
4117 # git_summary() used print "<td><i>$co{'age_string'}</i></td>\n" .
4118 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
4119 "<td><i>" . $author . "</i></td>\n" .
4121 print format_subject_html
($co{'title'}, $co{'title_short'},
4122 href
(action
=>"commit", hash
=>$commit), $ref);
4124 "<td class=\"link\">" .
4125 $cgi->a({-href
=> href
(action
=>"commit", hash
=>$commit)}, "commit") . " | " .
4126 $cgi->a({-href
=> href
(action
=>"commitdiff", hash
=>$commit)}, "commitdiff") . " | " .
4127 $cgi->a({-href
=> href
(action
=>"tree", hash
=>$commit, hash_base
=>$commit)}, "tree");
4128 my $snapshot_links = format_snapshot_links
($commit);
4129 if (defined $snapshot_links) {
4130 print " | " . $snapshot_links;
4135 if (defined $extra) {
4137 "<td colspan=\"4\">$extra</td>\n" .
4143 sub git_history_body
{
4144 # Warning: assumes constant type (blob or tree) during history
4145 my ($commitlist, $from, $to, $refs, $hash_base, $ftype, $extra) = @_;
4147 $from = 0 unless defined $from;
4148 $to = $#{$commitlist} unless (defined $to && $to <= $#{$commitlist});
4150 print "<table class=\"history\">\n";
4152 for (my $i = $from; $i <= $to; $i++) {
4153 my %co = %{$commitlist->[$i]};
4157 my $commit = $co{'id'};
4159 my $ref = format_ref_marker
($refs, $commit);
4162 print "<tr class=\"dark\">\n";
4164 print "<tr class=\"light\">\n";
4167 # shortlog uses chop_str($co{'author_name'}, 10)
4168 my $author = chop_and_escape_str
($co{'author_name'}, 15, 3);
4169 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
4170 "<td><i>" . $author . "</i></td>\n" .
4172 # originally git_history used chop_str($co{'title'}, 50)
4173 print format_subject_html
($co{'title'}, $co{'title_short'},
4174 href
(action
=>"commit", hash
=>$commit), $ref);
4176 "<td class=\"link\">" .
4177 $cgi->a({-href
=> href
(action
=>$ftype, hash_base
=>$commit, file_name
=>$file_name)}, $ftype) . " | " .
4178 $cgi->a({-href
=> href
(action
=>"commitdiff", hash
=>$commit)}, "commitdiff");
4180 if ($ftype eq 'blob') {
4181 my $blob_current = git_get_hash_by_path
($hash_base, $file_name);
4182 my $blob_parent = git_get_hash_by_path
($commit, $file_name);
4183 if (defined $blob_current && defined $blob_parent &&
4184 $blob_current ne $blob_parent) {
4186 $cgi->a({-href
=> href
(action
=>"blobdiff",
4187 hash
=>$blob_current, hash_parent
=>$blob_parent,
4188 hash_base
=>$hash_base, hash_parent_base
=>$commit,
4189 file_name
=>$file_name)},
4196 if (defined $extra) {
4198 "<td colspan=\"4\">$extra</td>\n" .
4205 # uses global variable $project
4206 my ($taglist, $from, $to, $extra) = @_;
4207 $from = 0 unless defined $from;
4208 $to = $#{$taglist} if (!defined $to || $#{$taglist} < $to);
4210 print "<table class=\"tags\">\n";
4212 for (my $i = $from; $i <= $to; $i++) {
4213 my $entry = $taglist->[$i];
4215 my $comment = $tag{'subject'};
4217 if (defined $comment) {
4218 $comment_short = chop_str
($comment, 30, 5);
4221 print "<tr class=\"dark\">\n";
4223 print "<tr class=\"light\">\n";
4226 if (defined $tag{'age'}) {
4227 print "<td><i>$tag{'age'}</i></td>\n";
4229 print "<td></td>\n";
4232 $cgi->a({-href
=> href
(action
=>$tag{'reftype'}, hash
=>$tag{'refid'}),
4233 -class => "list name"}, esc_html
($tag{'name'})) .
4236 if (defined $comment) {
4237 print format_subject_html
($comment, $comment_short,
4238 href
(action
=>"tag", hash
=>$tag{'id'}));
4241 "<td class=\"selflink\">";
4242 if ($tag{'type'} eq "tag") {
4243 print $cgi->a({-href
=> href
(action
=>"tag", hash
=>$tag{'id'})}, "tag");
4248 "<td class=\"link\">" . " | " .
4249 $cgi->a({-href
=> href
(action
=>$tag{'reftype'}, hash
=>$tag{'refid'})}, $tag{'reftype'});
4250 if ($tag{'reftype'} eq "commit") {
4251 print " | " . $cgi->a({-href
=> href
(action
=>"shortlog", hash
=>$tag{'fullname'})}, "shortlog") .
4252 " | " . $cgi->a({-href
=> href
(action
=>"log", hash
=>$tag{'fullname'})}, "log");
4253 } elsif ($tag{'reftype'} eq "blob") {
4254 print " | " . $cgi->a({-href
=> href
(action
=>"blob_plain", hash
=>$tag{'refid'})}, "raw");
4259 if (defined $extra) {
4261 "<td colspan=\"5\">$extra</td>\n" .
4267 sub git_heads_body
{
4268 # uses global variable $project
4269 my ($headlist, $head, $from, $to, $extra) = @_;
4270 $from = 0 unless defined $from;
4271 $to = $#{$headlist} if (!defined $to || $#{$headlist} < $to);
4273 print "<table class=\"heads\">\n";
4275 for (my $i = $from; $i <= $to; $i++) {
4276 my $entry = $headlist->[$i];
4278 my $curr = $ref{'id'} eq $head;
4280 print "<tr class=\"dark\">\n";
4282 print "<tr class=\"light\">\n";
4285 print "<td><i>$ref{'age'}</i></td>\n" .
4286 ($curr ?
"<td class=\"current_head\">" : "<td>") .
4287 $cgi->a({-href
=> href
(action
=>"shortlog", hash
=>$ref{'fullname'}),
4288 -class => "list name"},esc_html
($ref{'name'})) .
4290 "<td class=\"link\">" .
4291 $cgi->a({-href
=> href
(action
=>"shortlog", hash
=>$ref{'fullname'})}, "shortlog") . " | " .
4292 $cgi->a({-href
=> href
(action
=>"log", hash
=>$ref{'fullname'})}, "log") . " | " .
4293 $cgi->a({-href
=> href
(action
=>"tree", hash
=>$ref{'fullname'}, hash_base
=>$ref{'name'})}, "tree") .
4297 if (defined $extra) {
4299 "<td colspan=\"3\">$extra</td>\n" .
4305 sub git_search_grep_body
{
4306 my ($commitlist, $from, $to, $extra) = @_;
4307 $from = 0 unless defined $from;
4308 $to = $#{$commitlist} if (!defined $to || $#{$commitlist} < $to);
4310 print "<table class=\"commit_search\">\n";
4312 for (my $i = $from; $i <= $to; $i++) {
4313 my %co = %{$commitlist->[$i]};
4317 my $commit = $co{'id'};
4319 print "<tr class=\"dark\">\n";
4321 print "<tr class=\"light\">\n";
4324 my $author = chop_and_escape_str
($co{'author_name'}, 15, 5);
4325 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
4326 "<td><i>" . $author . "</i></td>\n" .
4328 $cgi->a({-href
=> href
(action
=>"commit", hash
=>$co{'id'}),
4329 -class => "list subject"},
4330 chop_and_escape_str
($co{'title'}, 50) . "<br/>");
4331 my $comment = $co{'comment'};
4332 foreach my $line (@
$comment) {
4333 if ($line =~ m/^(.*?)($search_regexp)(.*)$/i) {
4334 my ($lead, $match, $trail) = ($1, $2, $3);
4335 $match = chop_str
($match, 70, 5, 'center');
4336 my $contextlen = int((80 - length($match))/2);
4337 $contextlen = 30 if ($contextlen > 30);
4338 $lead = chop_str
($lead, $contextlen, 10, 'left');
4339 $trail = chop_str
($trail, $contextlen, 10, 'right');
4341 $lead = esc_html
($lead);
4342 $match = esc_html
($match);
4343 $trail = esc_html
($trail);
4345 print "$lead<span class=\"match\">$match</span>$trail<br />";
4349 "<td class=\"link\">" .
4350 $cgi->a({-href
=> href
(action
=>"commit", hash
=>$co{'id'})}, "commit") .
4352 $cgi->a({-href
=> href
(action
=>"commitdiff", hash
=>$co{'id'})}, "commitdiff") .
4354 $cgi->a({-href
=> href
(action
=>"tree", hash
=>$co{'tree'}, hash_base
=>$co{'id'})}, "tree");
4358 if (defined $extra) {
4360 "<td colspan=\"3\">$extra</td>\n" .
4366 ## ======================================================================
4367 ## ======================================================================
4370 sub git_project_list
{
4371 my $order = $input_params{'order'};
4372 if (defined $order && $order !~ m/none|project|descr|owner|age/) {
4373 die_error
(400, "Unknown order parameter");
4376 my @list = git_get_projects_list
();
4378 die_error
(404, "No projects found");
4382 if (-f
$home_text) {
4383 print "<div class=\"index_include\">\n";
4384 insert_file
($home_text);
4387 print $cgi->startform(-method
=> "get") .
4388 "<p class=\"projsearch\">Search:\n" .
4389 $cgi->textfield(-name
=> "s", -value
=> $searchtext) . "\n" .
4391 $cgi->end_form() . "\n";
4392 git_project_list_body
(\
@list, $order);
4397 my $order = $input_params{'order'};
4398 if (defined $order && $order !~ m/none|project|descr|owner|age/) {
4399 die_error
(400, "Unknown order parameter");
4402 my @list = git_get_projects_list
($project);
4404 die_error
(404, "No forks found");
4408 git_print_page_nav
('','');
4409 git_print_header_div
('summary', "$project forks");
4410 git_project_list_body
(\
@list, $order);
4414 sub git_project_index
{
4415 my @projects = git_get_projects_list
($project);
4418 -type
=> 'text/plain',
4419 -charset
=> 'utf-8',
4420 -content_disposition
=> 'inline; filename="index.aux"');
4422 foreach my $pr (@projects) {
4423 if (!exists $pr->{'owner'}) {
4424 $pr->{'owner'} = git_get_project_owner
("$pr->{'path'}");
4427 my ($path, $owner) = ($pr->{'path'}, $pr->{'owner'});
4428 # quote as in CGI::Util::encode, but keep the slash, and use '+' for ' '
4429 $path =~ s/([^a-zA-Z0-9_.\-\/ ])/sprintf
("%%%02X", ord($1))/eg
;
4430 $owner =~ s/([^a-zA-Z0-9_.\-\/ ])/sprintf
("%%%02X", ord($1))/eg
;
4434 print "$path $owner\n";
4439 my $descr = git_get_project_description
($project) || "none";
4440 my %co = parse_commit
("HEAD");
4441 my %cd = %co ? parse_date
($co{'committer_epoch'}, $co{'committer_tz'}) : ();
4442 my $head = $co{'id'};
4444 my $owner = git_get_project_owner
($project);
4446 my $refs = git_get_references
();
4447 # These get_*_list functions return one more to allow us to see if
4448 # there are more ...
4449 my @taglist = git_get_tags_list
(16);
4450 my @headlist = git_get_heads_list
(16);
4452 my $check_forks = gitweb_check_feature
('forks');
4455 @forklist = git_get_projects_list
($project);
4459 git_print_page_nav
('summary','', $head);
4461 print "<div class=\"title\"> </div>\n";
4462 print "<table class=\"projects_list\">\n" .
4463 "<tr id=\"metadata_desc\"><td>description</td><td>" . esc_html
($descr) . "</td></tr>\n" .
4464 "<tr id=\"metadata_owner\"><td>owner</td><td>" . esc_html
($owner) . "</td></tr>\n";
4465 if (defined $cd{'rfc2822'}) {
4466 print "<tr id=\"metadata_lchange\"><td>last change</td><td>$cd{'rfc2822'}</td></tr>\n";
4469 # use per project git URL list in $projectroot/$project/cloneurl
4470 # or make project git URL from git base URL and project name
4471 my $url_tag = "URL";
4472 my @url_list = git_get_project_url_list
($project);
4473 @url_list = map { "$_/$project" } @git_base_url_list unless @url_list;
4474 foreach my $git_url (@url_list) {
4475 next unless $git_url;
4476 print "<tr class=\"metadata_url\"><td>$url_tag</td><td>$git_url</td></tr>\n";
4481 my $show_ctags = gitweb_check_feature
('ctags');
4483 my $ctags = git_get_project_ctags
($project);
4484 my $cloud = git_populate_project_tagcloud
($ctags);
4485 print "<tr id=\"metadata_ctags\"><td>Content tags:<br />";
4486 print "</td>\n<td>" unless %$ctags;
4487 print "<form action=\"$show_ctags\" method=\"post\"><input type=\"hidden\" name=\"p\" value=\"$project\" />Add: <input type=\"text\" name=\"t\" size=\"8\" /></form>";
4488 print "</td>\n<td>" if %$ctags;
4489 print git_show_project_tagcloud
($cloud, 48);
4495 if (-s
"$projectroot/$project/README.html") {
4496 print "<div class=\"title\">readme</div>\n" .
4497 "<div class=\"readme\">\n";
4498 insert_file
("$projectroot/$project/README.html");
4499 print "\n</div>\n"; # class="readme"
4502 # we need to request one more than 16 (0..15) to check if
4504 my @commitlist = $head ? parse_commits
($head, 17) : ();
4506 git_print_header_div
('shortlog');
4507 git_shortlog_body
(\
@commitlist, 0, 15, $refs,
4508 $#commitlist <= 15 ?
undef :
4509 $cgi->a({-href
=> href
(action
=>"shortlog")}, "..."));
4513 git_print_header_div
('tags');
4514 git_tags_body
(\
@taglist, 0, 15,
4515 $#taglist <= 15 ?
undef :
4516 $cgi->a({-href
=> href
(action
=>"tags")}, "..."));
4520 git_print_header_div
('heads');
4521 git_heads_body
(\
@headlist, $head, 0, 15,
4522 $#headlist <= 15 ?
undef :
4523 $cgi->a({-href
=> href
(action
=>"heads")}, "..."));
4527 git_print_header_div
('forks');
4528 git_project_list_body
(\
@forklist, 'age', 0, 15,
4529 $#forklist <= 15 ?
undef :
4530 $cgi->a({-href
=> href
(action
=>"forks")}, "..."),
4538 my $head = git_get_head_hash
($project);
4540 git_print_page_nav
('','', $head,undef,$head);
4541 my %tag = parse_tag
($hash);
4544 die_error
(404, "Unknown tag object");
4547 git_print_header_div
('commit', esc_html
($tag{'name'}), $hash);
4548 print "<div class=\"title_text\">\n" .
4549 "<table class=\"object_header\">\n" .
4551 "<td>object</td>\n" .
4552 "<td>" . $cgi->a({-class => "list", -href
=> href
(action
=>$tag{'type'}, hash
=>$tag{'object'})},
4553 $tag{'object'}) . "</td>\n" .
4554 "<td class=\"link\">" . $cgi->a({-href
=> href
(action
=>$tag{'type'}, hash
=>$tag{'object'})},
4555 $tag{'type'}) . "</td>\n" .
4557 if (defined($tag{'author'})) {
4558 my %ad = parse_date
($tag{'epoch'}, $tag{'tz'});
4559 print "<tr><td>author</td><td>" . esc_html
($tag{'author'}) . "</td></tr>\n";
4560 print "<tr><td></td><td>" . $ad{'rfc2822'} .
4561 sprintf(" (%02d:%02d %s)", $ad{'hour_local'}, $ad{'minute_local'}, $ad{'tz_local'}) .
4564 print "</table>\n\n" .
4566 print "<div class=\"page_body\">";
4567 my $comment = $tag{'comment'};
4568 foreach my $line (@
$comment) {
4570 print esc_html
($line, -nbsp
=>1) . "<br/>\n";
4580 gitweb_check_feature
('blame')
4581 or die_error
(403, "Blame view not allowed");
4583 die_error
(400, "No file name given") unless $file_name;
4584 $hash_base ||= git_get_head_hash
($project);
4585 die_error
(404, "Couldn't find base commit") unless ($hash_base);
4586 my %co = parse_commit
($hash_base)
4587 or die_error
(404, "Commit not found");
4588 if (!defined $hash) {
4589 $hash = git_get_hash_by_path
($hash_base, $file_name, "blob")
4590 or die_error
(404, "Error looking up file");
4592 $ftype = git_get_type
($hash);
4593 if ($ftype !~ "blob") {
4594 die_error
(400, "Object is not a blob");
4596 open ($fd, "-|", git_cmd
(), "blame", '-p', '--',
4597 $file_name, $hash_base)
4598 or die_error
(500, "Open git-blame failed");
4601 $cgi->a({-href
=> href
(action
=>"blob", -replay
=>1)},
4604 $cgi->a({-href
=> href
(action
=>"history", -replay
=>1)},
4607 $cgi->a({-href
=> href
(action
=>"blame", file_name
=>$file_name)},
4609 git_print_page_nav
('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
4610 git_print_header_div
('commit', esc_html
($co{'title'}), $hash_base);
4611 git_print_page_path
($file_name, $ftype, $hash_base);
4612 my @rev_color = (qw(light2 dark2));
4613 my $num_colors = scalar(@rev_color);
4614 my $current_color = 0;
4617 <div class="page_body">
4618 <table class="blame">
4619 <tr><th>Commit</th><th>Line</th><th>Data</th></tr>
4624 last unless defined $_;
4625 my ($full_rev, $orig_lineno, $lineno, $group_size) =
4626 /^([0-9a-f]{40}) (\d+) (\d+)(?: (\d+))?$/;
4627 if (!exists $metainfo{$full_rev}) {
4628 $metainfo{$full_rev} = {};
4630 my $meta = $metainfo{$full_rev};
4633 if (/^(\S+) (.*)$/) {
4639 my $rev = substr($full_rev, 0, 8);
4640 my $author = $meta->{'author'};
4641 my %date = parse_date
($meta->{'author-time'},
4642 $meta->{'author-tz'});
4643 my $date = $date{'iso-tz'};
4645 $current_color = ++$current_color % $num_colors;
4647 print "<tr class=\"$rev_color[$current_color]\">\n";
4649 print "<td class=\"sha1\"";
4650 print " title=\"". esc_html
($author) . ", $date\"";
4651 print " rowspan=\"$group_size\"" if ($group_size > 1);
4653 print $cgi->a({-href
=> href
(action
=>"commit",
4655 file_name
=>$file_name)},
4659 open (my $dd, "-|", git_cmd
(), "rev-parse", "$full_rev^")
4660 or die_error
(500, "Open git-rev-parse failed");
4661 my $parent_commit = <$dd>;
4663 chomp($parent_commit);
4664 my $blamed = href
(action
=> 'blame',
4665 file_name
=> $meta->{'filename'},
4666 hash_base
=> $parent_commit);
4667 print "<td class=\"linenr\">";
4668 print $cgi->a({ -href
=> "$blamed#l$orig_lineno",
4670 -class => "linenr" },
4673 print "<td class=\"pre\">" . esc_html
($data) . "</td>\n";
4679 or print "Reading blob failed\n";
4684 my $head = git_get_head_hash
($project);
4686 git_print_page_nav
('','', $head,undef,$head);
4687 git_print_header_div
('summary', $project);
4689 my @tagslist = git_get_tags_list
();
4691 git_tags_body
(\
@tagslist);
4697 my $head = git_get_head_hash
($project);
4699 git_print_page_nav
('','', $head,undef,$head);
4700 git_print_header_div
('summary', $project);
4702 my @headslist = git_get_heads_list
();
4704 git_heads_body
(\
@headslist, $head);
4709 sub git_blob_plain
{
4713 if (!defined $hash) {
4714 if (defined $file_name) {
4715 my $base = $hash_base || git_get_head_hash
($project);
4716 $hash = git_get_hash_by_path
($base, $file_name, "blob")
4717 or die_error
(404, "Cannot find file");
4719 die_error
(400, "No file name defined");
4721 } elsif ($hash =~ m/^[0-9a-fA-F]{40}$/) {
4722 # blobs defined by non-textual hash id's can be cached
4726 open my $fd, "-|", git_cmd
(), "cat-file", "blob", $hash
4727 or die_error
(500, "Open git-cat-file blob '$hash' failed");
4729 # content-type (can include charset)
4730 $type = blob_contenttype
($fd, $file_name, $type);
4732 # "save as" filename, even when no $file_name is given
4733 my $save_as = "$hash";
4734 if (defined $file_name) {
4735 $save_as = $file_name;
4736 } elsif ($type =~ m/^text\//) {
4742 -expires
=> $expires,
4743 -content_disposition
=> 'inline; filename="' . $save_as . '"');
4745 binmode STDOUT
, ':raw';
4747 binmode STDOUT
, ':utf8'; # as set at the beginning of gitweb.cgi
4755 if (!defined $hash) {
4756 if (defined $file_name) {
4757 my $base = $hash_base || git_get_head_hash
($project);
4758 $hash = git_get_hash_by_path
($base, $file_name, "blob")
4759 or die_error
(404, "Cannot find file");
4761 die_error
(400, "No file name defined");
4763 } elsif ($hash =~ m/^[0-9a-fA-F]{40}$/) {
4764 # blobs defined by non-textual hash id's can be cached
4768 my $have_blame = gitweb_check_feature
('blame');
4769 open my $fd, "-|", git_cmd
(), "cat-file", "blob", $hash
4770 or die_error
(500, "Couldn't cat $file_name, $hash");
4771 my $mimetype = blob_mimetype
($fd, $file_name);
4772 if ($mimetype !~ m!^(?:text/|image/(?:gif|png|jpeg)$)! && -B
$fd) {
4774 return git_blob_plain
($mimetype);
4776 # we can have blame only for text/* mimetype
4777 $have_blame &&= ($mimetype =~ m!^text/!);
4779 git_header_html
(undef, $expires);
4780 my $formats_nav = '';
4781 if (defined $hash_base && (my %co = parse_commit
($hash_base))) {
4782 if (defined $file_name) {
4785 $cgi->a({-href
=> href
(action
=>"blame", -replay
=>1)},
4790 $cgi->a({-href
=> href
(action
=>"history", -replay
=>1)},
4793 $cgi->a({-href
=> href
(action
=>"blob_plain", -replay
=>1)},
4796 $cgi->a({-href
=> href
(action
=>"blob",
4797 hash_base
=>"HEAD", file_name
=>$file_name)},
4801 $cgi->a({-href
=> href
(action
=>"blob_plain", -replay
=>1)},
4804 git_print_page_nav
('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
4805 git_print_header_div
('commit', esc_html
($co{'title'}), $hash_base);
4807 print "<div class=\"page_nav\">\n" .
4808 "<br/><br/></div>\n" .
4809 "<div class=\"title\">$hash</div>\n";
4811 git_print_page_path
($file_name, "blob", $hash_base);
4812 print "<div class=\"page_body\">\n";
4813 if ($mimetype =~ m!^image/!) {
4814 print qq!<img type
="$mimetype"!;
4816 print qq! alt
="$file_name" title
="$file_name"!;
4819 href(action=>"blob_plain
", hash=>$hash,
4820 hash_base=>$hash_base, file_name=>$file_name) .
4824 while (my $line = <$fd>) {
4827 $line = untabify
($line);
4828 printf "<div class=\"pre\"><a id=\"l%i\" href=\"#l%i\" class=\"linenr\">%4i</a> %s</div>\n",
4829 $nr, $nr, $nr, esc_html
($line, -nbsp
=>1);
4833 or print "Reading blob failed.\n";
4839 if (!defined $hash_base) {
4840 $hash_base = "HEAD";
4842 if (!defined $hash) {
4843 if (defined $file_name) {
4844 $hash = git_get_hash_by_path
($hash_base, $file_name, "tree");
4849 die_error
(404, "No such tree") unless defined($hash);
4851 open my $fd, "-|", git_cmd
(), "ls-tree", '-z', $hash
4852 or die_error
(500, "Open git-ls-tree failed");
4853 my @entries = map { chomp; $_ } <$fd>;
4854 close $fd or die_error
(404, "Reading tree failed");
4857 my $refs = git_get_references
();
4858 my $ref = format_ref_marker
($refs, $hash_base);
4861 my $have_blame = gitweb_check_feature
('blame');
4862 if (defined $hash_base && (my %co = parse_commit
($hash_base))) {
4864 if (defined $file_name) {
4866 $cgi->a({-href
=> href
(action
=>"history", -replay
=>1)},
4868 $cgi->a({-href
=> href
(action
=>"tree",
4869 hash_base
=>"HEAD", file_name
=>$file_name)},
4872 my $snapshot_links = format_snapshot_links
($hash);
4873 if (defined $snapshot_links) {
4874 # FIXME: Should be available when we have no hash base as well.
4875 push @views_nav, $snapshot_links;
4877 git_print_page_nav
('tree','', $hash_base, undef, undef, join(' | ', @views_nav));
4878 git_print_header_div
('commit', esc_html
($co{'title'}) . $ref, $hash_base);
4881 print "<div class=\"page_nav\">\n";
4882 print "<br/><br/></div>\n";
4883 print "<div class=\"title\">$hash</div>\n";
4885 if (defined $file_name) {
4886 $basedir = $file_name;
4887 if ($basedir ne '' && substr($basedir, -1) ne '/') {
4890 git_print_page_path
($file_name, 'tree', $hash_base);
4892 print "<div class=\"page_body\">\n";
4893 print "<table class=\"tree\">\n";
4895 # '..' (top directory) link if possible
4896 if (defined $hash_base &&
4897 defined $file_name && $file_name =~ m![^/]+$!) {
4899 print "<tr class=\"dark\">\n";
4901 print "<tr class=\"light\">\n";
4905 my $up = $file_name;
4906 $up =~ s!/?[^/]+$!!;
4907 undef $up unless $up;
4908 # based on git_print_tree_entry
4909 print '<td class="mode">' . mode_str
('040000') . "</td>\n";
4910 print '<td class="list">';
4911 print $cgi->a({-href
=> href
(action
=>"tree", hash_base
=>$hash_base,
4915 print "<td class=\"link\"></td>\n";
4919 foreach my $line (@entries) {
4920 my %t = parse_ls_tree_line
($line, -z
=> 1);
4923 print "<tr class=\"dark\">\n";
4925 print "<tr class=\"light\">\n";
4929 git_print_tree_entry
(\
%t, $basedir, $hash_base, $have_blame);
4933 print "</table>\n" .
4939 my $format = $input_params{'snapshot_format'};
4940 if (!@snapshot_fmts) {
4941 die_error
(403, "Snapshots not allowed");
4943 # default to first supported snapshot format
4944 $format ||= $snapshot_fmts[0];
4945 if ($format !~ m/^[a-z0-9]+$/) {
4946 die_error
(400, "Invalid snapshot format parameter");
4947 } elsif (!exists($known_snapshot_formats{$format})) {
4948 die_error
(400, "Unknown snapshot format");
4949 } elsif (!grep($_ eq $format, @snapshot_fmts)) {
4950 die_error
(403, "Unsupported snapshot format");
4953 if (!defined $hash) {
4954 $hash = git_get_head_hash
($project);
4957 my $name = $project;
4958 $name =~ s
,([^/])/*\
.git
$,$1,;
4959 $name = basename
($name);
4960 my $filename = to_utf8
($name);
4961 $name =~ s/\047/\047\\\047\047/g;
4963 $filename .= "-$hash$known_snapshot_formats{$format}{'suffix'}";
4964 $cmd = quote_command
(
4965 git_cmd
(), 'archive',
4966 "--format=$known_snapshot_formats{$format}{'format'}",
4967 "--prefix=$name/", $hash);
4968 if (exists $known_snapshot_formats{$format}{'compressor'}) {
4969 $cmd .= ' | ' . quote_command
(@
{$known_snapshot_formats{$format}{'compressor'}});
4973 -type
=> $known_snapshot_formats{$format}{'type'},
4974 -content_disposition
=> 'inline; filename="' . "$filename" . '"',
4975 -status
=> '200 OK');
4977 open my $fd, "-|", $cmd
4978 or die_error
(500, "Execute git-archive failed");
4979 binmode STDOUT
, ':raw';
4981 binmode STDOUT
, ':utf8'; # as set at the beginning of gitweb.cgi
4986 my $head = git_get_head_hash
($project);
4987 if (!defined $hash) {
4990 if (!defined $page) {
4993 my $refs = git_get_references
();
4995 my @commitlist = parse_commits
($hash, 101, (100 * $page));
4997 my $paging_nav = format_paging_nav
('log', $hash, $head, $page, $#commitlist >= 100);
5000 git_print_page_nav
('log','', $hash,undef,undef, $paging_nav);
5003 my %co = parse_commit
($hash);
5005 git_print_header_div
('summary', $project);
5006 print "<div class=\"page_body\"> Last change $co{'age_string'}.<br/><br/></div>\n";
5008 my $to = ($#commitlist >= 99) ?
(99) : ($#commitlist);
5009 for (my $i = 0; $i <= $to; $i++) {
5010 my %co = %{$commitlist[$i]};
5012 my $commit = $co{'id'};
5013 my $ref = format_ref_marker
($refs, $commit);
5014 my %ad = parse_date
($co{'author_epoch'});
5015 git_print_header_div
('commit',
5016 "<span class=\"age\">$co{'age_string'}</span>" .
5017 esc_html
($co{'title'}) . $ref,
5019 print "<div class=\"title_text\">\n" .
5020 "<div class=\"log_link\">\n" .
5021 $cgi->a({-href
=> href
(action
=>"commit", hash
=>$commit)}, "commit") .
5023 $cgi->a({-href
=> href
(action
=>"commitdiff", hash
=>$commit)}, "commitdiff") .
5025 $cgi->a({-href
=> href
(action
=>"tree", hash
=>$commit, hash_base
=>$commit)}, "tree") .
5028 "<i>" . esc_html
($co{'author_name'}) . " [$ad{'rfc2822'}]</i><br/>\n" .
5031 print "<div class=\"log_body\">\n";
5032 git_print_log
($co{'comment'}, -final_empty_line
=> 1);
5035 if ($#commitlist >= 100) {
5036 print "<div class=\"page_nav\">\n";
5037 print $cgi->a({-href
=> href
(-replay
=>1, page
=>$page+1),
5038 -accesskey
=> "n", -title
=> "Alt-n"}, "next");
5045 $hash ||= $hash_base || "HEAD";
5046 my %co = parse_commit
($hash)
5047 or die_error
(404, "Unknown commit object");
5048 my %ad = parse_date
($co{'author_epoch'}, $co{'author_tz'});
5049 my %cd = parse_date
($co{'committer_epoch'}, $co{'committer_tz'});
5051 my $parent = $co{'parent'};
5052 my $parents = $co{'parents'}; # listref
5054 # we need to prepare $formats_nav before any parameter munging
5056 if (!defined $parent) {
5058 $formats_nav .= '(initial)';
5059 } elsif (@
$parents == 1) {
5060 # single parent commit
5063 $cgi->a({-href
=> href
(action
=>"commit",
5065 esc_html
(substr($parent, 0, 7))) .
5072 $cgi->a({-href
=> href
(action
=>"commit",
5074 esc_html
(substr($_, 0, 7)));
5079 if (!defined $parent) {
5083 open my $fd, "-|", git_cmd
(), "diff-tree", '-r', "--no-commit-id",
5085 (@
$parents <= 1 ?
$parent : '-c'),
5087 or die_error
(500, "Open git-diff-tree failed");
5088 @difftree = map { chomp; $_ } <$fd>;
5089 close $fd or die_error
(404, "Reading git-diff-tree failed");
5091 # non-textual hash id's can be cached
5093 if ($hash =~ m/^[0-9a-fA-F]{40}$/) {
5096 my $refs = git_get_references
();
5097 my $ref = format_ref_marker
($refs, $co{'id'});
5099 git_header_html
(undef, $expires);
5100 git_print_page_nav
('commit', '',
5101 $hash, $co{'tree'}, $hash,
5104 if (defined $co{'parent'}) {
5105 git_print_header_div
('commitdiff', esc_html
($co{'title'}) . $ref, $hash);
5107 git_print_header_div
('tree', esc_html
($co{'title'}) . $ref, $co{'tree'}, $hash);
5109 print "<div class=\"title_text\">\n" .
5110 "<table class=\"object_header\">\n";
5111 print "<tr><td>author</td><td>" . esc_html
($co{'author'}) . "</td></tr>\n".
5113 "<td></td><td> $ad{'rfc2822'}";
5114 if ($ad{'hour_local'} < 6) {
5115 printf(" (<span class=\"atnight\">%02d:%02d</span> %s)",
5116 $ad{'hour_local'}, $ad{'minute_local'}, $ad{'tz_local'});
5118 printf(" (%02d:%02d %s)",
5119 $ad{'hour_local'}, $ad{'minute_local'}, $ad{'tz_local'});
5123 print "<tr><td>committer</td><td>" . esc_html
($co{'committer'}) . "</td></tr>\n";
5124 print "<tr><td></td><td> $cd{'rfc2822'}" .
5125 sprintf(" (%02d:%02d %s)", $cd{'hour_local'}, $cd{'minute_local'}, $cd{'tz_local'}) .
5127 print "<tr><td>commit</td><td class=\"sha1\">$co{'id'}</td></tr>\n";
5130 "<td class=\"sha1\">" .
5131 $cgi->a({-href
=> href
(action
=>"tree", hash
=>$co{'tree'}, hash_base
=>$hash),
5132 class => "list"}, $co{'tree'}) .
5134 "<td class=\"link\">" .
5135 $cgi->a({-href
=> href
(action
=>"tree", hash
=>$co{'tree'}, hash_base
=>$hash)},
5137 my $snapshot_links = format_snapshot_links
($hash);
5138 if (defined $snapshot_links) {
5139 print " | " . $snapshot_links;
5144 foreach my $par (@
$parents) {
5147 "<td class=\"sha1\">" .
5148 $cgi->a({-href
=> href
(action
=>"commit", hash
=>$par),
5149 class => "list"}, $par) .
5151 "<td class=\"link\">" .
5152 $cgi->a({-href
=> href
(action
=>"commit", hash
=>$par)}, "commit") .
5154 $cgi->a({-href
=> href
(action
=>"commitdiff", hash
=>$hash, hash_parent
=>$par)}, "diff") .
5161 print "<div class=\"page_body\">\n";
5162 git_print_log
($co{'comment'});
5165 git_difftree_body
(\
@difftree, $hash, @
$parents);
5171 # object is defined by:
5172 # - hash or hash_base alone
5173 # - hash_base and file_name
5176 # - hash or hash_base alone
5177 if ($hash || ($hash_base && !defined $file_name)) {
5178 my $object_id = $hash || $hash_base;
5180 open my $fd, "-|", quote_command
(
5181 git_cmd
(), 'cat-file', '-t', $object_id) . ' 2> /dev/null'
5182 or die_error
(404, "Object does not exist");
5186 or die_error
(404, "Object does not exist");
5188 # - hash_base and file_name
5189 } elsif ($hash_base && defined $file_name) {
5190 $file_name =~ s
,/+$,,;
5192 system(git_cmd
(), "cat-file", '-e', $hash_base) == 0
5193 or die_error
(404, "Base object does not exist");
5195 # here errors should not hapen
5196 open my $fd, "-|", git_cmd
(), "ls-tree", $hash_base, "--", $file_name
5197 or die_error
(500, "Open git-ls-tree failed");
5201 #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa panic.c'
5202 unless ($line && $line =~ m/^([0-9]+) (.+) ([0-9a-fA-F]{40})\t/) {
5203 die_error
(404, "File or directory for given base does not exist");
5208 die_error
(400, "Not enough information to find object");
5211 print $cgi->redirect(-uri
=> href
(action
=>$type, -full
=>1,
5212 hash
=>$hash, hash_base
=>$hash_base,
5213 file_name
=>$file_name),
5214 -status
=> '302 Found');
5218 my $format = shift || 'html';
5225 # preparing $fd and %diffinfo for git_patchset_body
5227 if (defined $hash_base && defined $hash_parent_base) {
5228 if (defined $file_name) {
5230 open $fd, "-|", git_cmd
(), "diff-tree", '-r', @diff_opts,
5231 $hash_parent_base, $hash_base,
5232 "--", (defined $file_parent ?
$file_parent : ()), $file_name
5233 or die_error
(500, "Open git-diff-tree failed");
5234 @difftree = map { chomp; $_ } <$fd>;
5236 or die_error
(404, "Reading git-diff-tree failed");
5238 or die_error
(404, "Blob diff not found");
5240 } elsif (defined $hash &&
5241 $hash =~ /[0-9a-fA-F]{40}/) {
5242 # try to find filename from $hash
5244 # read filtered raw output
5245 open $fd, "-|", git_cmd
(), "diff-tree", '-r', @diff_opts,
5246 $hash_parent_base, $hash_base, "--"
5247 or die_error
(500, "Open git-diff-tree failed");
5249 # ':100644 100644 03b21826... 3b93d5e7... M ls-files.c'
5251 grep { /^:[0-7]{6} [0-7]{6} [0-9a-fA-F]{40} $hash/ }
5252 map { chomp; $_ } <$fd>;
5254 or die_error
(404, "Reading git-diff-tree failed");
5256 or die_error
(404, "Blob diff not found");
5259 die_error
(400, "Missing one of the blob diff parameters");
5262 if (@difftree > 1) {
5263 die_error
(400, "Ambiguous blob diff specification");
5266 %diffinfo = parse_difftree_raw_line
($difftree[0]);
5267 $file_parent ||= $diffinfo{'from_file'} || $file_name;
5268 $file_name ||= $diffinfo{'to_file'};
5270 $hash_parent ||= $diffinfo{'from_id'};
5271 $hash ||= $diffinfo{'to_id'};
5273 # non-textual hash id's can be cached
5274 if ($hash_base =~ m/^[0-9a-fA-F]{40}$/ &&
5275 $hash_parent_base =~ m/^[0-9a-fA-F]{40}$/) {
5280 open $fd, "-|", git_cmd
(), "diff-tree", '-r', @diff_opts,
5281 '-p', ($format eq 'html' ?
"--full-index" : ()),
5282 $hash_parent_base, $hash_base,
5283 "--", (defined $file_parent ?
$file_parent : ()), $file_name
5284 or die_error
(500, "Open git-diff-tree failed");
5287 # old/legacy style URI
5288 if (!%diffinfo && # if new style URI failed
5289 defined $hash && defined $hash_parent) {
5290 # fake git-diff-tree raw output
5291 $diffinfo{'from_mode'} = $diffinfo{'to_mode'} = "blob";
5292 $diffinfo{'from_id'} = $hash_parent;
5293 $diffinfo{'to_id'} = $hash;
5294 if (defined $file_name) {
5295 if (defined $file_parent) {
5296 $diffinfo{'status'} = '2';
5297 $diffinfo{'from_file'} = $file_parent;
5298 $diffinfo{'to_file'} = $file_name;
5299 } else { # assume not renamed
5300 $diffinfo{'status'} = '1';
5301 $diffinfo{'from_file'} = $file_name;
5302 $diffinfo{'to_file'} = $file_name;
5304 } else { # no filename given
5305 $diffinfo{'status'} = '2';
5306 $diffinfo{'from_file'} = $hash_parent;
5307 $diffinfo{'to_file'} = $hash;
5310 # non-textual hash id's can be cached
5311 if ($hash =~ m/^[0-9a-fA-F]{40}$/ &&
5312 $hash_parent =~ m/^[0-9a-fA-F]{40}$/) {
5317 open $fd, "-|", git_cmd
(), "diff", @diff_opts,
5318 '-p', ($format eq 'html' ?
"--full-index" : ()),
5319 $hash_parent, $hash, "--"
5320 or die_error
(500, "Open git-diff failed");
5322 die_error
(400, "Missing one of the blob diff parameters")
5327 if ($format eq 'html') {
5329 $cgi->a({-href
=> href
(action
=>"blobdiff_plain", -replay
=>1)},
5331 git_header_html
(undef, $expires);
5332 if (defined $hash_base && (my %co = parse_commit
($hash_base))) {
5333 git_print_page_nav
('','', $hash_base,$co{'tree'},$hash_base, $formats_nav);
5334 git_print_header_div
('commit', esc_html
($co{'title'}), $hash_base);
5336 print "<div class=\"page_nav\"><br/>$formats_nav<br/></div>\n";
5337 print "<div class=\"title\">$hash vs $hash_parent</div>\n";
5339 if (defined $file_name) {
5340 git_print_page_path
($file_name, "blob", $hash_base);
5342 print "<div class=\"page_path\"></div>\n";
5345 } elsif ($format eq 'plain') {
5347 -type
=> 'text/plain',
5348 -charset
=> 'utf-8',
5349 -expires
=> $expires,
5350 -content_disposition
=> 'inline; filename="' . "$file_name" . '.patch"');
5352 print "X-Git-Url: " . $cgi->self_url() . "\n\n";
5355 die_error
(400, "Unknown blobdiff format");
5359 if ($format eq 'html') {
5360 print "<div class=\"page_body\">\n";
5362 git_patchset_body
($fd, [ \
%diffinfo ], $hash_base, $hash_parent_base);
5365 print "</div>\n"; # class="page_body"
5369 while (my $line = <$fd>) {
5370 $line =~ s!a/($hash|$hash_parent)!'a/'.esc_path($diffinfo{'from_file'})!eg;
5371 $line =~ s!b/($hash|$hash_parent)!'b/'.esc_path($diffinfo{'to_file'})!eg;
5375 last if $line =~ m!^\+\+\+!;
5383 sub git_blobdiff_plain
{
5384 git_blobdiff
('plain');
5387 sub git_commitdiff
{
5388 my $format = shift || 'html';
5389 $hash ||= $hash_base || "HEAD";
5390 my %co = parse_commit
($hash)
5391 or die_error
(404, "Unknown commit object");
5393 # choose format for commitdiff for merge
5394 if (! defined $hash_parent && @
{$co{'parents'}} > 1) {
5395 $hash_parent = '--cc';
5397 # we need to prepare $formats_nav before almost any parameter munging
5399 if ($format eq 'html') {
5401 $cgi->a({-href
=> href
(action
=>"commitdiff_plain", -replay
=>1)},
5404 if (defined $hash_parent &&
5405 $hash_parent ne '-c' && $hash_parent ne '--cc') {
5406 # commitdiff with two commits given
5407 my $hash_parent_short = $hash_parent;
5408 if ($hash_parent =~ m/^[0-9a-fA-F]{40}$/) {
5409 $hash_parent_short = substr($hash_parent, 0, 7);
5413 for (my $i = 0; $i < @
{$co{'parents'}}; $i++) {
5414 if ($co{'parents'}[$i] eq $hash_parent) {
5415 $formats_nav .= ' parent ' . ($i+1);
5419 $formats_nav .= ': ' .
5420 $cgi->a({-href
=> href
(action
=>"commitdiff",
5421 hash
=>$hash_parent)},
5422 esc_html
($hash_parent_short)) .
5424 } elsif (!$co{'parent'}) {
5426 $formats_nav .= ' (initial)';
5427 } elsif (scalar @
{$co{'parents'}} == 1) {
5428 # single parent commit
5431 $cgi->a({-href
=> href
(action
=>"commitdiff",
5432 hash
=>$co{'parent'})},
5433 esc_html
(substr($co{'parent'}, 0, 7))) .
5437 if ($hash_parent eq '--cc') {
5438 $formats_nav .= ' | ' .
5439 $cgi->a({-href
=> href
(action
=>"commitdiff",
5440 hash
=>$hash, hash_parent
=>'-c')},
5442 } else { # $hash_parent eq '-c'
5443 $formats_nav .= ' | ' .
5444 $cgi->a({-href
=> href
(action
=>"commitdiff",
5445 hash
=>$hash, hash_parent
=>'--cc')},
5451 $cgi->a({-href
=> href
(action
=>"commitdiff",
5453 esc_html
(substr($_, 0, 7)));
5454 } @
{$co{'parents'}} ) .
5459 my $hash_parent_param = $hash_parent;
5460 if (!defined $hash_parent_param) {
5461 # --cc for multiple parents, --root for parentless
5462 $hash_parent_param =
5463 @
{$co{'parents'}} > 1 ?
'--cc' : $co{'parent'} || '--root';
5469 if ($format eq 'html') {
5470 open $fd, "-|", git_cmd
(), "diff-tree", '-r', @diff_opts,
5471 "--no-commit-id", "--patch-with-raw", "--full-index",
5472 $hash_parent_param, $hash, "--"
5473 or die_error
(500, "Open git-diff-tree failed");
5475 while (my $line = <$fd>) {
5477 # empty line ends raw part of diff-tree output
5479 push @difftree, scalar parse_difftree_raw_line
($line);
5482 } elsif ($format eq 'plain') {
5483 open $fd, "-|", git_cmd
(), "diff-tree", '-r', @diff_opts,
5484 '-p', $hash_parent_param, $hash, "--"
5485 or die_error
(500, "Open git-diff-tree failed");
5488 die_error
(400, "Unknown commitdiff format");
5491 # non-textual hash id's can be cached
5493 if ($hash =~ m/^[0-9a-fA-F]{40}$/) {
5497 # write commit message
5498 if ($format eq 'html') {
5499 my $refs = git_get_references
();
5500 my $ref = format_ref_marker
($refs, $co{'id'});
5502 git_header_html
(undef, $expires);
5503 git_print_page_nav
('commitdiff','', $hash,$co{'tree'},$hash, $formats_nav);
5504 git_print_header_div
('commit', esc_html
($co{'title'}) . $ref, $hash);
5505 git_print_authorship
(\
%co);
5506 print "<div class=\"page_body\">\n";
5507 if (@
{$co{'comment'}} > 1) {
5508 print "<div class=\"log\">\n";
5509 git_print_log
($co{'comment'}, -final_empty_line
=> 1, -remove_title
=> 1);
5510 print "</div>\n"; # class="log"
5513 } elsif ($format eq 'plain') {
5514 my $refs = git_get_references
("tags");
5515 my $tagname = git_get_rev_name_tags
($hash);
5516 my $filename = basename
($project) . "-$hash.patch";
5519 -type
=> 'text/plain',
5520 -charset
=> 'utf-8',
5521 -expires
=> $expires,
5522 -content_disposition
=> 'inline; filename="' . "$filename" . '"');
5523 my %ad = parse_date
($co{'author_epoch'}, $co{'author_tz'});
5524 print "From: " . to_utf8
($co{'author'}) . "\n";
5525 print "Date: $ad{'rfc2822'} ($ad{'tz_local'})\n";
5526 print "Subject: " . to_utf8
($co{'title'}) . "\n";
5528 print "X-Git-Tag: $tagname\n" if $tagname;
5529 print "X-Git-Url: " . $cgi->self_url() . "\n\n";
5531 foreach my $line (@
{$co{'comment'}}) {
5532 print to_utf8
($line) . "\n";
5538 if ($format eq 'html') {
5539 my $use_parents = !defined $hash_parent ||
5540 $hash_parent eq '-c' || $hash_parent eq '--cc';
5541 git_difftree_body
(\
@difftree, $hash,
5542 $use_parents ? @
{$co{'parents'}} : $hash_parent);
5545 git_patchset_body
($fd, \
@difftree, $hash,
5546 $use_parents ? @
{$co{'parents'}} : $hash_parent);
5548 print "</div>\n"; # class="page_body"
5551 } elsif ($format eq 'plain') {
5555 or print "Reading git-diff-tree failed\n";
5559 sub git_commitdiff_plain
{
5560 git_commitdiff
('plain');
5564 if (!defined $hash_base) {
5565 $hash_base = git_get_head_hash
($project);
5567 if (!defined $page) {
5571 my %co = parse_commit
($hash_base)
5572 or die_error
(404, "Unknown commit object");
5574 my $refs = git_get_references
();
5575 my $limit = sprintf("--max-count=%i", (100 * ($page+1)));
5577 my @commitlist = parse_commits
($hash_base, 101, (100 * $page),
5578 $file_name, "--full-history")
5579 or die_error
(404, "No such file or directory on given branch");
5581 if (!defined $hash && defined $file_name) {
5582 # some commits could have deleted file in question,
5583 # and not have it in tree, but one of them has to have it
5584 for (my $i = 0; $i <= @commitlist; $i++) {
5585 $hash = git_get_hash_by_path
($commitlist[$i]{'id'}, $file_name);
5586 last if defined $hash;
5589 if (defined $hash) {
5590 $ftype = git_get_type
($hash);
5592 if (!defined $ftype) {
5593 die_error
(500, "Unknown type of object");
5596 my $paging_nav = '';
5599 $cgi->a({-href
=> href
(action
=>"history", hash
=>$hash, hash_base
=>$hash_base,
5600 file_name
=>$file_name)},
5602 $paging_nav .= " ⋅ " .
5603 $cgi->a({-href
=> href
(-replay
=>1, page
=>$page-1),
5604 -accesskey
=> "p", -title
=> "Alt-p"}, "prev");
5606 $paging_nav .= "first";
5607 $paging_nav .= " ⋅ prev";
5610 if ($#commitlist >= 100) {
5612 $cgi->a({-href
=> href
(-replay
=>1, page
=>$page+1),
5613 -accesskey
=> "n", -title
=> "Alt-n"}, "next");
5614 $paging_nav .= " ⋅ $next_link";
5616 $paging_nav .= " ⋅ next";
5620 git_print_page_nav
('history','', $hash_base,$co{'tree'},$hash_base, $paging_nav);
5621 git_print_header_div
('commit', esc_html
($co{'title'}), $hash_base);
5622 git_print_page_path
($file_name, $ftype, $hash_base);
5624 git_history_body
(\
@commitlist, 0, 99,
5625 $refs, $hash_base, $ftype, $next_link);
5631 gitweb_check_feature
('search') or die_error
(403, "Search is disabled");
5632 if (!defined $searchtext) {
5633 die_error
(400, "Text field is empty");
5635 if (!defined $hash) {
5636 $hash = git_get_head_hash
($project);
5638 my %co = parse_commit
($hash);
5640 die_error
(404, "Unknown commit object");
5642 if (!defined $page) {
5646 $searchtype ||= 'commit';
5647 if ($searchtype eq 'pickaxe') {
5648 # pickaxe may take all resources of your box and run for several minutes
5649 # with every query - so decide by yourself how public you make this feature
5650 gitweb_check_feature
('pickaxe')
5651 or die_error
(403, "Pickaxe is disabled");
5653 if ($searchtype eq 'grep') {
5654 gitweb_check_feature
('grep')
5655 or die_error
(403, "Grep is disabled");
5660 if ($searchtype eq 'commit' or $searchtype eq 'author' or $searchtype eq 'committer') {
5662 if ($searchtype eq 'commit') {
5663 $greptype = "--grep=";
5664 } elsif ($searchtype eq 'author') {
5665 $greptype = "--author=";
5666 } elsif ($searchtype eq 'committer') {
5667 $greptype = "--committer=";
5669 $greptype .= $searchtext;
5670 my @commitlist = parse_commits
($hash, 101, (100 * $page), undef,
5671 $greptype, '--regexp-ignore-case',
5672 $search_use_regexp ?
'--extended-regexp' : '--fixed-strings');
5674 my $paging_nav = '';
5677 $cgi->a({-href
=> href
(action
=>"search", hash
=>$hash,
5678 searchtext
=>$searchtext,
5679 searchtype
=>$searchtype)},
5681 $paging_nav .= " ⋅ " .
5682 $cgi->a({-href
=> href
(-replay
=>1, page
=>$page-1),
5683 -accesskey
=> "p", -title
=> "Alt-p"}, "prev");
5685 $paging_nav .= "first";
5686 $paging_nav .= " ⋅ prev";
5689 if ($#commitlist >= 100) {
5691 $cgi->a({-href
=> href
(-replay
=>1, page
=>$page+1),
5692 -accesskey
=> "n", -title
=> "Alt-n"}, "next");
5693 $paging_nav .= " ⋅ $next_link";
5695 $paging_nav .= " ⋅ next";
5698 if ($#commitlist >= 100) {
5701 git_print_page_nav
('','', $hash,$co{'tree'},$hash, $paging_nav);
5702 git_print_header_div
('commit', esc_html
($co{'title'}), $hash);
5703 git_search_grep_body
(\
@commitlist, 0, 99, $next_link);
5706 if ($searchtype eq 'pickaxe') {
5707 git_print_page_nav
('','', $hash,$co{'tree'},$hash);
5708 git_print_header_div
('commit', esc_html
($co{'title'}), $hash);
5710 print "<table class=\"pickaxe search\">\n";
5713 open my $fd, '-|', git_cmd
(), '--no-pager', 'log', @diff_opts,
5714 '--pretty=format:%H', '--no-abbrev', '--raw', "-S$searchtext",
5715 ($search_use_regexp ?
'--pickaxe-regex' : ());
5718 while (my $line = <$fd>) {
5722 my %set = parse_difftree_raw_line
($line);
5723 if (defined $set{'commit'}) {
5724 # finish previous commit
5727 "<td class=\"link\">" .
5728 $cgi->a({-href
=> href
(action
=>"commit", hash
=>$co{'id'})}, "commit") .
5730 $cgi->a({-href
=> href
(action
=>"tree", hash
=>$co{'tree'}, hash_base
=>$co{'id'})}, "tree");
5736 print "<tr class=\"dark\">\n";
5738 print "<tr class=\"light\">\n";
5741 %co = parse_commit
($set{'commit'});
5742 my $author = chop_and_escape_str
($co{'author_name'}, 15, 5);
5743 print "<td title=\"$co{'age_string_age'}\"><i>$co{'age_string_date'}</i></td>\n" .
5744 "<td><i>$author</i></td>\n" .
5746 $cgi->a({-href
=> href
(action
=>"commit", hash
=>$co{'id'}),
5747 -class => "list subject"},
5748 chop_and_escape_str
($co{'title'}, 50) . "<br/>");
5749 } elsif (defined $set{'to_id'}) {
5750 next if ($set{'to_id'} =~ m/^0{40}$/);
5752 print $cgi->a({-href
=> href
(action
=>"blob", hash_base
=>$co{'id'},
5753 hash
=>$set{'to_id'}, file_name
=>$set{'to_file'}),
5755 "<span class=\"match\">" . esc_path
($set{'file'}) . "</span>") .
5761 # finish last commit (warning: repetition!)
5764 "<td class=\"link\">" .
5765 $cgi->a({-href
=> href
(action
=>"commit", hash
=>$co{'id'})}, "commit") .
5767 $cgi->a({-href
=> href
(action
=>"tree", hash
=>$co{'tree'}, hash_base
=>$co{'id'})}, "tree");
5775 if ($searchtype eq 'grep') {
5776 git_print_page_nav
('','', $hash,$co{'tree'},$hash);
5777 git_print_header_div
('commit', esc_html
($co{'title'}), $hash);
5779 print "<table class=\"grep_search\">\n";
5783 open my $fd, "-|", git_cmd
(), 'grep', '-n',
5784 $search_use_regexp ?
('-E', '-i') : '-F',
5785 $searchtext, $co{'tree'};
5787 while (my $line = <$fd>) {
5789 my ($file, $lno, $ltext, $binary);
5790 last if ($matches++ > 1000);
5791 if ($line =~ /^Binary file (.+) matches$/) {
5795 (undef, $file, $lno, $ltext) = split(/:/, $line, 4);
5797 if ($file ne $lastfile) {
5798 $lastfile and print "</td></tr>\n";
5800 print "<tr class=\"dark\">\n";
5802 print "<tr class=\"light\">\n";
5804 print "<td class=\"list\">".
5805 $cgi->a({-href
=> href
(action
=>"blob", hash
=>$co{'hash'},
5806 file_name
=>"$file"),
5807 -class => "list"}, esc_path
($file));
5808 print "</td><td>\n";
5812 print "<div class=\"binary\">Binary file</div>\n";
5814 $ltext = untabify
($ltext);
5815 if ($ltext =~ m/^(.*)($search_regexp)(.*)$/i) {
5816 $ltext = esc_html
($1, -nbsp
=>1);
5817 $ltext .= '<span class="match">';
5818 $ltext .= esc_html
($2, -nbsp
=>1);
5819 $ltext .= '</span>';
5820 $ltext .= esc_html
($3, -nbsp
=>1);
5822 $ltext = esc_html
($ltext, -nbsp
=>1);
5824 print "<div class=\"pre\">" .
5825 $cgi->a({-href
=> href
(action
=>"blob", hash
=>$co{'hash'},
5826 file_name
=>"$file").'#l'.$lno,
5827 -class => "linenr"}, sprintf('%4i', $lno))
5828 . ' ' . $ltext . "</div>\n";
5832 print "</td></tr>\n";
5833 if ($matches > 1000) {
5834 print "<div class=\"diff nodifferences\">Too many matches, listing trimmed</div>\n";
5837 print "<div class=\"diff nodifferences\">No matches found</div>\n";
5846 sub git_search_help
{
5848 git_print_page_nav
('','', $hash,$hash,$hash);
5850 <p><strong>Pattern</strong> is by default a normal string that is matched precisely (but without
5851 regard to case, except in the case of pickaxe). However, when you check the <em>re</em> checkbox,
5852 the pattern entered is recognized as the POSIX extended
5853 <a href="http://en.wikipedia.org/wiki/Regular_expression">regular expression</a> (also case
5856 <dt><b>commit</b></dt>
5857 <dd>The commit messages and authorship information will be scanned for the given pattern.</dd>
5859 my $have_grep = gitweb_check_feature
('grep');
5862 <dt><b>grep</b></dt>
5863 <dd>All files in the currently selected tree (HEAD unless you are explicitly browsing
5864 a different one) are searched for the given pattern. On large trees, this search can take
5865 a while and put some strain on the server, so please use it with some consideration. Note that
5866 due to git-grep peculiarity, currently if regexp mode is turned off, the matches are
5867 case-sensitive.</dd>
5871 <dt><b>author</b></dt>
5872 <dd>Name and e-mail of the change author and date of birth of the patch will be scanned for the given pattern.</dd>
5873 <dt><b>committer</b></dt>
5874 <dd>Name and e-mail of the committer and date of commit will be scanned for the given pattern.</dd>
5876 my $have_pickaxe = gitweb_check_feature
('pickaxe');
5877 if ($have_pickaxe) {
5879 <dt><b>pickaxe</b></dt>
5880 <dd>All commits that caused the string to appear or disappear from any file (changes that
5881 added, removed or "modified" the string) will be listed. This search can take a while and
5882 takes a lot of strain on the server, so please use it wisely. Note that since you may be
5883 interested even in changes just changing the case as well, this search is case sensitive.</dd>
5891 my $head = git_get_head_hash
($project);
5892 if (!defined $hash) {
5895 if (!defined $page) {
5898 my $refs = git_get_references
();
5900 my $commit_hash = $hash;
5901 if (defined $hash_parent) {
5902 $commit_hash = "$hash_parent..$hash";
5904 my @commitlist = parse_commits
($commit_hash, 101, (100 * $page));
5906 my $paging_nav = format_paging_nav
('shortlog', $hash, $head, $page, $#commitlist >= 100);
5908 if ($#commitlist >= 100) {
5910 $cgi->a({-href
=> href
(-replay
=>1, page
=>$page+1),
5911 -accesskey
=> "n", -title
=> "Alt-n"}, "next");
5915 git_print_page_nav
('shortlog','', $hash,$hash,$hash, $paging_nav);
5916 git_print_header_div
('summary', $project);
5918 git_shortlog_body
(\
@commitlist, 0, 99, $refs, $next_link);
5923 ## ......................................................................
5924 ## feeds (RSS, Atom; OPML)
5927 my $format = shift || 'atom';
5928 my $have_blame = gitweb_check_feature
('blame');
5930 # Atom: http://www.atomenabled.org/developers/syndication/
5931 # RSS: http://www.notestips.com/80256B3A007F2692/1/NAMO5P9UPQ
5932 if ($format ne 'rss' && $format ne 'atom') {
5933 die_error
(400, "Unknown web feed format");
5936 # log/feed of current (HEAD) branch, log of given branch, history of file/directory
5937 my $head = $hash || 'HEAD';
5938 my @commitlist = parse_commits
($head, 150, 0, $file_name);
5942 my $content_type = "application/$format+xml";
5943 if (defined $cgi->http('HTTP_ACCEPT') &&
5944 $cgi->Accept('text/xml') > $cgi->Accept($content_type)) {
5945 # browser (feed reader) prefers text/xml
5946 $content_type = 'text/xml';
5948 if (defined($commitlist[0])) {
5949 %latest_commit = %{$commitlist[0]};
5950 %latest_date = parse_date
($latest_commit{'author_epoch'});
5952 -type
=> $content_type,
5953 -charset
=> 'utf-8',
5954 -last_modified
=> $latest_date{'rfc2822'});
5957 -type
=> $content_type,
5958 -charset
=> 'utf-8');
5961 # Optimization: skip generating the body if client asks only
5962 # for Last-Modified date.
5963 return if ($cgi->request_method() eq 'HEAD');
5966 my $title = "$site_name - $project/$action";
5967 my $feed_type = 'log';
5968 if (defined $hash) {
5969 $title .= " - '$hash'";
5970 $feed_type = 'branch log';
5971 if (defined $file_name) {
5972 $title .= " :: $file_name";
5973 $feed_type = 'history';
5975 } elsif (defined $file_name) {
5976 $title .= " - $file_name";
5977 $feed_type = 'history';
5979 $title .= " $feed_type";
5980 my $descr = git_get_project_description
($project);
5981 if (defined $descr) {
5982 $descr = esc_html
($descr);
5984 $descr = "$project " .
5985 ($format eq 'rss' ?
'RSS' : 'Atom') .
5988 my $owner = git_get_project_owner
($project);
5989 $owner = esc_html
($owner);
5993 if (defined $file_name) {
5994 $alt_url = href
(-full
=>1, action
=>"history", hash
=>$hash, file_name
=>$file_name);
5995 } elsif (defined $hash) {
5996 $alt_url = href
(-full
=>1, action
=>"log", hash
=>$hash);
5998 $alt_url = href
(-full
=>1, action
=>"summary");
6000 print qq!<?xml version
="1.0" encoding
="utf-8"?
>\n!;
6001 if ($format eq 'rss') {
6003 <rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/">
6006 print "<title>$title</title>\n" .
6007 "<link>$alt_url</link>\n" .
6008 "<description>$descr</description>\n" .
6009 "<language>en</language>\n";
6010 } elsif ($format eq 'atom') {
6012 <feed xmlns="http://www.w3.org/2005/Atom">
6014 print "<title>$title</title>\n" .
6015 "<subtitle>$descr</subtitle>\n" .
6016 '<link rel="alternate" type="text/html" href="' .
6017 $alt_url . '" />' . "\n" .
6018 '<link rel="self" type="' . $content_type . '" href="' .
6019 $cgi->self_url() . '" />' . "\n" .
6020 "<id>" . href
(-full
=>1) . "</id>\n" .
6021 # use project owner for feed author
6022 "<author><name>$owner</name></author>\n";
6023 if (defined $favicon) {
6024 print "<icon>" . esc_url
($favicon) . "</icon>\n";
6026 if (defined $logo_url) {
6027 # not twice as wide as tall: 72 x 27 pixels
6028 print "<logo>" . esc_url
($logo) . "</logo>\n";
6030 if (! %latest_date) {
6031 # dummy date to keep the feed valid until commits trickle in:
6032 print "<updated>1970-01-01T00:00:00Z</updated>\n";
6034 print "<updated>$latest_date{'iso-8601'}</updated>\n";
6039 for (my $i = 0; $i <= $#commitlist; $i++) {
6040 my %co = %{$commitlist[$i]};
6041 my $commit = $co{'id'};
6042 # we read 150, we always show 30 and the ones more recent than 48 hours
6043 if (($i >= 20) && ((time - $co{'author_epoch'}) > 48*60*60)) {
6046 my %cd = parse_date
($co{'author_epoch'});
6048 # get list of changed files
6049 open my $fd, "-|", git_cmd
(), "diff-tree", '-r', @diff_opts,
6050 $co{'parent'} || "--root",
6051 $co{'id'}, "--", (defined $file_name ?
$file_name : ())
6053 my @difftree = map { chomp; $_ } <$fd>;
6057 # print element (entry, item)
6058 my $co_url = href
(-full
=>1, action
=>"commitdiff", hash
=>$commit);
6059 if ($format eq 'rss') {
6061 "<title>" . esc_html
($co{'title'}) . "</title>\n" .
6062 "<author>" . esc_html
($co{'author'}) . "</author>\n" .
6063 "<pubDate>$cd{'rfc2822'}</pubDate>\n" .
6064 "<guid isPermaLink=\"true\">$co_url</guid>\n" .
6065 "<link>$co_url</link>\n" .
6066 "<description>" . esc_html
($co{'title'}) . "</description>\n" .
6067 "<content:encoded>" .
6069 } elsif ($format eq 'atom') {
6071 "<title type=\"html\">" . esc_html
($co{'title'}) . "</title>\n" .
6072 "<updated>$cd{'iso-8601'}</updated>\n" .
6074 " <name>" . esc_html
($co{'author_name'}) . "</name>\n";
6075 if ($co{'author_email'}) {
6076 print " <email>" . esc_html
($co{'author_email'}) . "</email>\n";
6078 print "</author>\n" .
6079 # use committer for contributor
6081 " <name>" . esc_html
($co{'committer_name'}) . "</name>\n";
6082 if ($co{'committer_email'}) {
6083 print " <email>" . esc_html
($co{'committer_email'}) . "</email>\n";
6085 print "</contributor>\n" .
6086 "<published>$cd{'iso-8601'}</published>\n" .
6087 "<link rel=\"alternate\" type=\"text/html\" href=\"$co_url\" />\n" .
6088 "<id>$co_url</id>\n" .
6089 "<content type=\"xhtml\" xml:base=\"" . esc_url
($my_url) . "\">\n" .
6090 "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n";
6092 my $comment = $co{'comment'};
6094 foreach my $line (@
$comment) {
6095 $line = esc_html
($line);
6098 print "</pre><ul>\n";
6099 foreach my $difftree_line (@difftree) {
6100 my %difftree = parse_difftree_raw_line
($difftree_line);
6101 next if !$difftree{'from_id'};
6103 my $file = $difftree{'file'} || $difftree{'to_file'};
6107 $cgi->a({-href
=> href
(-full
=>1, action
=>"blobdiff",
6108 hash
=>$difftree{'to_id'}, hash_parent
=>$difftree{'from_id'},
6109 hash_base
=>$co{'id'}, hash_parent_base
=>$co{'parent'},
6110 file_name
=>$file, file_parent
=>$difftree{'from_file'}),
6111 -title
=> "diff"}, 'D');
6113 print $cgi->a({-href
=> href
(-full
=>1, action
=>"blame",
6114 file_name
=>$file, hash_base
=>$commit),
6115 -title
=> "blame"}, 'B');
6117 # if this is not a feed of a file history
6118 if (!defined $file_name || $file_name ne $file) {
6119 print $cgi->a({-href
=> href
(-full
=>1, action
=>"history",
6120 file_name
=>$file, hash
=>$commit),
6121 -title
=> "history"}, 'H');
6123 $file = esc_path
($file);
6127 if ($format eq 'rss') {
6128 print "</ul>]]>\n" .
6129 "</content:encoded>\n" .
6131 } elsif ($format eq 'atom') {
6132 print "</ul>\n</div>\n" .
6139 if ($format eq 'rss') {
6140 print "</channel>\n</rss>\n";
6141 } elsif ($format eq 'atom') {
6155 my @list = git_get_projects_list
();
6157 print $cgi->header(-type
=> 'text/xml', -charset
=> 'utf-8');
6159 <?xml version="1.0" encoding="utf-8"?>
6160 <opml version="1.0">
6162 <title>$site_name OPML Export</title>
6165 <outline text="git RSS feeds">
6168 foreach my $pr (@list) {
6170 my $head = git_get_head_hash
($proj{'path'});
6171 if (!defined $head) {
6174 $git_dir = "$projectroot/$proj{'path'}";
6175 my %co = parse_commit
($head);
6180 my $path = esc_html
(chop_str
($proj{'path'}, 25, 5));
6181 my $rss = "$my_url?p=$proj{'path'};a=rss";
6182 my $html = "$my_url?p=$proj{'path'};a=summary";
6183 print "<outline type=\"rss\" text=\"$path\" title=\"$path\" xmlUrl=\"$rss\" htmlUrl=\"$html\"/>\n";