en/tcron/index.html

   1 <!doctype html>
   2 <html>
   3   <head>
   4     <meta charset="utf-8">
   5     <meta name="viewport" content="width=device-width, initial-scale=1" />
   6     <link rel="canonical" href="https://jamesfengcao.gitlab.io/uweb/en/tcron/" />
   7
   8     <link rel="stylesheet" href="../style.css#" type="text/css" />
   9     <title>cron</title>
  10     <script>
  11       function findLang(){
  12         let href = location.href;
  13         for(let i=href.length-1;i>0;i--){
  14           if('/'==href.charAt(i) && '/'==href.charAt(i-3))
  15             return i;
  16         }
  17         return 0;
  18       }
  19       function nav2(page){
  20         let i = findLang();
  21         location.href = location.href.substring(0,i+1)+page;
  22       }
  23       function nav2Lang(lang){
  24         let i = findLang();
  25         let href = location.href;
  26         location.href = location.href.substring(0,i-2)+lang+location.href.substring(i);
  27       }
  28     </script>
  29   </head>
  30   <body>
  31     <header class='header'>
  32       <a class="logo" href="javascript:void(0)" onclick="return nav2('index.html#')">Home</a> <a class="logo" href="javascript:void(0)" onclick="return nav2('tags/index.html#')">Tags</a>
  33
  34
  35           <a class="logo" href="javascript:void(0)" onclick="return nav2Lang('zh')">简体中文</a>
  36
  37
  38       <nav>
  39       </nav>
  40     </header>
  41     <br />
  42
  43 <div class="container">
  44   <h1 class="title">cron
  45     <br>
  46     <span class="subtitle"></span>
  47   </h1>
  48   <ul class="tags">
  49
  50   </ul>
  51   <h4 id="crontab-with-enhanced-semantics">crontab (with enhanced semantics)</h4>
  52 <p>Some battery restrictions on android 13+ may disallow new instance of uweb browser by alarm events. Users can either keep uweb instance (no battery consumption) or remove the restriction for uweb.</p>
  53 <p>For performance, the file &quot;crontab&quot; uses single space as field separator. Letters are not suppored currently. So use &quot;1&quot; for &quot;January&quot; and 2 for &quot;Tuesday&quot; etc.</p>
  54 <p>The sixth field in crontab file could be in the format of <a href="../links/index.html#">internal links</a>. Specifically,  &quot;c:&quot; to execute the following commands in termux and &quot;!&quot; to execute commands directly. If the sixth field is not in any of above formats, then the field will appear as the message of alarm clock.</p>
  55 <p>To make crontab more powerful, we changed the semantics as follows:<br>
  56 The day of a command's execution can be specified by two fields — day of month, and day of week. The command will be run when <span style="color:red">both</span> fields matche the current time.</p>
  57 <p>Note (the original crantab semantics):<br>
  58 The day of a command's execution can be specified by two fields — day of month, and day of week. If both fields are restricted (i.e., aren't *), the command will be run when either field matches the current time. For example, &quot;30 4 1,15 * 5&quot; would cause a command to be run at 4:30 am on the 1st and 15th of each month, plus every Friday.</p>
  59 <h5 id="make-crontab-persist-after-os-rebooting">make crontab persist after OS rebooting</h5>
  60 <p>If uweb browser was launched at least once after rebooting, the crontab jobs are scheduled as normal.</p>
  61 <p>To keep crontab take effect without launching uweb browser once:</p>
  62 <ul>
  63 <li>Install the &quot;com.termux.boot&quot; and &quot;com.termux&quot; Apps.</li>
  64 <li>Create an executable file in termux under the folder &quot;~/.termux/boot/&quot; containing the two lines:<br>
  65 #!/data/data/com.termux/files/usr/bin/sh<br>
  66 am broadcast -n info.torapp.uweb/.AlarmReceiver --es uweb.line &quot;&quot;</li>
  67 <li>Launch &quot;com.termux.boot&quot; once.</li>
  68 </ul>
  69 <h4 id="tcron">tcron</h4>
  70 <p>With the option &quot;custom file handling&quot; enabled, &quot;default.rc&quot; runs as shell script at uweb launching time and &quot;default.rc2&quot; runs whenever uweb becomes foreground.</p>
  71 <p>Use tcron (<a href="i:0bhttps://fastly.jsdelivr.net/gh/torappinfo/uwebjs/bin/tcron.tgz">Click to install</a>) with &quot;default.rc&quot; or &quot;default.rc2&quot;.</p>
  72 <p>usage: tcron logfile command hours [timezone delay_sec elsecommand]<br>
  73 execute &quot;command&quot; during time interval once.<br>
  74 where logfile modification time must be updated if &quot;command&quot; runs successfully.</p>
  75 <p>hours: If positive, then each day is divided into multiple intervals (unit: hour), and in each interval, the &quot;command&quot; runs only once.<br>
  76 If  negative, then the unit is minute.<br>
  77 hours could be also in &quot;hh:mm-hh:mm,...&quot; format. Ex. &quot;6:00-8:30,11:00-13:00,5:30-6:30&quot;.<br>
  78 timezone: an integer, default to be &quot;8&quot; for Beijing China (UTC+8). &quot;0&quot; for Greenwich UK (UTC+0).<br>
  79 delay_sec: execute &quot;command&quot; after &quot;delay_sec&quot; seconds.<br>
  80 elsecommand: executed whenever &quot;command&quot; not run.</p>
  81 <p>ex:<br>
  82 set PATH=/system/bin:/data/data/info.torapp.uweb/files/bin<br>
  83 #Empty the folder &quot;baidu&quot; every 30 days.<br>
  84 tcron /sdcard/b &quot;rm -rf /sdcard/baidu/*;toybox touch /sdcard/b&quot; 720</p>
  85 <p><a target="_self" href="i:0hdefault.rc:../searchurl/txt/default.rc">Install example default.rc file for termux</a></p>
  86
  87 </div>
  88 <p>Last Modified: 27 August 2024<br>
  89 update ebrowserreadme.md<br>
  90 <pre></pre>
  91 </p>
  92
  93 <script id='jsgiscus'
  94   src='https://giscus.app/client.js'
  95   data-repo="torappinfo/uweb"
  96   data-repo-id="MDEwOlJlcG9zaXRvcnkzMDIyMDU3MjE="
  97   data-category="Announcements"
  98   data-category-id="DIC_kwDOEgNLGc4CQjsh"
  99   data-mapping="title"
 100   data-strict="0"
 101   data-reactions-enabled="1"
 102   data-emit-metadata="0"
 103   data-input-position="top"
 104   data-theme="light"
 105   data-lang="en"
 106   data-loading="lazy"
 107   crossorigin="anonymous" async>
 108 </script>
 109
 110     <footer class="site-footer">
 111       <div class="container">
 112         &copy; 2018-2025 Richard H. Cao
 113       </div>
 114     </footer>
 115     <!-- This document is licensed under the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is available at <https://www.gnu.org/licenses/>. -->
 116
 117
 118   </body>
 119 </html>