ronin-db 0.1.2-java → 0.2.0.rc1-java

Sign up to get free protection for your applications and to get access to all the features.
Files changed (104) hide show
  1. checksums.yaml +4 -4
  2. data/.github/workflows/ruby.yml +3 -2
  3. data/.gitignore +1 -0
  4. data/ChangeLog.md +33 -0
  5. data/Gemfile +6 -4
  6. data/README.md +17 -5
  7. data/Rakefile +13 -35
  8. data/data/completions/ronin-db +271 -0
  9. data/gemspec.yml +17 -2
  10. data/lib/ronin/db/cli/command.rb +1 -1
  11. data/lib/ronin/db/cli/commands/add.rb +1 -1
  12. data/lib/ronin/db/cli/commands/asn.rb +12 -2
  13. data/lib/ronin/db/cli/commands/certs.rb +322 -0
  14. data/lib/ronin/db/cli/commands/completion.rb +63 -0
  15. data/lib/ronin/db/cli/commands/creds.rb +2 -1
  16. data/lib/ronin/db/cli/commands/edit.rb +1 -1
  17. data/lib/ronin/db/cli/commands/emails.rb +22 -1
  18. data/lib/ronin/db/cli/commands/hosts.rb +2 -1
  19. data/lib/ronin/db/cli/commands/ips.rb +2 -1
  20. data/lib/ronin/db/cli/commands/irb.rb +8 -4
  21. data/lib/ronin/db/cli/commands/list.rb +1 -1
  22. data/lib/ronin/db/cli/commands/migrate.rb +12 -8
  23. data/lib/ronin/db/cli/commands/open_ports.rb +102 -0
  24. data/lib/ronin/db/cli/commands/oses.rb +95 -0
  25. data/lib/ronin/db/cli/commands/passwords.rb +83 -0
  26. data/lib/ronin/db/cli/commands/people.rb +185 -0
  27. data/lib/ronin/db/cli/commands/phone_numbers.rb +136 -0
  28. data/lib/ronin/db/cli/commands/ports.rb +103 -0
  29. data/lib/ronin/db/cli/commands/remove.rb +1 -1
  30. data/lib/ronin/db/cli/commands/services.rb +102 -0
  31. data/lib/ronin/db/cli/commands/software.rb +95 -0
  32. data/lib/ronin/db/cli/commands/street_addresses.rb +129 -0
  33. data/lib/ronin/db/cli/commands/urls.rb +2 -1
  34. data/lib/ronin/db/cli/commands/web_vulns.rb +235 -0
  35. data/lib/ronin/db/cli/database_options.rb +87 -0
  36. data/lib/ronin/db/cli/deletable.rb +85 -0
  37. data/lib/ronin/db/cli/importable.rb +108 -0
  38. data/lib/ronin/db/cli/model_command.rb +8 -6
  39. data/lib/ronin/db/cli/modifiable.rb +12 -104
  40. data/lib/ronin/db/cli/printing.rb +58 -0
  41. data/lib/ronin/db/cli/ruby_shell.rb +1 -1
  42. data/lib/ronin/db/cli/uri_methods.rb +1 -1
  43. data/lib/ronin/db/cli.rb +3 -1
  44. data/lib/ronin/db/config_file.rb +13 -8
  45. data/lib/ronin/db/exceptions.rb +10 -1
  46. data/lib/ronin/db/home.rb +1 -1
  47. data/lib/ronin/db/root.rb +1 -1
  48. data/lib/ronin/db/tasks.rb +87 -0
  49. data/lib/ronin/db/version.rb +2 -2
  50. data/lib/ronin/db.rb +24 -7
  51. data/man/ronin-db-add.1 +48 -70
  52. data/man/ronin-db-add.1.md +26 -22
  53. data/man/ronin-db-asn.1 +37 -55
  54. data/man/ronin-db-asn.1.md +29 -19
  55. data/man/ronin-db-certs.1 +108 -0
  56. data/man/ronin-db-certs.1.md +106 -0
  57. data/man/ronin-db-completion.1 +76 -0
  58. data/man/ronin-db-completion.1.md +78 -0
  59. data/man/ronin-db-creds.1 +29 -47
  60. data/man/ronin-db-creds.1.md +23 -16
  61. data/man/ronin-db-edit.1 +16 -27
  62. data/man/ronin-db-edit.1.md +11 -7
  63. data/man/ronin-db-emails.1 +37 -50
  64. data/man/ronin-db-emails.1.md +30 -17
  65. data/man/ronin-db-hosts.1 +32 -52
  66. data/man/ronin-db-hosts.1.md +25 -18
  67. data/man/ronin-db-ips.1 +32 -53
  68. data/man/ronin-db-ips.1.md +26 -19
  69. data/man/ronin-db-irb.1 +23 -36
  70. data/man/ronin-db-irb.1.md +17 -10
  71. data/man/ronin-db-list.1 +17 -31
  72. data/man/ronin-db-list.1.md +13 -9
  73. data/man/ronin-db-migrate.1 +23 -36
  74. data/man/ronin-db-migrate.1.md +17 -10
  75. data/man/ronin-db-open-ports.1 +72 -0
  76. data/man/ronin-db-open-ports.1.md +70 -0
  77. data/man/ronin-db-oses.1 +72 -0
  78. data/man/ronin-db-oses.1.md +70 -0
  79. data/man/ronin-db-passwords.1 +75 -0
  80. data/man/ronin-db-passwords.1.md +73 -0
  81. data/man/ronin-db-people.1 +96 -0
  82. data/man/ronin-db-people.1.md +94 -0
  83. data/man/ronin-db-phone-numbers.1 +93 -0
  84. data/man/ronin-db-phone-numbers.1.md +91 -0
  85. data/man/ronin-db-ports.1 +87 -0
  86. data/man/ronin-db-ports.1.md +85 -0
  87. data/man/ronin-db-remove.1 +16 -29
  88. data/man/ronin-db-remove.1.md +12 -8
  89. data/man/ronin-db-services.1 +84 -0
  90. data/man/ronin-db-services.1.md +82 -0
  91. data/man/ronin-db-software.1 +72 -0
  92. data/man/ronin-db-software.1.md +70 -0
  93. data/man/ronin-db-street-addresses.1 +81 -0
  94. data/man/ronin-db-street-addresses.1.md +79 -0
  95. data/man/ronin-db-urls.1 +38 -61
  96. data/man/ronin-db-urls.1.md +28 -21
  97. data/man/ronin-db-web-vulns.1 +87 -0
  98. data/man/ronin-db-web-vulns.1.md +85 -0
  99. data/man/ronin-db.1 +118 -0
  100. data/man/ronin-db.1.md +99 -0
  101. data/scripts/setup +58 -0
  102. metadata +70 -13
  103. data/lib/ronin/db/cli/database_command.rb +0 -71
  104. data/lib/ronin/db/cli/resources_command.rb +0 -118
