commands.org
... ...
@@ -440,6 +440,18 @@ In good-websites.txt, there could be:
440 440
441 441
Usage: ~pluck verdicts~
442 442
443
+** Understanding the output
444
+
445
+ The command will print many lines, each of which will have this form:
446
+
447
+ #+BEGIN_EXAMPLE
448
+ 12:50:48.320 allow 1541 chromium google.com [2607:f8b0:400a:0806:0000:0000:0000:200e]:80 rule allow
449
+ #+END_EXAMPLE
450
+
451
+ This line tells us that at ~12:50:48~ the program named ~chromium~ attempted to connect to ~google.com~, and Pluckeye allowed (~allow~) this connection.
452
+
453
+ This information can be useful when you want to allow or block a particular program, or a particular program's access to a particular website.
454
+
443 455
* version
444 456
445 457
Print the version of Pluckeye that is installed.
rules.org
... ...
@@ -8,7 +8,7 @@ title: Rules | Pluckeye
8 8
9 9
* How to add or remove a rule
10 10
11
- If you are new to Pluckeye, note that some rule changes will be subject to your [[delay]].
11
+ If you are new to Pluckeye, note that some rule changes will be subject to your [[delay]]. If you want to add a rule for a program rather than a website, see the [[#program][Program]] section below.
12 12
13 13
** Through the browser extension
14 14
... ...
@@ -62,7 +62,6 @@ title: Rules | Pluckeye
62 62
- *v0.99.12+*: To add a rule or enable a feature, use [[commands#add][the + command]]. To remove a rule or disable feature, use [[commands#minus][the - command]].
63 63
- *v0.99.11 or older*: Use the deprecated ~add~ and ~del~ commands, which behave similarly to [[commands#add][the + command]] and [[commands#minus][the - command]].
64 64
65
-
66 65
* Actions
67 66
68 67
All rules contain an action, generally ~allow~ or ~block~.
... ...
@@ -320,6 +319,10 @@ title: Rules | Pluckeye
320 319
321 320
Console usage: ~pluck [+|-] <action> program <program name | executable | directory>~
322 321
322
+*** Finding the name of a program
323
+
324
+ To add a rule for a program, you first need to know the exact name that Pluckeye uses to refer to the program. To find this, open the program, interact with it, and then run the [[commands#verdicts][verdicts command]] (~pluck verdicts~) in a [[how-to-open-a-console-window.org][console window]]. The output of the command is explained [[commands#verdicts][on the commands page]].
325
+
323 326
** Subnets
324 327
325 328
*** Examples