File: usage.md

package info (click to toggle)
gsmartcontrol 2.0.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 5,904 kB
  • sloc: cpp: 66,205; sh: 240; ansic: 125; xml: 33; makefile: 13
file content (75 lines) | stat: -rw-r--r-- 2,264 bytes parent folder | download
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
---
title: "Usage"
permalink: /usage
---

# Usage

## Launching GSmartControl on Desktop

### Linux and Unix
On Linux and Unix systems, please use the desktop menu entry. Alternatively, you can
run `gsmartcontrol-root`, which invokes GSmartControl using your desktop's `su` mechanism.

### Windows
Simply install GSmartControl and run it from the Start menu.

### macOS
After being installed using Homebrew, GSmartControl can be run by
typing `gsmartcontrol` in Terminal. If all you get is `Command not found`, please run
a `brew doctor` command first.


## Command-Line Options

**Note:** The Windows version may not output any text to a command-line window,
so `--help` and similar options will be of no help.

The most important options are:

`-?`, `--help` - Show help options.

`-V`, `--version` - Display version information.

`--no-scan` - Don't scan devices on startup.

`--add-virtual <file>` - Load smartctl data from file, creating a virtual drive. You
can specify this option multiple times.

`--add-device <device>::<type>[::<extra_args>]` - Add a device to device list.
This option is useful with `--no-scan` to list certain drives only. You can specify
this option multiple times.
Example:  
`--add-device /dev/sda --add-device /dev/twa0::3ware,2 --add-device
'/dev/sdb::::-T permissive'`.

`-v`, `--verbose` - Enable verbose logging; same as `--verbosity-level 5`.

`-q`, `--quiet` - Disable logging; same as `--verbosity-level 0`.

`-b`, `--verbosity-level` - Set verbosity level \[0-5].


### Advanced Options

`-l`, `--no-locale` - Don't use system locale.


## Smartctl Options

GSmartControl provides the ability to specify custom options to smartctl. The
[smartctl manual page](https://www.smartmontools.org/browser/trunk/smartmontools/smartctl.8.in)
contains detailed information on these options. Additional information is available
at [smartmontools.org](https://smartmontools.org).


## Windows Installer Options

GSmartControl's Windows installer is based on NSIS and supports all its options.
Please see the [NSIS documentation](https://nsis.sourceforge.io/Docs/Chapter3.html#installerusage)
for the list of supported options.

For example, to run installer in silent mode, use `/S` option:
```
gsmartcontrol-<version>-win64.exe /S
```