diff options
| -rw-r--r-- | sbosrcarch.txt | 65 |
1 files changed, 65 insertions, 0 deletions
diff --git a/sbosrcarch.txt b/sbosrcarch.txt new file mode 100644 index 0000000..8c29d6e --- /dev/null +++ b/sbosrcarch.txt @@ -0,0 +1,65 @@ +*** SITE ADMINS, please edit the last paragraph of this file and *** +*** REMOVE these two lines! *** + +This is an archive of the source files linked to by the .info files +on SlackBuilds.org. + +SlackBuilds.org (SBo) doesn't host the source code to the packages it +builds, only links to the sources and the build scripts themselves. +This archive is an attempt to gather all the sources together in one +(rather large) collection. It can be used interactively, or a script +can be used to access the archive automatically. + +Normally, when using an SBo build, you either manually download the files +or use a frontend like sbopkg which downloads them for you. From time +to time, this fails, due to the upstream site going out of service, +or rearranging their links, etc. When that happens, it's up to you to +find another copy of the same source tarball somewhere else on the web, +if you can. + +For interactive use: Suppose you're trying to build audio/zita-ajbridge, +and the original download site is down. You'll find the source file in +this archive, under "by-name/audio/zita-ajbridge/". + +For scripting, there's a by-md5/ directory, with subdirectories named +after the first 2 hex digits of the md5sum. If you look at the zita-ajbridge.info +file from the SlackBuild, you'll see: + + MD5SUM="9b834537b26063cc9ea6990cadeef62d" + +The first 2 digits are 9 and b, so the file you're looking for will be +found in the "by-md5/a/b/9b834537b26063cc9ea6990cadeef62d" directory. + +There is a simple client script that knows how to find files in the +archive, and a more complex one that uses this archive plus other +well-known archives and the archive.org wayback machine. + +Simple script here: + + http://urchlay.naptime.net/repos/sbostuff/plain/sbosrc + +Complex script here: + + http://urchlay.naptime.net/repos/sbostuff/plain/sbofindsrc + +As the SBo builds are upgraded for new versions, the files here will get +outdated. Once a week (or however often the archive operator decides), +this archive is updated from the .info files in the latest SBo git tree. + +This archive is incomplete, because not all sources can be automatically +downloaded. Some require registration at the upstream site, for instance. +Also, the site administrator can set a size limit, and files larger than +the limit will not be downloaded or kept in the archive... or the admin +can black packages or entire categories (e.g. some archives may not wish +to carry games). Even a partial archive can be useful, though. + +There are other SBo source archives like this one. A list of them can +be found at: + + http://urchlay.naptime.net/repos/sbostuff/plain/sbosrcarch.list + +Policy for this particular instance of the SBo source archive is: + +[ site admins, please replace this text with details of your archive: +file size limit, how often you run 'sbosrcarch update', and list any +blacklisted categories ] |