X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=policy.sgml;h=0bdc891608cf1f8615ab36fbd157b8ac51fc5719;hb=6c56ff3f4978001b8d14d7d28ac26c665a8ad6ae;hp=f512315708535d5dc0691533da2f1ef7a48b8280;hpb=b6ec3caac4fc2ea5938a069b60558e140766f6c5;p=debian%2Fdebian-policy.git diff --git a/policy.sgml b/policy.sgml index f512315..0bdc891 100644 --- a/policy.sgml +++ b/policy.sgml @@ -6246,33 +6246,33 @@ install -m644 debian/shlibs.package debian/package/DEBIAN/ symlinked there, is relaxed to a recommendation.

+ +

+ The additional directory /run in the root + file system is allowed. /run + replaces /var/run, and the + subdirectory /run/lock + replaces /var/lock, with + the /var directories replaced by symlinks + for backwards compatibility. /run + and /run/lock must follow all of the + requirements in the FHS for /var/run + and /var/lock, respectively, such as file + naming conventions, file format requirements, or the + requirement that files be cleared during the boot + process. Files and directories residing + in /run should be stored on a temporary + file system. +

+

The following directories in the root filesystem are - additionally allowed: /run, - - The purpose of the /run hierarchy is storage of ephemeral - system state, that is, state information that should - not be preserved across a reboot. - Files and directories residing in /run - should be stored on a temporary filesystem. - The /run directory is a - replacement for /var/run; its - subdirectory /run/lock is a replacement for - /var/lock. - /run/ and /run/lock/ have been introduced - by most distributions and are on track to be - endorsed by the FHS. - Additionally, the subdirectory /run/shm - is a replacement for /dev/shm. - - /sys and /selinux. - - The /sys and /selinux - directories are mount points where - virtual filesystems are mounted which provide access - to kernel information. - + additionally allowed: /sys and + /selinux. These directories + are used as mount points to mount virtual filesystems + to get access to kernel information. +

@@ -6407,6 +6407,35 @@ rmdir /usr/local/share/emacs 2>/dev/null || true though the spool may still be physically located there.

+ + + /run and /run/lock + +

+ The directory /run is cleared at boot, normally + by being a mount point for a temporary file system. Packages + therefore must not assume that any files or directories + under /run other than /run/lock + exist unless the package has arranged to create those files or + directories since the last reboot. Normally, this is done by + the package via an init script. See + for more information. +

+ +

+ Packages must not include files or directories + under /run, or under the + older /var/run and /var/lock paths. + The latter paths will normally be symlinks or other + redirections to /run for backwards compatibility. +

+ +

+ Packages should use /run in preference + to /var/run and /run/lock in + preference to /var/lock. +

+ @@ -6781,17 +6810,14 @@ test -f program-executed-later-in-script || exit 0

- Files and directories under /run, including those - in directories /var/run and /var/lock - which are symlinks or bind mounts to subdirectories of - /run, are normally stored on a temporary + Files and directories under /run, including ones + referred to via the compatibility paths /var/run + and /var/lock, are normally stored on a temporary filesystem and are normally not persistent across a reboot. - Consequently, packages cannot assume that these files or - directories are present at system boot time. - Files and directories under /run must not be - included in packages; such files or directories - must be created dynamically, for example, in the - init.d script. + The init.d scripts must handle this correctly. + This will typically mean creating any required subdirectories + dynamically when the init.d script is run. + See for more information.