Skip to content

Commit

Permalink
version 0.6.0
Browse files Browse the repository at this point in the history
  • Loading branch information
elesiuta committed Dec 6, 2021
1 parent 9047833 commit 29d01ae
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 11 deletions.
23 changes: 13 additions & 10 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,24 +27,27 @@
## usage
- you can run picosnitch either as a standalone daemon, or with systemd
- use the same method to stop picosnitch as you used to start it
- standalone daemon
- run as standalone daemon
- start with `picosnitch start`
- stop with `picosnitch stop`
- restart with `picosnitch restart`
- systemd integration
- run with systemd
- setup with `picosnitch systemd`
- autostart on reboot with `systemctl enable picosnitch`
- start with `systemctl start picosnitch`
- stop with `systemctl stop picosnitch`
- restart with `systemctl restart picosnitch`
- view detailed status with `systemctl status picosnitch`
- view basic status with
- `picosnitch status`
- view past connections
- `picosnitch view`
- show detailed status with `systemctl status picosnitch`
- user interface for browsing past connection
- start with `picosnitch view`
- `space/enter`: filter on entry `backspace`: remove filter `h/H`: cycle through history `t/T`: cycle time range `r`: refresh view `q`: quit
- other commands
- show basic status `picosnitch status`
- show version info `picosnitch version`
- show help `picosnitch help`

## configuration
- config is stored in `~/.config/picosnitch/snitch_config.json`
- config is stored in `~/.config/picosnitch/config.json`
- restart picosnitch if it is currently running for any changes to take effect

```python
Expand All @@ -59,7 +62,7 @@
"Log commands": True, # Log command line args for each executable
"Log ignore": [], # List of process names (str) or ports (int)
# will omit connections that match any of these from the connection log (snitch.db)
# the process and executable will still be recorded in snitch_summary.json
# the process and executable will still be recorded in summary.json
"Set RLIMIT_NOFILE": None, # Set the maximum number of open file descriptors (int)
# increasing it allows more processes to be cached (typical system default is 1024)
# improving the performance and reliability of hashing processes (also caches hash)
Expand All @@ -71,7 +74,7 @@
```

## logging
- a short summary of seen processes is stored in `~/.config/picosnitch/snitch_summary.json`
- a short summary of seen processes is stored in `~/.config/picosnitch/summary.json`
- this is used for determining whether to create a notification

```python
Expand Down
2 changes: 1 addition & 1 deletion picosnitch.py
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@
import psutil

# set constants and RLIMIT_NOFILE if configured
VERSION: typing.Final[str] = "0.5.1dev"
VERSION: typing.Final[str] = "0.6.0"
PAGE_CNT: typing.Final[int] = 8
if sys.platform.startswith("linux") and os.getuid() == 0 and os.getenv("SUDO_USER") is not None:
home_dir = os.path.join("/home", os.getenv("SUDO_USER"))
Expand Down

0 comments on commit 29d01ae

Please sign in to comment.