Skip to content
README.rst 2.29 KiB
Newer Older
Seblu's avatar
Seblu committed
========
MAILBOOT
========

INTRODUCTION
============

Once upon a time, a computer reboot. Again. And again. And again.

Whereas a lot of computers reboot and we don't care, few should not reboot
without notifying someone.

Seblu's avatar
Seblu committed
**MAILBOOT** is a small program (and systemd service unit) used to send an email
Seblu's avatar
Seblu committed
when a computer boot (or reboot), providing useful informations and setupable
in less than 1min.

Why do not use cron?
--------------------
I started with a cron line. But after workarounded the basic missing feature of
customizing the mail subject in my cron daemon (fcron) in using mail command,
I was borred by being able to send interesting information in one sh line.
Seblu's avatar
Seblu committed
So I decided to find another solution. Here we are.


What you cannot do with mailboot?
-----------------------------------
The coffee.


HOW TO USE IT
=============
To print the mail::

  $ mailboot -p

To send the mail::

  $ mailboot -s

To send the mail at reboot::

  $ systemctl enable mailboot.service


.. caution::
**A working mail forwarder is expected on your system.
The sendmail command must be functionnal!**


DEPENDENCIES
============
- Bash [#]_
- Systemd [#]_
Seblu's avatar
Seblu committed
- sysvinit-tools [#]_
- Sed [#]_
Seblu's avatar
Seblu committed

Seblu's avatar
Seblu committed

Seblu's avatar
Seblu committed
INSTALL
=======

Using autotools
Seblu's avatar
Seblu committed
---------------
::

  $ ./autogen.sh
  $ ./configure
Seblu's avatar
Seblu committed
  $ make install
  $ /usr/local/bin/mailboot

Seblu's avatar
Seblu committed
Using Archlinux packages
------------------------
An Archlinux package is provided with the source tree and you can create your
package with the following commands:
Seblu's avatar
Seblu committed

Seblu's avatar
Seblu committed
::
Seblu's avatar
Seblu committed

Seblu's avatar
Seblu committed
  $ ./autogen.sh
  $ ./configure
  $ make
  $ makepkg
  $ pacman -U mailboot-*-1-any.pkg.tar.xz
Seblu's avatar
Seblu committed

Seblu's avatar
Seblu committed
You can find the last version of mailboot into AUR [#]_.
Seblu's avatar
Seblu committed


RELEASES
========
Seblu's avatar
Seblu committed
You can download **MAILBOOT** release tarballs on my ftp: [#]_.
Seblu's avatar
Seblu committed
SOURCES
=======
Seblu's avatar
Seblu committed
**MAILBOOT** sources are available on github [#]_.
Seblu's avatar
Seblu committed


LICENSE
=======
Seblu's avatar
Seblu committed
**MAILBOOT** is licensied under the term of GPL v2 [#]_.
Seblu's avatar
Seblu committed


AUTHOR
======
Seblu's avatar
Seblu committed
**MAILBOOT** was started by Sébastien Luttringer in July 2013.
Seblu's avatar
Seblu committed


LINKS
=====
.. [#] http://www.gnu.org/software/bash/
.. [#] http://www.freedesktop.org/wiki/Software/systemd/
Seblu's avatar
Seblu committed
.. [#] http://savannah.nongnu.org/projects/sysvinit
.. [#] http://www.gnu.org/software/sed
.. [#] http://ftp.seblu.net/softs/mailboot/
Seblu's avatar
Seblu committed
.. [#] https://aur.archlinux.org/packages/mailboot/
.. [#] https://github.com/seblu/mailboot/
Seblu's avatar
Seblu committed
.. [#] http://www.gnu.org/licenses/gpl-2.0.html