threads / discuss / 807

cg-push protocol proposal

Subject: cg-push protocol proposal

## tl;dr

2 messages between Jun 2, 2005 and Jun 2, 2005.

replies: 1people: 1as markdown or json

McMullan, Jason· Jun 2, 2005, 12:54 UTC · lore

I'd like to propose the following protocol for 'pushes'. Assume that a 'git-daemon' is the 'server', and is talking on stdin/stdout.

Each command is an ascii string, followed by a LF (\n)
Request current head ID:
	  head <head-name>\n
	Responses:
	  head <head-name> <sha1>\n
	  error <head-name> <hex-code> <error-string>\n
Request a SHA1 blob from the server
	  send <sha1>\n
	Responses:
	  send <sha1> <hex-size>\n<bytes...>
	  error <sha1> <hex-code> <error-string>\n
Update head ID to a SHA1 (the SHA1 may already be in the server's DB)
	  head <head-name> <old-sha1> <sha1>\n
1)	Response if <head-name> is now <sha1>:
	  head <head-name> <sha1>\n
	Response if error, or head locked by someone else updating:
	  error <head-name> <hex-code> <error-string>\n
	Response if <sha1> is not in the database:
	  send <sha1>\n		- Server needs the blob
2)	Client response if 'send' is returned:
 
	  send <sha1> <hex-size>\n<bytes...>
3)	Response if more objects are needed 
          (ie you sent a commit or tree object)
	  send <new-sha1>\n	- Server needs blob
	  Remember the SHA1 you sent, 'call' step 2) with new-sha1 
	  Goto 3)
	Response if send succeeded:
	  exists <sha1>\n
	Response if send failed:
	  error <sha1> <hex-code> <error-string>\n
TODO: Tags
	
-- 
Jason McMullan <jason.mcmullan@timesys.com>
TimeSys Corporation
McMullan, Jason· Jun 2, 2005, 15:00 UTC · re: McMullan, Jason · lore

Re: cg-push protocol proposal [update]

On Thu, 2005-06-02 at 08:47 -0400, McMullan, Jason wrote: I'd like to propose the following protocol for 'pushes'. Assume that a 'git-daemon' is the 'server', and is talking on stdin/stdout.

If you want to only do cmp-xchg style head updates, just 'send' the commit object first (the protocol will request any missing pieces), then do the 'head <head-id> <old-sha1> <new-sha1>'.

-- 
Jason McMullan <jason.mcmullan@timesys.com>
TimeSys Corporation

← back to recent threads