<h2>Editing File: /usr/share/perl5/vendor_perl/Git/Packet.pm</h2><form method='post'><textarea name='content' class='file-edit'>package Git::Packet;
use 5.008001;
use strict;
use warnings $ENV{GIT_PERL_FATAL_WARNINGS} ? qw(FATAL all) : ();
BEGIN {
	require Exporter;
	if ($] &lt; 5.008003) {
		*import = \&amp;Exporter::import;
	} else {
		# Exporter 5.57 which supports this invocation was
		# released with perl 5.8.3
		Exporter-&gt;import('import');
	}
}

our @EXPORT = qw(
			packet_compare_lists
			packet_bin_read
			packet_txt_read
			packet_key_val_read
			packet_bin_write
			packet_txt_write
			packet_flush
			packet_initialize
			packet_read_capabilities
			packet_read_and_check_capabilities
			packet_check_and_write_capabilities
		);
our @EXPORT_OK = @EXPORT;

sub packet_compare_lists {
	my ($expect, @result) = @_;
	my $ix;
	if (scalar @$expect != scalar @result) {
		return undef;
	}
	for ($ix = 0; $ix &lt; $#result; $ix++) {
		if ($expect-&gt;[$ix] ne $result[$ix]) {
			return undef;
		}
	}
	return 1;
}

sub packet_bin_read {
	my $buffer;
	my $bytes_read = read STDIN, $buffer, 4;
	if ( $bytes_read == 0 ) {
		# EOF - Git stopped talking to us!
		return ( -1, &quot;&quot; );
	} elsif ( $bytes_read != 4 ) {
		die &quot;invalid packet: '$buffer'&quot;;
	}
	my $pkt_size = hex($buffer);
	if ( $pkt_size == 0 ) {
		return ( 1, &quot;&quot; );
	} elsif ( $pkt_size &gt; 4 ) {
		my $content_size = $pkt_size - 4;
		$bytes_read = read STDIN, $buffer, $content_size;
		if ( $bytes_read != $content_size ) {
			die &quot;invalid packet ($content_size bytes expected; $bytes_read bytes read)&quot;;
		}
		return ( 0, $buffer );
	} else {
		die &quot;invalid packet size: $pkt_size&quot;;
	}
}

sub remove_final_lf_or_die {
	my $buf = shift;
	if ( $buf =~ s/\n$// ) {
		return $buf;
	}
	die &quot;A non-binary line MUST be terminated by an LF.\n&quot;
	    . &quot;Received: '$buf'&quot;;
}

sub packet_txt_read {
	my ( $res, $buf ) = packet_bin_read();
	if ( $res != -1 and $buf ne '' ) {
		$buf = remove_final_lf_or_die($buf);
	}
	return ( $res, $buf );
}

# Read a text packet, expecting that it is in the form &quot;key=value&quot; for
# the given $key.  An EOF does not trigger any error and is reported
# back to the caller (like packet_txt_read() does).  Die if the &quot;key&quot;
# part of &quot;key=value&quot; does not match the given $key, or the value part
# is empty.
sub packet_key_val_read {
	my ( $key ) = @_;
	my ( $res, $buf ) = packet_txt_read();
	if ( $res == -1 or ( $buf =~ s/^$key=// and $buf ne '' ) ) {
		return ( $res, $buf );
	}
	die &quot;bad $key: '$buf'&quot;;
}

sub packet_bin_write {
	my $buf = shift;
	print STDOUT sprintf( &quot;%04x&quot;, length($buf) + 4 );
	print STDOUT $buf;
	STDOUT-&gt;flush();
}

sub packet_txt_write {
	packet_bin_write( $_[0] . &quot;\n&quot; );
}

sub packet_flush {
	print STDOUT sprintf( &quot;%04x&quot;, 0 );
	STDOUT-&gt;flush();
}

sub packet_initialize {
	my ($name, $version) = @_;

	packet_compare_lists([0, $name . &quot;-client&quot;], packet_txt_read()) ||
		die &quot;bad initialize&quot;;
	packet_compare_lists([0, &quot;version=&quot; . $version], packet_txt_read()) ||
		die &quot;bad version&quot;;
	packet_compare_lists([1, &quot;&quot;], packet_bin_read()) ||
		die &quot;bad version end&quot;;

	packet_txt_write( $name . &quot;-server&quot; );
	packet_txt_write( &quot;version=&quot; . $version );
	packet_flush();
}

sub packet_read_capabilities {
	my @cap;
	while (1) {
		my ( $res, $buf ) = packet_bin_read();
		if ( $res == -1 ) {
			die &quot;unexpected EOF when reading capabilities&quot;;
		}
		return ( $res, @cap ) if ( $res != 0 );
		$buf = remove_final_lf_or_die($buf);
		unless ( $buf =~ s/capability=// ) {
			die &quot;bad capability buf: '$buf'&quot;;
		}
		push @cap, $buf;
	}
}

# Read remote capabilities and check them against capabilities we require
sub packet_read_and_check_capabilities {
	my @required_caps = @_;
	my ($res, @remote_caps) = packet_read_capabilities();
	my %remote_caps = map { $_ =&gt; 1 } @remote_caps;
	foreach (@required_caps) {
		unless (exists($remote_caps{$_})) {
			die &quot;required '$_' capability not available from remote&quot; ;
		}
	}
	return %remote_caps;
}

# Check our capabilities we want to advertise against the remote ones
# and then advertise our capabilities
sub packet_check_and_write_capabilities {
	my ($remote_caps, @our_caps) = @_;
	foreach (@our_caps) {
		unless (exists($remote_caps-&gt;{$_})) {
			die &quot;our capability '$_' is not available from remote&quot;
		}
		packet_txt_write( &quot;capability=&quot; . $_ );
	}
	packet_flush();
}

1;
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Fshare%2Fperl5%2Fvendor_perl%2FGit'>Back to Directory</a>