Made sure there was a comment for every function

stable
Justin Reichardt 2022-01-26 21:22:54 -06:00
parent fbb39ff8e3
commit 6715716701
1 changed files with 12 additions and 1 deletions

View File

@ -18,7 +18,7 @@
*/ */
// rhosts - Program used to maintain a blocklist within a hostfile // rhosts - Program used to maintain a blocklist appended to a host file
package main package main
import ( import (
@ -85,6 +85,7 @@ func main() {
} }
} }
// sysdetect determines which OS it is running on and set the default locations
func sysdetect (tmpdir, hostsloc, cfgloc *string) { func sysdetect (tmpdir, hostsloc, cfgloc *string) {
// Detect OS and set params // Detect OS and set params
switch runtime.GOOS { switch runtime.GOOS {
@ -103,6 +104,7 @@ func sysdetect (tmpdir, hostsloc, cfgloc *string) {
} }
} }
// cfgparse recieves the location of the config file and returns a list of sites to add and content to download
func cfgparse (cfgloc string) ([]string, []string, error){ func cfgparse (cfgloc string) ([]string, []string, error){
var err error=nil var err error=nil
var downloads []string var downloads []string
@ -132,6 +134,8 @@ func cfgparse (cfgloc string) ([]string, []string, error){
} }
return sites, downloads, err return sites, downloads, err
} }
// cfgparseline reads a single line of the config and returns the type and content of the line
func cfgparseline(buf string) (uint8, string){ func cfgparseline(buf string) (uint8, string){
// State options // State options
// 0 - Init // 0 - Init
@ -180,6 +184,7 @@ func cfgparseline(buf string) (uint8, string){
return state, body return state, body
} }
// copystatichosts copies the hosts not managed by rhosts from the hosts file to the start of the temporary file
func copystatichosts(tmpdir, hostsloc string) error { func copystatichosts(tmpdir, hostsloc string) error {
fileloc := tmpdir + "rhosts" fileloc := tmpdir + "rhosts"
file, err := os.Create(fileloc) file, err := os.Create(fileloc)
@ -212,6 +217,7 @@ func copystatichosts(tmpdir, hostsloc string) error {
return err return err
} }
// downloadcontent attempts to download the provided url to the temp file. If the file fails to download it attempts to find an old copy from the hosts file.
func downloadcontent(downloads []string, tmpdir string, hostsloc string) error{ func downloadcontent(downloads []string, tmpdir string, hostsloc string) error{
var err error=nil var err error=nil
fileloc := tmpdir + "rhosts" fileloc := tmpdir + "rhosts"
@ -251,6 +257,7 @@ func downloadcontent(downloads []string, tmpdir string, hostsloc string) error{
return err return err
} }
// downloadoldlookup attemps to find an entry in the hosts file and write it to the temp file.
func downloadoldlookup(file *os.File, hostsloc, d string) error { func downloadoldlookup(file *os.File, hostsloc, d string) error {
var err error = nil var err error = nil
var state uint8 = 0 var state uint8 = 0
@ -290,6 +297,8 @@ func downloadoldlookup(file *os.File, hostsloc, d string) error {
return err return err
} }
// writesites writes the list of sites from the config file to the temp file
func writesites(sites []string, tmpdir string) error { func writesites(sites []string, tmpdir string) error {
var err error = nil var err error = nil
fileloc := tmpdir + "rhosts" fileloc := tmpdir + "rhosts"
@ -314,6 +323,8 @@ func writesites(sites []string, tmpdir string) error {
} }
return err return err
} }
// writetmp2hosts overwrites the hostsfile with the tmp file
func writetmp2hosts(hostsloc, tmpdir string) error { func writetmp2hosts(hostsloc, tmpdir string) error {
var err error = nil var err error = nil
tmploc := tmpdir + "rhosts" tmploc := tmpdir + "rhosts"