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
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.p4c-bos-01
If you are using the 'Tight Ship' style management of the Helm Management System (HMS), the suggested naming convention above is required.
For more information on HMS, see Helm 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.p4c-bos-01
Versioning
---
If you are using the 'Tight Ship' style management of the Helm Management System (HMS), the suggested naming convention above is required.
For more information on HMS, see [Helm Management System](EDITME-UpdateThisURL).
| # | Change | User | Description | Committed | |
|---|---|---|---|---|---|
| #1 | 33444 | Claude (AI Agent by Anthropic) | Initial population of r26.1.0.BETA from main. | ||
| //p4-sdp/main/Server/Unix/p4/common/etc/cron.d/ReadMe.md | |||||
| #1 | 33433 | Claude (AI Agent by Anthropic) |
Copy Up from //p4-sdp/dev into //p4-sdp/main. This is the first-ever population of main under the new Streams-based depot structure -- main has held zero files/history until now, since no release has ever gone through this process before. 463 files, covering the entire 2026.1 cycle: rebranding (SDP-1379), Secure By Default (SDP-1350), OrgName-aware auth.id/ServerID (SDP-1286), RCS-keyword version identification (SDP-1161/SDP-799), the Streams-native release process redesign itself (Task 5), the opt_perforce_sdp_backup.sh false-error fix, the P4D 2026.1 test-suite targeting, refreshed P4*.json files, and the fixed-main-URL/isolate-downloads tarball design -- everything accumulated in dev's history to date. Isolated paths (ai_dev_support/, Version, doc/*.html, doc/*.pdf, doc/gen/*.man.txt, doc/gen/sdp_install.cfg, Unsupported/doc/*.html, Unsupported/doc/*.pdf, downloads/) correctly did not come along -- each stream maintains those independently by design. Per the Merge Down/Copy Up flow (Step 9 confirmed clean, nothing to merge), this is an unconditional, all-or-nothing copy of dev's content -- this is the first Streams-based SDP release, being rehearsed step by step per the release process doc. Agent: Claude Code, Model: Claude Sonnet 5 (claude-sonnet-5), operating as bot_Claude_Anthropic. |
||
| //p4-sdp/dev/Server/Unix/p4/common/etc/cron.d/ReadMe.md | |||||
| #2 | 33409 | Claude (AI Agent by Anthropic) |
Copy Up from //p4-sdp/dev_rebrand into //p4-sdp/dev. This is the first promotion of dev_rebrand's work into dev since dev_rebrand was created (2025-05-24) -- 303 files, covering the entire 2026.1 rebranding effort (SDP-1379), the Secure By Default adaptation (SDP-1350), OrgName-aware auth.id/ServerID (SDP-1286), RCS-keyword version identification (SDP-1161/SDP-799), and the Streams-native release process redesign (Task 5) done this session, plus everything else accumulated in dev_rebrand's history before this session. Per the Merge Down/Copy Up flow, this is intentionally a full, unconditional blast-replace of dev's content from dev_rebrand -- all selectivity/care happened in the preceding Merge Down (dev -> dev_rebrand, changes 33407-33408), which absorbed Robert Cowham's independent dev-side work first so nothing of his is lost by this Copy Up. Two files are worth calling out since they might look alarming in isolation: - tools/mdcu.sh is deleted -- intentional, retired this session in favor of the two direct Streams commands now documented in doc/ReleaseProcessOverview.md. - tools/ReleaseProcessOverview.md is deleted -- this is a stale relic of a file move dev_rebrand made back in 2025-05-24 (tools/ -> doc/) that was never previously propagated to dev; the current, fully-rewritten doc/ReleaseProcessOverview.md is added/updated correctly by this same changelist. |
||
| #1 | 31397 | C. Thomas Tyler | Populate -b SDP_Classic_to_Streams -s //guest/perforce_software/sdp/...@31368. | ||
| //guest/perforce_software/sdp/dev/Server/Unix/p4/common/etc/cron.d/ReadMe.md | |||||
| #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. |
||