src.hhvn.uk > hhvn.uk-scripts > file > README

scripts that power hhvn.uk
Log | Files | Refs | README

README (1695B)


      1 These are the scripts that power the server at hhvn.uk
      2 
      3 Make*.rc:
      4 	These scripts automatically populate/depopulate a bin/ directory,
      5 	essentially managing the existence of any scripts from this repo in $PATH
      6 
      7 dkim:
      8 	These scripts are resposible for Domain Key management.
      9 	- lscert:         lists existing DKIM keypais
     10 	- mkcert:         generates new DKIM keypairs
     11 	- rmcert:         removes a DKIM keypair
     12 	- purge:          automatically removes old DKIM keypairs
     13 	- reconfig-dns:   adds a DKIM keypair to a DNS zone file
     14 	- reconfig-smtpd: reconfigures the smtpd.conf filters to use a DKIM keypair
     15 	- update:         automatically calls other scripts to generate, purge, and reconfig
     16 
     17 dns/zone:
     18 	These scripts make DNS zone editing simpler
     19 	- edit:   attempts to find a zone and calls $EDITOR
     20 	- reload: attempts to find, and reload a zone, but checking it over first
     21 
     22 tls:
     23 	These scripts make acme-client easier to access
     24 	- edit: calls $EDITOR on acme-client.conf
     25 	- run:  guesses domain and runs acme-client
     26 
     27 www/chroot:
     28 	These scripts manage / exist in the /var/www chroot
     29 	- mkchroot:    copies binaries + libraries to /var/www
     30 	- git-wrapper: wraps around git for CGI access
     31 
     32 www/generate/src:
     33 	These scripts generate content in /var/www/htdocs/src.hhvn.uk
     34 	- gomod:             generates go.mod glue code
     35 	- stagit:            calls stagit
     36 	- stagit-breadcrumb: rewrites all stagit files to use www/generate/breadcrumb
     37 
     38 repo:
     39 	These scrips manage /var/git
     40 	- mkrepo:  initializes a new repository and returns `git origin` commands
     41 	- mkhooks: intalls hooks into all repos in /var/git
     42 
     43 repo/hooks:
     44 	These scripts are installed by repo/mkhooks
     45 	- post-receive: calls www/generate/src/*