aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: c8e62a39f62d59edb7724aa337d3b2f95d2062b2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
Copyright (C) 2003 Jason Woodward <woodwardj at jaos dot org>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Library General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.



Table of Contents:
 1. Features
 2. Requirements
 3. Installation
 4. slapt-getrc
 5. Troubleshooting
 6. Thanks and contributions



 1. Features

    slapt-get tries to emulate Debian's apt-get as closely as possible.

    * cache package data and update data from mirror site
    * multiple sources (including linuxpackage.net support)
    * show packages that are available (from cached data)
    * allow packages to be retrieved and installed by name
    * remove packages
    * allow updates to be retrieved and applied
    * uses native Slackware tools (installpkg, upgradepkg, and removepkg)
    * show description of packages
    * list installed packages
    * upgrade from one slackware release to another
    * exclude (hold) packages from upgrades
    * easy to script with
    * extremely fast
    * transaction engine
    * "compare package version" algorithm to prevent downgrades



 2. Requirements

    slapt-get requires Slackware-9.0 or better, due to glibc and openssl
    updates.

    The following packages are required to build slapt-get from source:
    make, gcc, curl, glibc, kernel-headers, binutils, zlib, and openssl



 3. Installation

    See INSTALL.



 4. slapt-getrc

    The slapt-getrc file consists currently of the following keys:
     SOURCE
     WORKINGDIR
     EXCLUDE

    Choose mirror from slackware.com mirror list:
    lynx -source http://www.slackware.com/getslack/|grep -i href \
     |awk -F "HREF=" '{print $2}'|cut -f2 -d'"'

    * SOURCE must be a path to a valid slackware release directory,
    or a source such as linuxpackages.net (see example within rc).
    Multiple sources can be defined.  Please do not add redundant
    mirror locations to the same release.  Mirror fallback is not
    yet implemented.

      NOTE: It is not recommended to mix 3rd party package sources
            with the official on production servers.  Sometimes 
            third party sources contain the same packages as the
            official mirrors. Third party packages might not be
            as rigorously tested as official packages.

    * WORKINGDIR will hold the package data and downloaded packages.
      This directory will have to be created.

    * EXCLUDE is a comma seperated list of pkgs you want excluded from
    updating.



 5. Troubleshooting

   Probably lots of bugs.  email bug reports to me:
    Jason Woodward <woodwardj at jaos dot org>

   Make sure --update is ran once initially and the downloaded files 
   (CHECKSUMS.md5, package_data) are good.

   Some mirrors are incomplete and the downloaded file is actually html
   specifying the webservers error message.  MD5 checking has been 
   incorporated in order to alleviate this problem.

   If you are getting segfaults, add -g to CFLAGS in the Makefile, change the
   DEBUG define in src/main.h to 1, and rebuild ( make clean && make ).  Run
   in gdb and let me know via email where the fault happens.

   See the FAQ for more info.

 6. Thanks and contributions

   Big thanks to Dan Barber <danb at mojolin dot com> for his insight and help
   with documentation suggestions and feature requests.

   Thanks to James Simmons over at linuxpackages.net for his interest, support,
   and ideas.