aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 6b3f192daa9511039954809622e9f30c24b7df36 (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
# Unofficial Client for slackware.com

A minimalistic tool for interfacing with Slackware's mirrors and website from the command line.
Use at your own risk.

Note: Currently this project is pre-release and may be vulnerable to downgrade attacks.

```
slackware.com is an unofficial command line interface to Slackware's website.

The commands are:

	changelog
		 - show changes described in the Changelog since the last update
	download
		 - download the given packages
	list
		 - list Slackware mirrors
	sync
		 - update knowledge about mirror's content
	updates
		 - print all new and updated packages on mirror
```

## Examples

Download all updates:
```
slackware.com updates | xargs slackware.com download
```

Cron script to download updates and email changes to root:
```
#!/bin/sh
set -e

export QUIET=true
export SLACKWARE_MIRROR=https://mirrors.kernel.org/slackware/slackware64-15.0/
export PATH=$PATH:/usr/local/sbin

TO_UPDATE="$(slackware.com updates)"
if [ -n "$TO_UPDATE" ]; then
	slackware.com updates | xargs slackware.com download
	slackware.com changelog | mail -s "updates" root
fi
```

## Verifying integrity

The commmits to the repository will be signed by the [GPG Key](GPG-KEY.asc).

```
git commit --verify HEAD
# gpg: Signature made Fri Nov 24 11:20:19 2023 EST
# gpg:                using EDDSA key D0CFFD1075CAB8DA329975078D147EEA19EFF029
# ...
# gpg: Good signature from "Slack Coder <slackcoder@server.ky>" [ultimate]
# Primary key fingerprint: D0CF FD10 75CA B8DA 3299  7507 8D14 7EEA 19EF F029
```

## Installation

Follow Golang's standard process for installing.  It will install the command
into the location pointed to by the GOBIN environment variable or its default
value.

```
go install ./cmd/slackware.com
```