Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify CNID local state dir in documentation #401

Closed
rdmark opened this issue Aug 22, 2023 · 2 comments
Closed

Clarify CNID local state dir in documentation #401

rdmark opened this issue Aug 22, 2023 · 2 comments
Assignees

Comments

@rdmark
Copy link
Member

rdmark commented Aug 22, 2023

The local state dir for CNID can be configurable and the default may vary between distros. This is to update the documentation to make this clearer.

@rdmark
Copy link
Member Author

rdmark commented Aug 22, 2023

This is a local patch used downstream in Debian. I want to take a slightly different approach and clarify in configuration.xml that the default location can be configured, while leading upgrade.xml as-is (already clarified.)

Description: Fix use FHS-compatible state dir /var/lib/netatalk
Author: Jonas Smedegaard <dr@jones.dk>
Forwarded: no
Last-Update: 2019-02-15
---
This patch header follows DEP-3: http://dep.debian.net/deps/dep3/
--- a/doc/manual/configuration.xml
+++ b/doc/manual/configuration.xml
@@ -173,7 +173,7 @@
       database storing ID &lt;-&gt; name mappings.</para>

       <para>The CNID Databases are by default located in
-      <filename>/var/netatalk/CNID</filename>.</para>
+      <filename>/var/lib/netatalk/CNID</filename>.</para>

       <para>There is a command line utility called <command>dbd</command>
       available which can be used to verify, repair and rebuild the CNID
@@ -1614,9 +1614,9 @@
       <para>If the .tracker_profile file does not exist, create it first. If you need to make the environment variables persistent, source .tracker_profile from /root/.profile. Adjust PREFIX to point to the base directory Netatalk is installed to.<screen>$ su
 # cat .tracker_profile
 PREFIX="/usr/local"
-export XDG_DATA_HOME="$PREFIX/var/netatalk/"
-export XDG_CACHE_HOME="$PREFIX/var/netatalk/"
-export DBUS_SESSION_BUS_ADDRESS="unix:path=$PREFIX/var/netatalk/spotlight.ipc"
+export XDG_DATA_HOME="$PREFIX/var/lib/netatalk/"
+export XDG_CACHE_HOME="$PREFIX/var/lib/netatalk/"
+export DBUS_SESSION_BUS_ADDRESS="unix:path=$PREFIX/var/lib/netatalk/spotlight.ipc"
 # . .tracker_profile
 #
 </screen></para>
--- a/doc/manual/upgrade.xml
+++ b/doc/manual/upgrade.xml
@@ -137,8 +137,8 @@

           <listitem>
             <para>The CNID databases are now stored under
-              <filename>/var/netatalk/CNID/</filename>
-              by default. You can use configure --localstatedir=PATH at
+              <filename>/var/lib/netatalk/CNID/</filename>
+              on Debian systems. You can use configure --localstatedir=PATH at
               compile time to change the location.</para>
           </listitem>

@@ -183,8 +183,8 @@

         <listitem>
           <para>Move <filename>afp_voluuid.conf</filename> and
-          <filename>afp_signature.conf</filename> to the localstate directory (default
-          <filename>/var/netatalk/</filename>), you can use <command>afpd -v</command>
+          <filename>afp_signature.conf</filename> to the localstate directory (Debian uses
+          <filename>/var/lib/netatalk/</filename>), you can use <command>afpd -v</command>
           in order to find the correct path</para>
         </listitem>

@rdmark
Copy link
Member Author

rdmark commented Oct 9, 2024

Fixed in #403

@rdmark rdmark self-assigned this Oct 9, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
No open projects
Status: Done
Development

No branches or pull requests

1 participant