summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorArch Librarian <arch@canonical.com>2004-09-20 16:51:15 +0000
committerArch Librarian <arch@canonical.com>2004-09-20 16:51:15 +0000
commit93bf083d699c60f1ac40297bfa6783fb0cb800d8 (patch)
tree456e6c73d98b317d85cbea60728cf9e93546bbd8 /doc
parent779e5b002e216565108cdb4ad9598e1af650f004 (diff)
Sync
Author: jgg Date: 1998-10-30 07:53:30 GMT Sync
Diffstat (limited to 'doc')
-rw-r--r--doc/examples/apt.conf37
-rw-r--r--doc/method.sgml30
2 files changed, 40 insertions, 27 deletions
diff --git a/doc/examples/apt.conf b/doc/examples/apt.conf
index dc2f9cc3a..bbc3c7ea4 100644
--- a/doc/examples/apt.conf
+++ b/doc/examples/apt.conf
@@ -1,12 +1,25 @@
-// $Id: apt.conf,v 1.6 1998/10/26 07:11:51 jgg Exp $
+// $Id: apt.conf,v 1.7 1998/10/30 07:53:50 jgg Exp $
/* This file is an index of all APT configuration directives. It should
NOT actually be used as a real config file, though it is a completely
valid file.
+
+ In some instances involing filenames it is possible to set the default
+ directory when the path is evaluated. This means you can use relative
+ paths within the sub scope.
+
+ The configuration directives are specified in a tree with {} designating
+ a subscope relative to the tag before the {}. You can further specify
+ a subscope using scope notation eg,
+ APT::Architecture "i386";
+ This is prefixed with the current scope. Scope notation must be used
+ if an option is specified on the command line with -o.
*/
+// Options for APT in general
APT {
Architecture "i386";
+ // Options for apt-get
Get {
Download-Only "false";
Simulate "false";
@@ -15,17 +28,20 @@ APT {
Show-Upgraded "false";
};
+ // Some general options
Ingore-Hold "false";
};
+// Options for the downloading routines
Acquire
{
Queue-Mode "access"; // host|access
};
+// Directory layout
Dir
{
-
+ // Location of the state dir
State "/var/state/apt/"
{
lists "lists/";
@@ -34,20 +50,23 @@ Dir
status "/var/lib/dpkg/status";
};
+ // Location of the cache dir
Cache "/var/cache/apt/" {
archives "archives/";
srcpkgcache "srcpkgcache.bin";
pkgcache "pkgcache.bin";
};
+ // Config files
Etc "/etc/apt/" {
- sourcelist "sources.list.test";
+ sourcelist "sources.list";
main "apt.conf";
};
+ // Locations of binaries
Bin {
methods "/home/jgg/work/apt/build/bin/methods/";
- gzip "gzip";
+ gzip "/bin/gzip";
};
};
@@ -55,10 +74,12 @@ DSelect {
}
+/* Options you can set to see some debugging text They corrispond to names
+ of classes in the source code */
Debug {
- pkgProblemResolver "true";
+ pkgProblemResolver "false";
pkgAcquire "false";
- pkgAcquire::Worker "true";
+ pkgAcquire::Worker "false";
+
+ pkgInitialize "false"; // This one will dump the configuration space
}
-
-dir::state::lists "/tmp/lists/";
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 @@
<title>APT Method Interface </title>
<author>Jason Gunthorpe <email>jgg@debian.org</email></author>
-<version>$Id: method.sgml,v 1.3 1998/10/08 04:55:06 jgg Exp $</version>
+<version>$Id: method.sgml,v 1.4 1998/10/30 07:53:49 jgg Exp $</version>
<abstract>
This document describes the interface that APT uses to the archive
@@ -129,15 +129,6 @@ emergency error reporting. The FD's corrispond to the well known unix FD's,
stdin, stdout and stderr.
<p>
-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.
-
-<p>
Throught operation of the method communication is done via http
style plain text. Specifically RFC-822 (like the Package file) fields
are used to describe items and a numeric-like header is used to indicate
@@ -175,7 +166,6 @@ status code is an informational string provided for visual debugging.
<item>601 Configuration - Sends the configuration space
<item>602 Authorization Credentials - Response to the 402 message
<item>603 Media Changed - Response to the 403 message
-<item>605 Shutdown - Exit
</list>
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
<tag>URI<item>URI being described by the message
<tag>Filename<item>Location in the filesystem
<tag>Last-Modified<item>A time stamp in RFC1123 notation for use by IMS checks
+<tag>IMS-Hit<item>The already existing item is valid
<tag>Size<item>Size of the file in bytes
<tag>Resume-Point<item>Location that transfer was started
<tag>MD5-Hash<item>Computed MD5 hash for the file
@@ -225,6 +216,8 @@ the ones it wants.
This is a yes/no value.
<tag>Pre-Scan<item>Method can detect if archives are already available.
This is a yes/no value.
+<tag>Pipeline<item>The method is capable of pipelining.
+<tag>Send-Config<item>Send configuration to the method.
<tag>Version<item>Version string for the method
</taglist>
@@ -232,8 +225,10 @@ This is a list of which headers each status code can use
<taglist>
<tag>100 Capabilities<item>
-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
<tag>101 Log<item>
A log message may be printed to the screen if debugging is enabled. This
@@ -256,7 +251,9 @@ to specify a <em>201 URI Done</> without a <em>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
<tag>400 URI Failure<item>
@@ -305,11 +302,6 @@ Fields: Site, User, Password
This is sent in response to a <em>403 Media Failure</> message. It
indicates that the user has changed media and it is safe to proceed.
Fields: Media
-
-<tag>605 Shutdown<item>
-APT sends this to signal the shutdown of the method. The method should
-terminate immidiately.
-Fields: None
</taglist>
</sect>