public inbox for gentoo-commits@lists.gentoo.org
 help / color / mirror / Atom feed
From: "Michał Górny" <mgorny@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Subject: [gentoo-commits] proj/policy-guide:master commit in: /
Date: Sun, 19 Jan 2020 20:10:38 +0000 (UTC)	[thread overview]
Message-ID: <1579464593.acb2659d5d3c67579105d0b297dfda4bc92edf47.mgorny@gentoo> (raw)

commit:     acb2659d5d3c67579105d0b297dfda4bc92edf47
Author:     Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Sun Jan 19 12:39:34 2020 +0000
Commit:     Michał Górny <mgorny <AT> gentoo <DOT> org>
CommitDate: Sun Jan 19 20:09:53 2020 +0000
URL:        https://gitweb.gentoo.org/proj/policy-guide.git/commit/?id=acb2659d

filesystem: Policy against absolute symlink targets

Closes: https://bugs.gentoo.org/705830
Closes: https://github.com/gentoo/policy-guide/pull/5
Signed-off-by: Michał Górny <mgorny <AT> gentoo.org>

 filesystem.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/filesystem.rst b/filesystem.rst
index 9173042..081ab99 100644
--- a/filesystem.rst
+++ b/filesystem.rst
@@ -154,3 +154,29 @@ inconsistent with the use in other distributions where it was used to
 share data files.  Since the latter implied users must not be added
 to the games group, a new group (gamestat) needed to be created to
 fulfill that purpose.
+
+
+.. index:: symbolic link; absolute target
+
+Absolute symbolic link targets
+------------------------------
+:Source: QA
+:Reported: by repoman and pkgcheck (when ebuild-generated)
+
+Packages must not install symbolic links with absolute targets.
+Instead, relative paths must be used.  An exception is granted
+for symlinks to specially mounted filesystems (such as /proc, /run)
+when symlinks are supposed to always reference the running host system.
+
+*Example*::
+
+    # BAD:
+    dosym /usr/lib/frobnicate/frobnicate /usr/bin/frobnicate
+    # GOOD:
+    dosym ../lib/frobnicate/frobnicate /usr/bin/frobnicate
+    # ACCEPTABLE EXCEPTION:
+    dosym /proc/self/mounts /etc/mtab
+
+*Rationale*: absolute symlinks work correctly only when the root
+filesystem is mounted at /.  They point at the wrong location whenever
+it is mounted in another location, e.g. for the purposes of recovery.


             reply	other threads:[~2020-01-19 20:10 UTC|newest]

Thread overview: 42+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-01-19 20:10 Michał Górny [this message]
  -- strict thread matches above, loose matches on Subject: below --
2025-07-13  4:07 [gentoo-commits] proj/policy-guide:master commit in: / Sam James
2025-07-13  4:07 Sam James
2024-05-18 12:59 Ulrich Müller
2023-09-01 10:31 Michał Górny
2023-08-17 21:46 Ulrich Müller
2023-08-17 20:56 Ulrich Müller
2023-01-18 17:28 Ulrich Müller
2023-01-14 18:46 Sam James
2023-01-14 18:46 Sam James
2023-01-14 18:46 Sam James
2023-01-14 18:46 Sam James
2023-01-14 18:34 Ulrich Müller
2023-01-14 17:31 Ulrich Müller
2023-01-14 16:45 Ulrich Müller
2023-01-14 16:45 Ulrich Müller
2023-01-14 16:45 Ulrich Müller
2022-04-29 11:15 Ulrich Müller
2022-04-24  8:20 Ulrich Müller
2021-11-15 13:10 Ulrich Müller
2021-11-15  4:19 Sam James
2021-08-15  6:31 Michał Górny
2021-01-26 18:48 Ulrich Müller
2021-01-26 18:43 Ulrich Müller
2020-11-06 22:24 Michał Górny
2020-09-13  7:00 Michał Górny
2020-03-05  7:59 Michał Górny
2020-03-02  5:22 Michał Górny
2020-02-25 15:16 Michał Górny
2020-02-21 11:07 Michał Górny
2020-02-21 11:07 Michał Górny
2020-01-26  4:46 Michał Górny
2020-01-22  3:33 Michał Górny
2020-01-22  3:33 Michał Górny
2020-01-22  3:33 Michał Górny
2020-01-21 16:49 Michał Górny
2020-01-21 16:46 Michał Górny
2020-01-19 20:10 Michał Górny
2020-01-19 10:52 Michał Górny
2020-01-19 10:52 Michał Górny
2020-01-19 10:52 Michał Górny
2020-01-13 19:33 Michał Górny

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1579464593.acb2659d5d3c67579105d0b297dfda4bc92edf47.mgorny@gentoo \
    --to=mgorny@gentoo.org \
    --cc=gentoo-commits@lists.gentoo.org \
    --cc=gentoo-dev@lists.gentoo.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox