From 93bf083d699c60f1ac40297bfa6783fb0cb800d8 Mon Sep 17 00:00:00 2001 From: Arch Librarian Date: Mon, 20 Sep 2004 16:51:15 +0000 Subject: Sync Author: jgg Date: 1998-10-30 07:53:30 GMT Sync --- doc/method.sgml | 30 +++++++++++------------------- 1 file changed, 11 insertions(+), 19 deletions(-) (limited to 'doc/method.sgml') diff --git a/doc/method.sgml b/doc/method.sgml index 023bac40e..35070d919 100644 --- a/doc/method.sgml +++ b/doc/method.sgml @@ -4,7 +4,7 @@ APT Method Interface Jason Gunthorpe jgg@debian.org -$Id: method.sgml,v 1.3 1998/10/08 04:55:06 jgg Exp $ +$Id: method.sgml,v 1.4 1998/10/30 07:53:49 jgg Exp $ This document describes the interface that APT uses to the archive @@ -128,15 +128,6 @@ are opened for use by the method allowing two way communication and emergency error reporting. The FD's corrispond to the well known unix FD's, stdin, stdout and stderr. -

-The basic startup sequence depends on how the method is invoked. If any -command line arguments are passed then the method should start in -automatic mode. This facility is provided soley to make the methods -easier to test and perhaps use outside of APT. Upon startup the method -will print out a header describing its capabilities and requirements. -After that it either begins processing the command line arugments and -exits when done or waits for commands to be fed to it. -

Throught operation of the method communication is done via http style plain text. Specifically RFC-822 (like the Package file) fields @@ -175,7 +166,6 @@ status code is an informational string provided for visual debugging. 601 Configuration - Sends the configuration space 602 Authorization Credentials - Response to the 402 message 603 Media Changed - Response to the 403 message -605 Shutdown - Exit Only the 6xx series of status codes is sent TO the method. Furthermore @@ -208,6 +198,7 @@ The following is a short index of the header fields that are supported URIURI being described by the message FilenameLocation in the filesystem Last-ModifiedA time stamp in RFC1123 notation for use by IMS checks +IMS-HitThe already existing item is valid SizeSize of the file in bytes Resume-PointLocation that transfer was started MD5-HashComputed MD5 hash for the file @@ -225,6 +216,8 @@ the ones it wants. This is a yes/no value. Pre-ScanMethod can detect if archives are already available. This is a yes/no value. +PipelineThe method is capable of pipelining. +Send-ConfigSend configuration to the method. VersionVersion string for the method @@ -232,8 +225,10 @@ This is a list of which headers each status code can use 100 Capabilities -Displays the capabilities of the method. -Fields: Version, Single-Instance, Pre-Scan +Displays the capabilities of the method. Methods should set the +pipeline bit if their underlying protocol supports pipeling. The +only known method that does support pipelining is http. +Fields: Version, Single-Instance, Pre-Scan, Pipeline, Send-Config 101 Log A log message may be printed to the screen if debugging is enabled. This @@ -256,7 +251,9 @@ to specify a 201 URI Done without a URI Start which would mean no data was transfered but the file is now available. A Filename field is specified when the URI is directly available in the local pathname space. APT will either directly use that file or copy it into -another location. +another location. It is possible to return Alt-* feilds to indicate that +another possibility for the URI has been found in the local pathname space. +This is done if a decompressed version of a .gz file is found. Fields: URI, Size, Last-Modified, Filename, MD5-Hash 400 URI Failure @@ -305,11 +302,6 @@ Fields: Site, User, Password This is sent in response to a 403 Media Failure message. It indicates that the user has changed media and it is safe to proceed. Fields: Media - -605 Shutdown -APT sends this to signal the shutdown of the method. The method should -terminate immidiately. -Fields: None -- cgit v1.2.3