X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/0a8e3465cb644e380ab0fc6d66f6d1f17363b34e..c373c37a2edf384b658c8d054bdcc55464900863:/doc/files.sgml diff --git a/doc/files.sgml b/doc/files.sgml index 2d4b1eac0..2b68cf9bc 100644 --- a/doc/files.sgml +++ b/doc/files.sgml @@ -4,7 +4,7 @@ APT Files Jason Gunthorpe jgg@debian.org -$Id: files.sgml,v 1.3 1998/10/02 04:39:57 jgg Exp $ +$Id: files.sgml,v 1.7 1999/02/15 06:38:03 jgg Exp $ This document describes the complete implementation and format of the @@ -13,7 +13,7 @@ views the Debian archive. -Copyright © Jason Gunthorpe, 1998. +Copyright © Jason Gunthorpe, 1998-1999.

"APT" and this document are free software; you can redistribute them and/or modify them under the terms of the GNU General Public License as published @@ -45,6 +45,8 @@ The var directory structure is as follows: lists/ partial/ xstatus + userstatus + cdroms.list /var/cache/apt/ pkgcache.bin srcpkgcache.bin @@ -52,12 +54,15 @@ The var directory structure is as follows: partial/ /etc/apt/ sources.list - cdromdevs.list + apt.conf /usr/lib/apt/ methods/ cdrom ftp http + file + gzip + copy

@@ -80,7 +85,7 @@ support a mix of source media. The file lists one source per line, with the fastest source listed first. The format of each line is:

-type ui args +type uri args

The first item, type, indicates the format for the remainder @@ -122,17 +127,14 @@ URIs in the source list support a large number of access schemes. cdrom The cdrom scheme is special in that If Modifed Since queries are never performed and that APT knows how to match a cdrom to the name it - was given when first inserted. It does this by examining the date - and size of the package file. APT also knows all of the possible - prefix paths for the cdrom drives and that the user should be prompted + was given when first inserted. APT also knows all of the possible + mount points the cdrom drives and that the user should be prompted to insert a CD if it cannot be found. The path is relative to an arbitary mount point (of APT's choosing) and must not start with a slash. The first pathname component is the given name and is purely descriptive and of the users choice. However, if a file in the root of - the cdrom is called 'cdname' its contents will be used instead of + the cdrom is called '.disk/info' its contents will be used instead of prompting. The name serves as a tag for the cdrom and should be unique. - APT will track the CDROM's based on their tag and package file - properties. cdrom:Debian 1.3/debian @@ -140,8 +142,7 @@ URIs in the source list support a large number of access schemes. http This scheme specifies a HTTP server for the debian archive. HTTP is prefered over FTP because If Modified Since queries against the Package file are - possible. Newer HTTP protcols may even support reget which would make - http the protocol of choice. + possible as well as deep pipelining and resume capabilities. http://www.debian.org/archive @@ -259,7 +260,11 @@ No dirctory structure is transfered from the receiving site and all .deb file names conform to debian conventions. No short (msdos) filename should be placed in archives. If the need arises .debs should be unpacked, scanned and renamed to their correct internal names. This is mostly to prevent -file name conflicts but other programs may depend on this if convenient. +file name conflicts but other programs may depend on this if convenient. +A conforming .deb is one of the form, name_version_arch.deb. Our archive +scripts do not handle epochs, but they are necessary and should be re-inserted. +If necessary _'s and :'s in the fields should be quoted using the % convention. +It must be possible to extract all 3 fields by examining the file name. Downloaded .debs must be found in one of the package lists with an exact name + version match.. @@ -366,7 +371,7 @@ This is the common name we give our archives, such as stable or Component Referes to the sub-component of the archive, main, contrib -etc. +etc. Component may be omitted if there are no components for this archive. Version This is a version string with the same properties as in the Packages file.