summaryrefslogtreecommitdiff
path: root/src/frontend/cli/README.md
blob: 0ef8b69a65f05c39d641c660661efb6157e08c71 (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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
# `sisyphus`

Sisyphus is a simple python wrapper around portage, gentoolkit, and portage-utils
which provides an apt-get/yum-alike interface to these commands,
to assist newcomer people transitioning from Debian/RedHat-based systems to Gentoo.

Use 'sisyphus COMMAND --help' for detailed usage.

**Usage**:

```console
$ sisyphus [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--install-completion`: Install completion for the current shell.
* `--show-completion`: Show completion for the current shell, to copy it or customize the installation.
* `--help`: Show this message and exit.

**Commands**:

* `autoremove`: Uninstall packages that are no longer needed.
* `branch`: Pull the selected branch of the Portage tree,...
* `install`: Install binary and/or ebuild(source)...
* `mirror`: List/Set the active binary repository mirror.
* `rescue`: Resurrect Sisyphus's package database if lost...
* `search`: Search for binary and/or ebuild (source)...
* `spmsync`: Sync Sisyphus's package database with...
* `sysinfo`: Display information about installed core...
* `uninstall`: Uninstall packages *SAFELY* by checking for...
* `update`: Update the Portage tree, the Redcore...
* `upgrade`: Upgrade the system using binary and/or ebuild...

## `sisyphus autoremove`

Uninstall packages that are no longer needed.
When you uninstall a package without it's reverse dependencies, those dependencies will become orphans if nothing else requires them.
In addition, a package may no longer depend on another one, so that other package becomes orphan as well if nothing else requires it.
Use this option to check the whole dependency chain for such packages, and uninstall them.

**Usage**:

```console
$ sisyphus autoremove [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

## `sisyphus branch`

Pull the selected branch of the Portage tree, Redcore overlay and Portage configs.
The remote can be selected by using the --remote option.

'BRANCH' can be one of the following : master, next

'REMOTE' can be one of the following : gitlab, pagure (default is pagure)

* Examples:


`    branch master --remote=gitlab   # pull the branch 'master' from gitlab.com
`

`    branch next --remote=pagure     # pull the branch 'next' from pagure.io
`


!!! WARNING !!!

Once you changed the branch, you must pair it with the correct binary repository.

Branch 'master' must be paired with the stable binary repository (odd numbers in 'sisyphus mirror list').

* Examples:

`    sisyphus mirror set 1
`

`    sisyphus mirror set 5
`

Branch 'next' must be paired with the testing binary repository (even numbers in 'sisyphus mirror list').

* Examples:

`    sisyphus mirror set 2
`

`    sisyphus mirror set 8
`


**Usage**:

```console
$ sisyphus branch [OPTIONS] [master|next]
```

**Options**:

* `-r, --remote [gitlab|pagure]`
* `--help`: Show this message and exit.

## `sisyphus install`

Install binary and/or ebuild(source) packages.
By default, only binary packages will be installed.
Use the --ebuild option to install ebuild(source) packages.

* Examples:

`    sisyphus install pidgin`

will install pidgin binary package (if available); if there is none, but the ebuild(source) package for pidgin is found, it will stop and suggest the --ebuild option.

`    sisyphus install pidgin --ebuild`

will compile pidgin from source

The --ebuild option will preffer to reuse binary packages(if available) to satisfy the dependencies for the ebuild(source) package, speeding up the installation.
You can use the --ebuild option even if you don't want to install any ebuild(source) packages; It will fall back to binary packages only.

**Usage**:

```console
$ sisyphus install [OPTIONS] PKGNAME...
```

**Options**:

* `-e, --ebuild`
* `--help`: Show this message and exit.

## `sisyphus mirror`

List/Set the active binary repository mirror.

**Usage**:

```console
$ sisyphus mirror [OPTIONS] COMMAND [ARGS]...
```

**Options**:

* `--help`: Show this message and exit.

**Commands**:

* `list`: List available binary package repository...
* `set`: Change the binary package repository to the...

### `sisyphus mirror list`

List available binary package repository mirrors (the active one is marked with *).

**Usage**:

```console
$ sisyphus mirror list [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

### `sisyphus mirror set`

Change the binary package repository to the selected mirror.

**Usage**:

```console
$ sisyphus mirror set [OPTIONS] INDEX
```

**Options**:

* `--help`: Show this message and exit.

## `sisyphus rescue`

Resurrect Sisyphus's package database if lost or corrupted.
If for some reason Sisyphus's package database is lost or corrupted, it can be resurrected using Portage's package database.
If Portage's package database is corrupted (in this case you're screwed anyway :D), only a partial resurrection will be possible.
If Portage's package database is intact, full resurrection will be possible.

**Usage**:

```console
$ sisyphus rescue [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

## `sisyphus search`

Search for binary and/or ebuild (source) packages.

By default will search for binary packages, using internal database.
The search term can be provided also in the category/name format, e.g:

    sisyphus search openbox

        OR

    sisyphus search x11-wm/openbox

Using * and ? wildcards is supported. An empty string will match everything (similar to *).

* Examples:

to search for all packages belonging to a category, use '*' or leave the name empty:

    sisyphus search x11-wm/

    sisyphus search x11-wm/*

In addition, search can be performed by package description, using the -d (--description) option:

    sisyphus search x11/open -d 'window manager'

(use single or double quotes when the description contains spaces)

Use the -f (--filter) option to select only packages of interest. Possible values:

    any (default) - search the entire database

    alien - search for installed packages but not available
    (this filter can match packages installed from e-builds or packages no longer maintained as binaries)

    installed - search in all installed packages

    remote - search for available packages but not installed

    upgrade - search for installed packages where installed version is different from available version

!!! NOTE !!!:

bash will expand a single * character as current folder listing.
To search for all matching '--filter' packages escape it, or surround it with quotes, or use an empty string:

    sisyphus search * -f installed          # this is not valid!

    sisyphus search \* -f alien             # OK

    sisyphus search '*' -f remote           # OK

    sisyphus search '' -f upgrade           # OK


To search for all (including source) packages, use the --ebuild option.
This is slower since will perform an emerge --search actually.
With this option, more than one package can be provided as search term.
'-d', '-f' and '-q' (quiet) options are ignored in this mode.

**Usage**:

```console
$ sisyphus search [OPTIONS] PACKAGE...
```

**Options**:

* `-d, --description TEXT`: Match description.
* `-f, --filter [any|alien|installed|remote|upgrade]`: [default: any]
* `-q`: Short (one line) output.
* `-e, --ebuild`: Search in ebuilds (slower).
* `--help`: Show this message and exit.

## `sisyphus spmsync`

Sync Sisyphus's package database with Portage's package database.
When you install something with Portage directly (emerge), Sisyphus is not aware of that package, and it doesn't track it in it's database.
Use this command to synchronize Sisyphus's package database with Portage's package database.

**Usage**:

```console
$ sisyphus spmsync [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

## `sisyphus sysinfo`

Display information about installed core packages and portage configuration.

**Usage**:

```console
$ sisyphus sysinfo [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

## `sisyphus uninstall`

Uninstall packages *SAFELY* by checking for reverse dependencies.
If reverse dependencies exist, the package(s) will NOT be uninstalled to prevent the possible breakage of the system.
If you really want to uninstall the package, make sure you uninstall all reverse dependencies as well.
This will not allways be possible, as the reverse dependency chain may be way to long and require you to uninstall critical system packages.

* Examples:

`   sisyphus uninstall firefox`
will succeed, nothing depends on it 

`    sisyphus uninstall pulseaudio`
will fail, many packages depend on it

With --force option, packages are uninstalled *UNSAFELY* by ignoring reverse dependencies.
This may break your system if you uninstall critical packages.
It will try the best it can to preserve the libraries required by other packages to prevent such a breakage.
Upgrading the system may pull the packages back in, to fix the reverse dependency chain.

* Examples :

`    sisyphus uninstall pulseaudio --force`
will succeed, but you may no longer have audio

`    sisyphus uninstall openrc --force`
will succeed, but the system will be broken

**Usage**:

```console
$ sisyphus uninstall [OPTIONS] PKGNAME...
```

**Options**:

* `-f, --force`
* `--help`: Show this message and exit.

## `sisyphus update`

Update the Portage tree, the Redcore Overlay(s), Portage configs and Sisyphus's package database.

**Usage**:

```console
$ sisyphus update [OPTIONS]
```

**Options**:

* `--help`: Show this message and exit.

## `sisyphus upgrade`

Upgrade the system using binary and/or ebuild (source) packages.
By default, only binary packages will be upgraded.
However, if you installed any ebuild(source) packages with the '--ebuild' option, it would make sense to upgrade them too.
Use the --ebuild option to upgrade **EVERYTHING**, binary and/or ebuild(source) packages.

* Examples:

`    sisyphus upgrade`

will upgrade the system using binary packages; if any ebuild(source) package upgrade is detected, it will stop and suggest the --ebuild option

`    sisyphus upgrade --ebuild`

will upgrade the system using both binary and/or ebuild(source) packages

The --ebuild option will preffer to reuse binary packages(if available) to satisfy the dependencies for the ebuild(source) packages, speeding up the upgrade.
You can use the --ebuild option even if you don't have any ebuild(source) packages installed; It will fall back to binary packages only.

**Usage**:

```console
$ sisyphus upgrade [OPTIONS]
```

**Options**:

* `-e, --ebuild`
* `--help`: Show this message and exit.