pkgsrc-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[pkgsrc/trunk]: pkgsrc/doc/guide/files doc/guide: document more reasons for "...

branches:  trunk
changeset: 423664:fa19028a25d9
user:      rillig <>
date:      Sun Feb 23 17:27:29 2020 +0000

doc/guide: document more reasons for "No such file or directory"


 doc/guide/files/fixes.xml |  61 ++++++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 60 insertions(+), 1 deletions(-)

diffs (75 lines):

diff -r f3958bcd4c11 -r fa19028a25d9 doc/guide/files/fixes.xml
--- a/doc/guide/files/fixes.xml Sun Feb 23 16:53:07 2020 +0000
+++ b/doc/guide/files/fixes.xml Sun Feb 23 17:27:29 2020 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.152 2020/02/23 16:52:02 rillig Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.153 2020/02/23 17:27:29 rillig Exp $ -->
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
 <title>Making your package work</title>
@@ -1456,6 +1456,65 @@
 message and the contents of your &mk.conf; file.</para>
+<sect3 id="">
+<para>Pkgsrc does not work reliably if any of
+<varname>LOCALBASE</varname>, <varname>VARBASE</varname> or
+<varname>WRKDIR</varname> contains a symlink. Since 2019Q2, the pkgsrc
+bootstrap program prevents installing pkgsrc in symlink-based
+directories. Existing pkgsrc installations are not checked for symlinks
+<para>The "No such file or directory" error messages are a typical
+symptom of symlinks, and it's quite difficult to find out that this is
+the actual cause.</para>
+<sect3 id="">
+<title>Stale working directories</title>
+<para>When building a hierarchy of packages, it may happen that one
+package is built and then pkgsrc is updated. This situation can provoke
+various hard to diagnose build errors. To clean up the situation:</para>
+&uprompt; (cd ../../ && test -f mk/ && rm -rf */*/work)
+<para>(The test for <filename></filename> just prevents running
+this command in the wrong directory.)</para>
+<para>If you have set <varname>WRKOBJDIR</varname> in &mk.conf;, remove
+that directory as well.</para>
+<sect3 id="">
+<title>Other possible reasons</title>
+<para>On platforms other than BSD, third-party packages are installed in
+<filename>/usr/include</filename>, together with the base system. This
+means that pkgsrc cannot distinguish between headers provided by the base
+system (which it needs) and headers from third-party packages (which are
+often included in pkgsrc as well). This can lead to subtle version
+<para>In pkgsrc installations that have been active for several years, it
+may happen that some files are manually deleted. To exclude this unlikely
+reason, run <command>pkg_admin check</command>.</para>
+<para>It may help to run <command>pkg_admin rebuild-tree</command> to
+check/fix dependencies.</para>
+<para>If all of the above doesn't help, see <xref linkend="help-user"/>
+for contact information. Be prepared to describe what you have tried so
+far and what any error messages were.</para>
 <sect2 id="undefined-reference">

Home | Main Index | Thread Index | Old Index