.\" Generated by kramdown-man 1.0.1
.\" https://github.com/postmodern/kramdown-man#readme
.TH ronin-db-hosts 1 "2023-02-01" Ronin DB "User Manuals"
.SH NAME
.PP
ronin\-db\-hosts \- Manages host names in the database
.SH SYNOPSIS
.PP
\fBronin\-db hosts\fR \[lB]\fIoptions\fP\[rB]
.SH DESCRIPTION
.PP
Manages host names\.
.SH OPTIONS
.TP
\fB\-\-db\fR \fINAME\fP
The database to connect to\. Defaults to \fBdefault\fR if not given\.
.TP
\fB\-\-db\-uri\fR \fIURI\fP
The explicit database URI to connect to\.
.RS
.RS
.IP \(bu 2
\fBsqlite3\fP: \fBsqlite3:relative\[sl]path\.db\fR or \fBsqlite3:\[sl]\[sl]\[sl]absolute\[sl]path\.db\fR
.IP \(bu 2
\fBmysql\fP: \fBmysql:\[sl]\[sl]user:password\[at]host\[sl]database\fR
.IP \(bu 2
\fBpostgres\fP: \fBpostgres:\[sl]\[sl]user:password\[at]host\[sl]database\fR
.RE
.RE
.TP
\fB\-\-db\-file\fR \fIPATH\fP
The sqlite3 database file to use\.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Enable verbose output\.
.TP
\fB\-\-add\fR \fIVALUE\fP
Adds the hostname to the database\.
.TP
\fB\-\-import\fR \fIFILE\fP
Imports the credentials from the given \fIFILE\fP\.
.TP
\fB\-\-delete\fR \fIVALUE\fP
Deletes a value from the database\.
.TP
\fB\-\-delete\-all\fR
Deletes every value from the database\.
.TP
\fB\-I\fR, \fB\-\-with\-ip\fR \fIIP\fP
Searches for HostNames associated with the IP address\.
.TP
\fB\-p\fR, \fB\-\-with\-port\fR \fIPORT\fP
Searches for HostNames associated with the \fIPORT\fP\.
.TP
\fB\-D\fR, \fB\-\-domain\fR \fIDOMAIN\fP
Searches for HostNames belonging to the DOMAIN (\fBco\.uk\fR)\.
.TP
\fB\-T\fR, \fB\-\-tld\fR \fITLD\fP
Searches for HostNames with the Top\-Level\-Domain (TLD) (\fBru\fR)\.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help information\.
.SH ENVIRONMENT
.TP
\fIHOME\fP
Alternate location for the user\[cq]s home directory\.
.TP
\fIXDG\[ru]CONFIG\[ru]HOME\fP
Alternate location for the \fB\[ti]\[sl]\.config\fR directory\.
.TP
\fIXDG\[ru]DATA\[ru]HOME\fP
Alternate location for the \fB\[ti]\[sl]\.local\[sl]share\fR directory\.
.SH FILES
.TP
\fB\[ti]\[sl]\.local\[sl]share\[sl]ronin\-db\[sl]database\.sqlite3\fR
The default sqlite3 database file\.
.TP
\fB\[ti]\[sl]\.config\[sl]ronin\-db\[sl]database\.yml\fR
Optional database configuration\.
.SH AUTHOR
.PP
Postmodern 
.MT postmodern\.mod3\[at]gmail\.com
.ME