Changeset b05ea0b for general

Timestamp:

01/27/2019 12:01:48 AM (5 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 8.4, 9.0, 9.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

4cc77fbd

Parents:

0eb97ef1

Message:

Update the rust page providing instructions installing in /opt.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@21042 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• general/prog/rust.xml (modified) (6 diffs)

general/prog/rust.xml

@@ -64 +64 @@
       packages in this book which use it (and they will be downloaded as
       required). But if you retain an older version as a fallback option and
-      then use it (that would require <emphasis>not</emphasis> building in
+      then use it (when <emphasis>not</emphasis> building in
       <filename class="directory">/usr</filename>), it is likely that it will
-      then have to re download some crates. For a full download (i.e. starting
+      then have to re-download some crates. For a full download (i.e. starting
       with an empty or missing <filename class="directory">~/.cargo</filename>)
       downloading the external cargo files for this version only takes a minute
@@ -80 +80 @@
         installation before updating. You may wish to do the same to save space.
       </para>
+
+      <para>
+        One alternative when working with multiple versions or just updating
+        to a new version is to place the files in the 
+        <filename class="directory">/opt</filename> directory.  The instructions
+        below provide optional commands to support better control of
+        new package versions or reinstallation of the current version.
+      </para>
     </note>
 
@@ -97 +105 @@
         Rustc defaults to building for ALL supported architectures, using a
         shipped copy of LLVM. In BLFS the build is only for the X86 architecture.
-        If you
-        intend to develop rust crates, this build may not be good enough for your
-        purposes.
+        If you intend to develop rust crates, this build may not be good 
+        enough for your purposes.
       </para>
       <para>
@@ -181 +188 @@
 
     <para>
-      First create a suitable <filename>config.toml</filename> file which will
+      If you are going to install into the
+      <filename class="directory">/opt</filename> directory, remove
+      conflicting entries and recreate the required entries. 
+      As the <systemitem class="username">root</systemitem> 
+      user:
+    </para>
+
+<screen role="root"><userinput>rm -rf /opt/rustc /opt/rustc-&rust-version; &amp;&amp;
+mkdir /opt/rustc-&rust-version;             &amp;&amp;
+ln -sv rustc-&rust-version; /opt/rustc</userinput></screen>
+
+    <note>
+      <para>
+        If multiple versions of <application>Rust</application> are installed
+        in <filename class="directory">/opt</filename>, changing to another
+        version only requires changing the <filename> /opt/rustc</filename>
+        symbolic link and then running <command>ldconfig</command>.
+      </para>
+    </note>
+
+    <para>
+      Create a suitable <filename>config.toml</filename> file which will
       configure the build. Unlike with previous releases, where even quite old
       system versions of <application>LLVM</application>worked well, this
@@ -209 +237 @@
 
 [install]
-prefix = "/usr"
+# Adjust the prefix for the desired destination
+#prefix = "/usr"
+prefix = "/opt/rustc-&rust-version;"
+
 # docdir is used even if the full awesome docs are not installed
 docdir = "share/doc/rustc-&rust-version;"
@@ -389 +420 @@
 
   </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring Rust</title>
+
+    <sect3 id="rustc-config">
+      <title>Configuration Information</title>
+
+      <para>
+        If you installed <application>rustc</application> in
+        <filename class="directory">/opt</filename>, you need to update the
+        following configuration files so that <application>rustc</application> is
+        correctly found by other packages and system processes.
+      </para>
+
+      <para>
+        As the <systemitem class="username">root</systemitem> user, update
+        the <filename>/etc/ld.so.conf</filename> file and the dynamic linker's
+        run-time cache file:
+      </para>
+
+<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; EOF
+<literal># Begin rustc addition
+
+/opt/rustc/lib
+
+# End rustc addition</literal>
+EOF
+
+ldconfig</userinput></screen>
+
+      <indexterm zone="rustc rustc-config">
+        <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
+      </indexterm>
+
+      <para>
+        As the <systemitem class="username">root</systemitem> user, create
+        the <filename>/etc/profile.d/rustc.sh</filename> file:
+      </para>
+
+<screen role="root"><userinput>cat &gt; /etc/profile.d/rustc.sh &lt;&lt; "EOF"
+<literal># Begin /etc/profile.d/rustc.sh
+
+pathprepend /opt/rustc/bin           PATH
+
+# End /etc/profile.d/rustc.sh</literal>
+EOF</userinput></screen>
+
+      <para>Immediately after installation, update the current PATH 
+      for your current shell as a normal user:</para>
+
+<screen><userinput>source /etc/profile.d/rustc.sh</userinput></screen>
+
+    </sect3>
+  </sect2>
+
 
   <sect2 role="content">