ReadMe.md #2

Crontab Files

This folder contains crontab files and templates. Crontab define a schedule for automated activities that are executed with the 'crond' scheduler system.

Documentation on the 'crond' scheduler can be found with: man cron

File Naming Convention

Files here in /p4/common/etc/cron.d should be named like so: crontab.$USER.$(HOSTNAME -s) (or this, which is equivalent: crontab.$(id -n -u).${HOSTNAME%%.*}).

That is, crontab.operating_system_user_id.short_hostname

Sample: crontab.perforce.bos-helix-01

Versioning

If you are using the 'Tight Ship' style management of the Helix Management System (HMS), the suggested naming convention above is required.

For more information on HMS, see Helix Management System.

Crontab Files
===

This folder contains _crontab_ files and templates.  Crontab define a schedule for automated activities that are executed with the 'crond' scheduler system.

Documentation on the 'crond' scheduler can be found with:  `man cron`

File Naming Convention
---

Files here in /p4/common/etc/cron.d should be named like so: `crontab.$USER.$(HOSTNAME -s)` (or this, which is equivalent: `crontab.$(id -n -u).${HOSTNAME%%.*}`).

That is, crontab.*operating_system_user_id*.*short_hostname*

Sample: crontab.perforce.bos-helix-01

Versioning
---

If you are using the 'Tight Ship' style management of the Helix Management System (HMS), the suggested naming convention above is required.

For more information on HMS, see [Helix Management System](https://swarm.workshop.perforce.com/projects/perforce_software-hms).
# Change User Description Committed
#2 27722 C. Thomas Tyler Refinements to @27712:
* Resolved one out-of-date file (verify_sdp.sh).
* Added missing adoc file for which HTML file had a change (WorkflowEnforcementTriggers.adoc).
* Updated revdate/revnumber in *.adoc files.
* Additional content updates in Server/Unix/p4/common/etc/cron.d/ReadMe.md.
* Bumped version numbers on scripts with Version= def'n.
* Generated HTML, PDF, and doc/gen files:
  - Most HTML and all PDF are generated using Makefiles that call an AsciiDoc utility.
  - HTML for Perl scripts is generated with pod2html.
  - doc/gen/*.man.txt files are generated with .../tools/gen_script_man_pages.sh.

#review-27712
#1 22622 C. Thomas Tyler Renamed crontab templates files to be template.* rather than *.template.

This is an 'optimize for lazy' tweak, since if we use a prefix, then
the actual crontab files named of the form crontab.$USER.${HOSTNAME%%.*}
won't have command line completion conficts with the templates.

Added a ReadMe.md file describing the suggested (and with HMS required)
naming convention for crontab files.

Added a command summary doc for the sdp_sync.sh script that manages
crontab files in a tight ship deployment.  The reference to this file
from the ReadMe.md file won't work now with this change in the dev branch,
but will work once promoted to main.