diff --git a/petrified b/petrified index 1dbe26b..eeffe30 100755 --- a/petrified +++ b/petrified @@ -2,7 +2,7 @@ # ## petrified - bash client to update dynamic DNS at freedns.afraid.org ## Copyright (c) 2015 Troy Engel -## Version: 1.0.5 +## Version: 1.0.6 # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by diff --git a/petrified.1 b/petrified.1 index 0cfc0f1..d3f8b43 100644 --- a/petrified.1 +++ b/petrified.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) +.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29) .\" .\" Standard preamble: .\" ======================================================================== @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "PETRIFIED 1" -.TH PETRIFIED 1 "2015-03-08" "petrified 1.0.5" "Petrified Manual" +.TH PETRIFIED 1 "2016-01-24" "petrified 1.0.6" "Petrified Manual" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -170,6 +170,62 @@ documented and should make sense. To use a custom configuration file, the \f(CW\*(C`\-c config\*(C'\fR parameter is supported; note that using this option will not read the global or local configuration files and only use the variables from this custom file. +.SH "SYSTEMD" +.IX Header "SYSTEMD" +The provided systemd unit files are designed to use the native systemd timer +functionality in place of a cron daemon. The timer can be activated as the +system user which will use specifically the global \fI/etc/petrified.conf\fR +configuration, or as any given user which will use the \fI~/.petrifiedrc\fR +configuration. +.PP +.Vb 2 +\& system: systemctl \-\-now enable petrified.timer +\& systemctl list\-timers petrified.timer +\& +\& user: systemctl \-\-user \-\-now enable petrified.timer +\& systemctl \-\-user list\-timers petrified.timer +.Ve +.PP +A target of \f(CW\*(C`petrified.target\*(C'\fR is pre-configured if multuple interfaces are +to be configured; per standard systemd methodology the existing service unit +is first customized either at the system or user level, then all custom units +and the timer are started/enabled. +.PP +For example at the system level if two interfaces are to be used, it might +look like: +.PP +.Vb 5 +\& /etc/systemd/system/petrified\-iface1.service +\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +\& .include /usr/lib/systemd/system/petrified.service +\& [Service] +\& ExecStart=/usr/bin/petrified \-c /etc/petrified\-iface1.conf +\& +\& /etc/systemd/system/petrified\-iface2.service +\& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +\& .include /usr/lib/systemd/system/petrified.service +\& [Service] +\& ExecStart=/usr/bin/petrified \-c /etc/petrified\-iface2.conf +.Ve +.PP +Then both customized service units are enabled, as well as the timer unit: +.PP +.Vb 3 +\& systemctl \-\-now enable petrified\-iface1.service +\& systemctl \-\-now enable petrified\-iface2.service +\& systemctl \-\-now enable petrified.timer +.Ve +.PP +The per user configuration looks the same and is usually configured in the +\&\fI~/.config/systemd/user/\fR space in the home directory. The provided units +for the service contain the connection to the target pre-configured. +.IP "\fBSee also:\fR" 4 +.IX Item "See also:" + +.Sp + +.Sp + .SH "DEPENDENCIES" .IX Header "DEPENDENCIES" .Vb 7 @@ -203,9 +259,10 @@ Per-user configuration file Copyright (c) 2015 Troy Engel .PP GPLv3 \- see \s-1LICENSE\s0 for details +.SH "SUPPORT" +.IX Header "SUPPORT" +If you like this software, please consider upgrading to a Premium account +to help support the Free \s-1DNS\s0 project. All +questions and issues should be asked/reported via the Github project: .PP -.SS "\s-1SUPPORT\s0" -.IX Subsection "SUPPORT" -If you like this software, please consider upgrading to a Premium account -to help support the Free \s-1DNS\s0 project.