@@ -1,5 +1,9 @@
1
1
  # ronin-db-add 1 "2023-02-01" Ronin DB "User Manuals"
2
2
 
3
+ ## NAME
4
+
5
+ ronin-db-add - Adds a pre-existing database to ronin-db
6
+
3
7
  ## SYNOPSIS
4
8
 
5
9
  `ronin-db add` [*options*] *NAME* [*URI*]
@@ -12,79 +16,79 @@ configuration file.
12
16
  ## ARGUMENTS
13
17
 
14
18
  *NAME*
15
- The name of the database to add.
19
+ : The name of the database to add.
16
20
 
17
21
  *URI*
18
- The optional URI to the database to add.
22
+ : The optional URI to the database to add.
19
23
 
20
24
  ## OPTIONS
21
25
 
22
26
  `-A`, `--adapter` `sqlite3|mysql2|postgres|...`
23
- The adapter of the database to add.
27
+ : The adapter of the database to add.
24
28
 
25
29
  `--sqlite3` *FILE*
26
- Alias for `--adapter sqlite3 --database` *FILE*.
30
+ : Alias for `--adapter sqlite3 --database` *FILE*.
27
31
 
28
32
  `--mysql2`
29
- Alias for `--adapter mysql2`.
33
+ : Alias for `--adapter mysql2`.
30
34
 
31
35
  `--postgresql`
32
- Alias for `--adapter postgresql`.
36
+ : Alias for `--adapter postgresql`.
33
37
 
34
38
  `-H`, `--host` *HOST*
35
- The host of the database to add.
39
+ : The host of the database to add.
36
40
 
37
41
  `-p`, `--port` *PORT*
38
- The port of the database to add.
42
+ : The port of the database to add.
39
43
 
40
44
  `-u`, `--username` *USER*
41
- The username to authenticate with for the database.
45
+ : The username to authenticate with for the database.
42
46
 
43
47
  `-P`, `--password` *PASSWORD*
44
- The password to authenticate with for the database.
48
+ : The password to authenticate with for the database.
45
49
 
46
50
  `--read-password`
47
- Reads the database password from STDIN.
51
+ : Reads the database password from STDIN.
48
52
 
49
53
  `-D`, `--database` *NAME*|*PATH*
50
- The database name to connect to. If `--adapter sqlite3` is given then a path
54
+ : The database name to connect to. If `--adapter sqlite3` is given then a path
51
55
  may be given instead.
