[Pkg-owncloud-commits] [owncloud-doc] 36/60: Add cron.php document Feb 19, 2014

[David Prévot]

This is an automated email from the git hooks/post-receive script.

taffit pushed a commit to branch master
in repository owncloud-doc.

commit 02f369213e50477194f22af07a933be5da36b12b
Author: Steve Robinson <ser72 at owncloud.com>
Date:   Wed Feb 19 13:28:02 2014 -0500

    Add cron.php document Feb 19, 2014
---
 admin_manual/cron/Introduction.rst |  5 +++++
 admin_manual/cron/Usage.rst        | 24 ++++++++++++++++++++++++
 admin_manual/cron/index.rst        |  7 +++++++
 3 files changed, 36 insertions(+)

diff --git a/admin_manual/cron/Introduction.rst b/admin_manual/cron/Introduction.rst
new file mode 100644
index 0000000..488ab08
--- /dev/null
+++ b/admin_manual/cron/Introduction.rst
@@ -0,0 +1,5 @@
+Introduction
+============
+
+ownCloud is written in PHP, and because PHP is a request driven language – in other words it runs only when a client takes an action and calls php, and then it executes and ends – it does not have a built in CRON process. Instead, ownCloud provides Cron.php, which is called by the server’s CRON daemon. Cron.php is an ownCloud internal process that runs various background jobs on demand.
+It is called by the server cron, and can be set by the administrator. ownCloud plug-in applications register actions with cron.php automatically to take care of typical housekeeping operations, such as garbage collecting of temporary files or checking for newly updated files using filescan() for externally mounted file systems.
diff --git a/admin_manual/cron/Usage.rst b/admin_manual/cron/Usage.rst
new file mode 100644
index 0000000..63b151d
--- /dev/null
+++ b/admin_manual/cron/Usage.rst
@@ -0,0 +1,24 @@
+Usage
+=====
+
+The interval at which this script is executed, and thus the ownCloud registered actions, can depend on the size of the installation and the load of the system.
+Recommended intervals are 15 or 30 minutes.
+
+Cron.php needs to be called by the system’s cron daemon and run as the same user the web server runs as.
+
+As an example, on an ordinary Linux distribution, place the following in the webserver’s user’s crontab:
+
+*/15
+*
+*
+*
+* /usr/bin/php -f /srv/http/owncloud/cron.php /dev/null 2>&1
+
+
+This will run cron.php every 15 minutes and suppress any warnings or output which may be generated.
+
+
+
+
+
+
diff --git a/admin_manual/cron/index.rst b/admin_manual/cron/index.rst
new file mode 100644
index 0000000..1472d8f
--- /dev/null
+++ b/admin_manual/cron/index.rst
@@ -0,0 +1,7 @@
+**ownCloud cron.php**
+
+.. toctree::
+    :maxdepth: 2
+
+    Introduction
+    Usage

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud-doc.git