aboutsummaryrefslogblamecommitdiff
path: root/README.markdown
blob: be1457e7b1c36b4a021312ddf58217f00608139a (plain) (tree)
1
2
3
4
5
6
7
8
9



                                                                            
                                         
 
                

                                      
                   
 
                                                                     

                                                                               


                                                                              
 
                                                                                





                                                                       
                                                                              


                           
               

                  


                                                    

                                                                  



       
                                                                          
 
                             
                                                        
Croncrypt
=========

Wrapper to sign and encrypt `cron(8)` output and errors with PGP/MIME before
sending them to the `MAILTO` destination.

    $ crontab -l
    CRONCRYPT_KEYID=0x0A1B2C3D4E5F6G7H
    CRONCRYPT_PASSPHRASE=hibbityboo
    MAILTO=me@mynet

    0 1 * * *  croncrypt rsync /home/tom/important-file /home/backups

The main design goal is simplicity; just whack `croncrypt` in front of all your
`crontab(5)` entries, provided they don’t use pipes or `stderr`/`stdout`
redirects, in which case you should consider putting it all into a script file
anyway.

Don’t use your own GPG key for signing! I recommend you create a dedicated key
just for Croncrypt, and sign it locally with `gpg --lsign` so that your
software trusts it locally.

Installation
------------

Put the `croncrypt` binary somewhere in your `crontab`’s `PATH`, and install
the following Perl modules:

*   `Carp`
*   `IPC::Run3`
*   `Mail::GnuPG`
*   `MIME::Entity`

On Debian-derived systems, this should do the trick:

    # aptitude install perl-base perl-modules libmail-gnupg-perl \
        libmime-tools-perl libipc-run3-perl

License
-------

Copyright (c) [Tom Ryder][1]. Distributed under [Artistic License 2.0][2].

[1]: https://sanctum.geek.nz/
[2]: http://opensource.org/licenses/artistic-license-2.0