52
56
 
53
57
  `-h`, `--help`
54
- Print help information.
58
+ : Print help information.
55
59
 
56
60
  ## EXAMPLES
57
61
 
58
62
  Add a sqlite3 database file:
59
63
 
60
- $ ronin-db add other_db --sqlite3 path/to/db.sqlite3
64
+ $ ronin-db add other_db --sqlite3 path/to/db.sqlite3
61
65
 
62
66
  Add a PostgeSQL database:
63
67
 
64
- $ ronin-db add other_db --postgres --host example.com --port 5432 --username ronin --password s3r3t --database ronin_db
68
+ $ ronin-db add other_db --postgres --host example.com --port 5432 --username ronin --password s3r3t --database ronin_db
65
69
 
66
70
  Add a MySQL database:
67
71
 
68
- $ ronin-db add other_db --mysql2 --host example.com --port 3306 --username ronin --password s3r3t --database ronin_db
72
+ $ ronin-db add other_db --mysql2 --host example.com --port 3306 --username ronin --password s3r3t --database ronin_db
69
73
 
70
74
  ## ENVIRONMENT
71
75
 
72
76
  *HOME*
73
- Alternate location for the user's home directory.
77
+ : Alternate location for the user's home directory.
74
78
 
75
79
  *XDG_CONFIG_HOME*
76
- Alternate location for the `~/.config` directory.
80
+ : Alternate location for the `~/.config` directory.
77
81
 
78
82
  *XDG_DATA_HOME*
79
- Alternate location for the `~/.local/share` directory.
83
+ : Alternate location for the `~/.local/share` directory.
80
84
 
81
85
  ## FILES
82
86
 
83
87
  `~/.local/share/ronin-db/database.sqlite3`
84
- The default sqlite3 database file.
88
+ : The default sqlite3 database file.
85
89
 
86
90
  `~/.config/ronin-db/database.yml`
87
- Optional database configuration.
91
+ : Optional database configuration.
88
92
 
89
93
  ## AUTHOR
90
94
 
@@ -92,4 +96,4 @@ Postmodern <postmodern.mod3@gmail.com>
92
96
 
93
97
  ## SEE ALSO
94
98
 
95
- ronin-db(1) ronin-db-list(1) ronin-db-edit(1) ronin-db-remove(1)
99
+ [ronin-db](ronin-db.1.md) [ronin-db-list](ronin-db-list.1.md) [ronin-db-edit](ronin-db-edit.1.md) [ronin-db-remove](ronin-db-remove.1.md)
data/man/ronin-db-asn.1 CHANGED
@@ -1,111 +1,93 @@
1
- .\" Generated by kramdown-man 0.1.8
1
+ .\" Generated by kramdown-man 1.0.1
2
2
  .\" https://github.com/postmodern/kramdown-man#readme
3
- .TH ronin-db-asn 1 "2023-02-01" Ronin "User Manuals"
4
- .LP
3
+ .TH ronin-db-asn 1 "2023-02-01" Ronin DB "User Manuals"
4
+ .SH NAME
5
+ .PP
6
+ ronin\-db\-asn \- Queries and updates ASNs
5
7
  .SH SYNOPSIS
6
- .LP
7
- .HP
8
- \fBronin-db asn\fR \[lB]\fIoptions\fP\[rB]
9
- .LP
8
+ .PP
9
+ \fBronin\-db asn\fR \[lB]\fIoptions\fP\[rB]
10
10
  .SH DESCRIPTION
11
- .LP
12
11
  .PP
13
12
  Queries or updates Autonomous System Numbers (ASNs) in the database\.
14
- .LP
15
13
  .SH OPTIONS
16
- .LP
17
14
  .TP
18
- \fB--db\fR \fINAME\fP
15
+ \fB\-\-db\fR \fINAME\fP
19
16
  The database name to connect to\. Defaults to \fBdefault\fR if not given\.
20
- .LP
21
17
  .TP
22
- \fB--db-uri\fR \fIURI\fP
18
+ \fB\-\-db\-uri\fR \fIURI\fP
23
19
  The explicit database URI to connect to\.
24
- .LP
20
+ .RS
25
21
  .RS
26
22
  .IP \(bu 2
27
- \fBsqlite3\fP: \fBsqlite3:relative/path.db\fR or \fBsqlite3:///absolute/path.db\fR
23
+ \fBsqlite3\fP: \fBsqlite3:relative\[sl]path\.db\fR or \fBsqlite3:\[sl]\[sl]\[sl]absolute\[sl]path\.db\fR
28
24
  .IP \(bu 2
29
- \fBmysql\fP: \fBmysql://user:password@host/database\fR
25
+ \fBmysql\fP: \fBmysql:\[sl]\[sl]user:password\[at]host\[sl]database\fR
30
26
  .IP \(bu 2
31
- \fBpostgres\fP: \fBpostgres://user:password@host/database\fR
27
+ \fBpostgres\fP: \fBpostgres:\[sl]\[sl]user:password\[at]host\[sl]database\fR
32
28
  .RE
33
- .LP
29
+ .RE
30
+ .TP
31
+ \fB\-\-db\-file\fR \fIPATH\fP
32
+ The sqlite3 database file to use\.
34
33
  .TP
35
- \fB-v\fR, \fB--verbose\fR
34
+ \fB\-v\fR, \fB\-\-verbose\fR
36
35
  Enables verbose output
37
- .LP
38
36
  .TP
39
- \fB-n\fR, \fB--number\fR \fIINT\fP
37
+ \fB\-n\fR, \fB\-\-number\fR \fIINT\fP
40
38
  Searches for all ASN records with the AS number\.
41
- .LP
42
39
  .TP
43
- \fB-C\fR, \fB--country-code\fR \fIXX\fP\[or]\fBNone\fR\[or]\fBUnknown\fR
40
+ \fB\-C\fR, \fB\-\-country\-code\fR \fIXX\fP\[or]\fBNone\fR\[or]\fBUnknown\fR
44
41
  Searches for all ASN records with the country code\.
45
- .LP
46
42
  .TP
47
- \fB-N\fR, \fB--name\fR \fINAME\fP
43
+ \fB\-N\fR, \fB\-\-name\fR \fINAME\fP
48
44
  Searches for all ASN records with the matching name\.
49
- .LP
50
45
  .TP
51
- \fB-I\fR, \fB--ip\fR \fIIP\fP
46
+ \fB\-\-named\fR \fINAME\fP
47
+ Searches for all ASN records containing the name\.
48
+ .TP
49
+ \fB\-I\fR, \fB\-\-ip\fR \fIIP\fP
52
50
  Queries the ASN record for the IP\.
53
- .LP
54
51
  .TP
55
- \fB-4\fR, \fB--ipv4\fR
52
+ \fB\-4\fR, \fB\-\-ipv4\fR
56
53
  Filter ASN records for only IPv4 ranges\.
57
- .LP
58
54
  .TP
59
- \fB-6\fR, \fB--ipv6\fR
55
+ \fB\-6\fR, \fB\-\-ipv6\fR
60
56
  Filter ASN records for only IPv6 ranges\.
61
- .LP
62
57
  .TP
63
- \fB-u\fR, \fB--update\fR
58
+ \fB\-u\fR, \fB\-\-update\fR
64
59
  Updates the ASN records\.
65
- .LP
66
60
  .TP
67
- \fB-U\fR, \fB--url\fR \fIURI\fP
61
+ \fB\-U\fR, \fB\-\-url\fR \fIURI\fP
68
62
  Overrides the default ASN list URL\.
69
- Defaults to \fBhttps://iptoasn.com/data/ip2asn-combined.tsv.gz\fR if not given\.
70
- .LP
63
+ Defaults to \fBhttps:\[sl]\[sl]iptoasn\.com\[sl]data\[sl]ip2asn\-combined\.tsv\.gz\fR if not given\.
71
64
  .TP
72
- \fB-f\fR, \fB--file\fR \fIFILE\fP
65
+ \fB\-f\fR, \fB\-\-file\fR \fIFILE\fP
73
66
  Overrides the default ASN list file\.
74
- Defaults to \fB~/.local/share/ronin/ronin-support/ip2asn-combined.tsv.gz\fR
67
+ Defaults to \fB\[ti]\[sl]\.local\[sl]share\[sl]ronin\[sl]ronin\-support\[sl]ip2asn\-combined\.tsv\.gz\fR
75
68
  if not given\.
76
- .LP
77
69
  .TP
78
- \fB-h\fR, \fB--help\fR
70
+ \fB\-h\fR, \fB\-\-help\fR
79
71
  Print help information\.
80
- .LP
81
72
  .SH ENVIRONMENT
82
- .LP
83
73
  .TP
84
74
  \fIHOME\fP
85
75
  Alternate location for the user\[cq]s home directory\.
86
- .LP
87
76
  .TP
88
77
  \fIXDG\[ru]CONFIG\[ru]HOME\fP
89
- Alternate location for the \fB~/.config\fR directory\.
90
- .LP
78
+ Alternate location for the \fB\[ti]\[sl]\.config\fR directory\.
91
79
  .TP
92
80
  \fIXDG\[ru]DATA\[ru]HOME\fP
93
- Alternate location for the \fB~/.local/share\fR directory\.
94
- .LP
81
+ Alternate location for the \fB\[ti]\[sl]\.local\[sl]share\fR directory\.
95
82
  .SH FILES
96
- .LP
97
83
  .TP
98
- \fB~/.local/share/ronin-db/database.sqlite3\fR
84
+ \fB\[ti]\[sl]\.local\[sl]share\[sl]ronin\-db\[sl]database\.sqlite3\fR
99
85
  The default sqlite3 database file\.
100
- .LP
101
86
  .TP
102
- \fB~/.config/ronin-db/database.yml\fR
87
+ \fB\[ti]\[sl]\.config\[sl]ronin\-db\[sl]database\.yml\fR
103
88
  Optional database configuration\.
104
- .LP
105
89
  .SH AUTHOR
106
- .LP
107
90
  .PP
108
91
  Postmodern
109
92
  .MT postmodern\.mod3\[at]gmail\.com
110
93
  .ME
111
- .LP
@@ -1,4 +1,8 @@
1
- # ronin-db-asn 1 "2023-02-01" Ronin "User Manuals"
1
+ # ronin-db-asn 1 "2023-02-01" Ronin DB "User Manuals"
2
+
3
+ ## NAME
4
+
5
+ ronin-db-asn - Queries and updates ASNs
2
6
 
3
7
  ## SYNOPSIS
4
8
 
@@ -11,69 +15,75 @@ Queries or updates Autonomous System Numbers (ASNs) in the database.
11
15
  ## OPTIONS
12
16
 
13
17
  `--db` *NAME*
14
- The database name to connect to. Defaults to `default` if not given.
18
+ : The database name to connect to. Defaults to `default` if not given.
15
19
 
16
20
  `--db-uri` *URI*
17
- The explicit database URI to connect to.
21
+ : The explicit database URI to connect to.
18
22
 
19
23
  * **sqlite3**: `sqlite3:relative/path.db` or `sqlite3:///absolute/path.db`
20
24
  * **mysql**: `mysql://user:password@host/database`
21
25
  * **postgres**: `postgres://user:password@host/database`
22
26
 
27
+ `--db-file` *PATH*
28
+ : The sqlite3 database file to use.
29
+
23
30
  `-v`, `--verbose`
24
- Enables verbose output
31
+ : Enables verbose output
25
32
 
26
33
  `-n`, `--number` *INT*
27
- Searches for all ASN records with the AS number.
34
+ : Searches for all ASN records with the AS number.
28
35
 
29
36
  `-C`, `--country-code` *XX*\|`None`\|`Unknown`
30
- Searches for all ASN records with the country code.
37
+ : Searches for all ASN records with the country code.
31
38
 
32
39
  `-N`, `--name` *NAME*
33
- Searches for all ASN records with the matching name.
40
+ : Searches for all ASN records with the matching name.
41
+
42
+ `--named` *NAME*
43
+ : Searches for all ASN records containing the name.
34
44
 
35
45
  `-I`, `--ip` *IP*
36
- Queries the ASN record for the IP.
46
+ : Queries the ASN record for the IP.
37
47
 
38
48
  `-4`, `--ipv4`
39
- Filter ASN records for only IPv4 ranges.
49
+ : Filter ASN records for only IPv4 ranges.
40
50
 
41
51
  `-6`, `--ipv6`
42
- Filter ASN records for only IPv6 ranges.
52
+ : Filter ASN records for only IPv6 ranges.
43
53
 
44
54
  `-u`, `--update`
45
- Updates the ASN records.
55
+ : Updates the ASN records.
46
56
 
47
57
  `-U`, `--url` *URI*
48
- Overrides the default ASN list URL.
58
+ : Overrides the default ASN list URL.
49
59
  Defaults to `https://iptoasn.com/data/ip2asn-combined.tsv.gz` if not given.
50
60
 
51
61
  `-f`, `--file` *FILE*
52
- Overrides the default ASN list file.
62
+ : Overrides the default ASN list file.
53
63
  Defaults to `~/.local/share/ronin/ronin-support/ip2asn-combined.tsv.gz`
54
64
  if not given.
55
65
 
56
66
  `-h`, `--help`
57
- Print help information.
67
+ : Print help information.
58
68
 
59
69
  ## ENVIRONMENT
60
70
 
61
71
  *HOME*
62
- Alternate location for the user's home directory.
72
+ : Alternate location for the user's home directory.
63
73
 
64
74
  *XDG_CONFIG_HOME*
65
- Alternate location for the `~/.config` directory.
75
+ : Alternate location for the `~/.config` directory.
66
76
 
67
77
  *XDG_DATA_HOME*
68
- Alternate location for the `~/.local/share` directory.
78
+ : Alternate location for the `~/.local/share` directory.
69
79
 
70
80
  ## FILES
71
81
 
72
82
  `~/.local/share/ronin-db/database.sqlite3`
73
- The default sqlite3 database file.
83
+ : The default sqlite3 database file.
74
84
 
75
85
  `~/.config/ronin-db/database.yml`
76
- Optional database configuration.
86
+ : Optional database configuration.
77
87
 
78
88
  ## AUTHOR
79
89
 
@@ -0,0 +1,108 @@
1
+ .\" Generated by kramdown-man 1.0.1
2
+ .\" https://github.com/postmodern/kramdown-man#readme
3
+ .TH ronin-db-certs 1 "2023-02-01" Ronin DB "User Manuals"
4
+ .SH NAME
5
+ .PP
6
+ ronin\-db\-certs \- Queries or imports SSL\[sl]TLS certificates
7
+ .SH SYNOPSIS
8
+ .PP
9
+ \fBronin\-db certs\fR \[lB]\fIoptions\fP\[rB]
10
+ .SH DESCRIPTION
11
+ .PP
12
+ Queries or imports SSL\[sl]TLS certificates into the database\.
13
+ .SH OPTIONS
14
+ .TP
15
+ \fB\-\-db\fR \fINAME\fP
16
+ The database name to connect to\. Defaults to \fBdefault\fR if not given\.
17
+ .TP
18
+ \fB\-\-db\-uri\fR \fIURI\fP
19
+ The explicit database URI to connect to\.
20
+ .RS
21
+ .RS
22
+ .IP \(bu 2
23
+ \fBsqlite3\fP: \fBsqlite3:relative\[sl]path\.db\fR or \fBsqlite3:\[sl]\[sl]\[sl]absolute\[sl]path\.db\fR
24
+ .IP \(bu 2
25
+ \fBmysql\fP: \fBmysql:\[sl]\[sl]user:password\[at]host\[sl]database\fR
26
+ .IP \(bu 2
27
+ \fBpostgres\fP: \fBpostgres:\[sl]\[sl]user:password\[at]host\[sl]database\fR
28
+ .RE
29
+ .RE
30
+ .TP
31
+ \fB\-\-db\-file\fR \fIPATH\fP
32
+ The sqlite3 database file to use\.
33
+ .TP
34
+ \fB\-v\fR, \fB\-\-verbose\fR
35
+ Enables verbose output
36
+ .TP
37
+ \fB\-A\fR, \fB\-\-active\fR
38
+ Searches for all Certs that are still valid\.
39
+ .TP
40
+ \fB\-E\fR, \fB\-\-expired\fR
41
+ Searches for all Certs that are expired\.
42
+ .TP
43
+ \fB\-\-issuer\-common\-name\fR \fINAME\fP
44
+ Searches for all Certs with the Issuer Common Name (CN)\.
45
+ .TP
46
+ \fB\-\-issuer\-organization\fR \fINAME\fP
47
+ Searches for all Certs with the Issuer Organization (O)\.
48
+ .TP
49
+ \fB\-\-issuer\-organizational\-unit\fR \fINAME\fP
50
+ Searches for all Certs with the Issuer Organizational Unit (OU)\.
51
+ .TP
52
+ \fB\-\-issuer\-locality\fR \fILOCALITY\fP
53
+ Searches for all Certs with the Issuer Locality (L)\.
54
+ .TP
55
+ \fB\-\-issuer\-state\fR \fISTATE\fP
56
+ Searches for all Certs with the Issuer State (ST)\.
57
+ .TP
58
+ \fB\-\-issuer\-country\fR \fICOUNTRY\fP
59
+ Searches for all Certs with the Issuer Country (C)\.
60
+ .TP
61
+ \fB\-\-common\-name\fR \fIHOST\fP
62
+ Searches for all Certs with the Subject Common Name (CN)\.
63
+ .TP
64
+ \fB\-\-subject\-alt\-name\fR \fIHOST\fP
65
+ Searches for all Certs with the Subject Alternative Name (SAN)\.
66
+ .TP
67
+ \fB\-\-organization\fR \fINAME\fP
68
+ Searches for all Certs with the Subject Organization (O)\.
69
+ .TP
70
+ \fB\-\-organizational\-unit\fR \fINAME\fP
71
+ Searches for all Certs with the Subject Organizational Unit (OU)\.
72
+ .TP
73
+ \fB\-\-locality\fR \fILOCALITY\fP
74
+ Searches for all Certs with the Subject Locality (L)\.
75
+ .TP
76
+ \fB\-\-state\fR \fISTATE\fP
77
+ Searches for all Certs with the Subject State (ST)\.
78
+ .TP
79
+ \fB\-\-country\fR \fICOUNTRY\fP
80
+ Searches for all Certs with the Subject Country (C)\.
81
+ .TP
82
+ \fB\-\-import\fR \fIFILE\fP
83
+ Imports a SSL\[sl]TLS certificate from a PEM encoded file\.
84
+ .TP
85
+ \fB\-h\fR, \fB\-\-help\fR
86
+ Print help information\.
87
+ .SH ENVIRONMENT
88
+ .TP
89
+ \fIHOME\fP
90
+ Alternate location for the user\[cq]s home directory\.
91
+ .TP
92
+ \fIXDG\[ru]CONFIG\[ru]HOME\fP
93
+ Alternate location for the \fB\[ti]\[sl]\.config\fR directory\.
94
+ .TP
95
+ \fIXDG\[ru]DATA\[ru]HOME\fP
96
+ Alternate location for the \fB\[ti]\[sl]\.local\[sl]share\fR directory\.
97
+ .SH FILES
98
+ .TP
99
+ \fB\[ti]\[sl]\.local\[sl]share\[sl]ronin\-db\[sl]database\.sqlite3\fR
100
+ The default sqlite3 database file\.
101
+ .TP
102
+ \fB\[ti]\[sl]\.config\[sl]ronin\-db\[sl]database\.yml\fR
103
+ Optional database configuration\.
104
+ .SH AUTHOR
105
+ .PP
106
+ Postmodern
107
+ .MT postmodern\.mod3\[at]gmail\.com
108
+ .ME
@@ -0,0 +1,106 @@
1
+ # ronin-db-certs 1 "2023-02-01" Ronin DB "User Manuals"
2
+
3
+ ## NAME
4
+
5
+ ronin-db-certs - Queries or imports SSL/TLS certificates
6
+
7
+ ## SYNOPSIS
8
+
9
+ `ronin-db certs` [*options*]
10
+
11
+ ## DESCRIPTION
12
+
13
+ Queries or imports SSL/TLS certificates into the database.
14
+
15
+ ## OPTIONS
16
+
17
+ `--db` *NAME*
18
+ : The database name to connect to. Defaults to `default` if not given.
19
+
20
+ `--db-uri` *URI*
21
+ : The explicit database URI to connect to.
22
+
23
+ * **sqlite3**: `sqlite3:relative/path.db` or `sqlite3:///absolute/path.db`
24
+ * **mysql**: `mysql://user:password@host/database`
25
+ * **postgres**: `postgres://user:password@host/database`
26
+
27
+ `--db-file` *PATH*
28
+ : The sqlite3 database file to use.
29
+
30
+ `-v`, `--verbose`
31
+ : Enables verbose output
32
+
33
+ `-A`, `--active`
34
+ : Searches for all Certs that are still valid.
35
+
36
+ `-E`, `--expired`
37
+ : Searches for all Certs that are expired.
38
+
39
+ `--issuer-common-name` *NAME*
40
+ : Searches for all Certs with the Issuer Common Name (CN).
41
+
42
+ `--issuer-organization` *NAME*
43
+ : Searches for all Certs with the Issuer Organization (O).
44
+
45
+ `--issuer-organizational-unit` *NAME*
46
+ : Searches for all Certs with the Issuer Organizational Unit (OU).
47
+
48
+ `--issuer-locality` *LOCALITY*
49
+ : Searches for all Certs with the Issuer Locality (L).
50
+
51
+ `--issuer-state` *STATE*
52
+ : Searches for all Certs with the Issuer State (ST).
53
+
54
+ `--issuer-country` *COUNTRY*
55
+ : Searches for all Certs with the Issuer Country (C).
56
+
57
+ `--common-name` *HOST*
58
+ : Searches for all Certs with the Subject Common Name (CN).
59
+
60
+ `--subject-alt-name` *HOST*
61
+ : Searches for all Certs with the Subject Alternative Name (SAN).
62
+
63
+ `--organization` *NAME*
64
+ : Searches for all Certs with the Subject Organization (O).
65
+
66
+ `--organizational-unit` *NAME*
67
+ : Searches for all Certs with the Subject Organizational Unit (OU).
68
+
69
+ `--locality` *LOCALITY*
70
+ : Searches for all Certs with the Subject Locality (L).
71
+
72
+ `--state` *STATE*
73
+ : Searches for all Certs with the Subject State (ST).
74
+
75
+ `--country` *COUNTRY*
76
+ : Searches for all Certs with the Subject Country (C).
77
+
78
+ `--import` *FILE*
79
+ : Imports a SSL/TLS certificate from a PEM encoded file.
80
+
81
+ `-h`, `--help`
82
+ : Print help information.
83
+
84
+ ## ENVIRONMENT
85
+
86
+ *HOME*
87
+ : Alternate location for the user's home directory.
88
+
89
+ *XDG_CONFIG_HOME*
90
+ : Alternate location for the `~/.config` directory.
91
+
92
+ *XDG_DATA_HOME*
93
+ : Alternate location for the `~/.local/share` directory.
94
+
95
+ ## FILES
96
+
97
+ `~/.local/share/ronin-db/database.sqlite3`
98
+ : The default sqlite3 database file.
99
+
100
+ `~/.config/ronin-db/database.yml`
101
+ : Optional database configuration.
102
+
103
+ ## AUTHOR
104
+
105
+ Postmodern <postmodern.mod3@gmail.com>
106
+
@@ -0,0 +1,76 @@
1
+ .\" Generated by kramdown-man 1.0.1
2
+ .\" https://github.com/postmodern/kramdown-man#readme
3
+ .TH ronin-db-completion 1 "2024-01-01" Ronin DB "User Manuals"
4
+ .SH NAME
5
+ .PP
6
+ ronin\-db\-completion \- Manages shell completion rules for \fBronin\-db\fR
7
+ .SH SYNOPSIS
8
+ .PP
9
+ \fBronin\-db completion\fR \[lB]\fIoptions\fP\[rB]
10
+ .SH DESCRIPTION
11
+ .PP
12
+ The \fBronin\-db completion\fR command can print, install, or uninstall shell
13
+ completion rules for the \fBronin\-db\fR command\.
14
+ .PP
15
+ Supports installing completion rules for Bash or Zsh shells\.
16
+ Completion rules for the Fish shell is currently not supported\.
17
+ .SS ZSH SUPPORT
18
+ .PP
19
+ Zsh users will have to add the following lines to their \fB\[ti]\[sl]\.zshrc\fR file in
20
+ order to enable Zsh\[cq]s Bash completion compatibility layer:
21
+ .PP
22
+ .RS 4
23
+ .EX
24
+ autoload \-Uz \[pl]X compinit && compinit
25
+ autoload \-Uz \[pl]X bashcompinit && bashcompinit
26
+ .EE
27
+ .RE
28
+ .SH OPTIONS
29
+ .TP
30
+ \fB\-\-print\fR
31
+ Prints the shell completion file\.
32
+ .TP
33
+ \fB\-\-install\fR
34
+ Installs the shell completion file\.
35
+ .TP
36
+ \fB\-\-uninstall\fR
37
+ Uninstalls the shell completion file\.
38
+ .TP
39
+ \fB\-h\fR, \fB\-\-help\fR
40
+ Prints help information\.
41
+ .SH ENVIRONMENT
42
+ .TP
43
+ \fIPREFIX\fP
44
+ Specifies the root prefix for the file system\.
45
+ .TP
46
+ \fIHOME\fP
47
+ Specifies the home directory of the user\. Ronin will search for the
48
+ \fB\[ti]\[sl]\.cache\[sl]ronin\-db\fR cache directory within the home directory\.
49
+ .TP
50
+ \fIXDG\[ru]DATA\[ru]HOME\fP
51
+ Specifies the data directory to use\. Defaults to \fB\[Do]HOME\[sl]\.local\[sl]share\fR\.
52
+ .SH FILES
53
+ .TP
54
+ \fB\[ti]\[sl]\.local\[sl]share\[sl]bash\-completion\[sl]completions\[sl]\fR
55
+ The user\-local installation directory for Bash completion files\.
56
+ .TP
57
+ \fB\[sl]usr\[sl]local\[sl]share\[sl]bash\-completion\[sl]completions\[sl]\fR
58
+ The system\-wide installation directory for Bash completions files\.
59
+ .TP
60
+ \fB\[sl]usr\[sl]local\[sl]share\[sl]zsh\[sl]site\-functions\[sl]\fR
61
+ The installation directory for Zsh completion files\.
62
+ .SH EXAMPLES
63
+ .TP
64
+ \fBronin\-db completion \-\-print\fR
65
+ Prints the shell completion rules instead of installing them\.
66
+ .TP
67
+ \fBronin\-db completion \-\-install\fR
68
+ Installs the shell completion rules for \fBronin\-db\fR\.
69
+ .TP
70
+ \fBronin\-db completion \-\-uninstall\fR
71
+ Uninstalls the shell completion rules for \fBronin\-db\fR\.
72
+ .SH AUTHOR
73
+ .PP
74
+ Postmodern
75
+ .MT postmodern\.mod3\[at]gmail\.com
76
+ .ME