AWS linux documentation change
Summary
Reorganized documentation structure, added new sections for downloading source packages and installing debuginfo packages, and clarified repository behavior
Security assessment
The changes focus on usability improvements and documentation structure without addressing security vulnerabilities or weaknesses. Modifications explain how DNF automatically handles disabled repositories for source/debug packages rather than requiring manual enabling, which improves user experience but doesn't mitigate specific security risks. No security advisories, vulnerabilities, or security features are mentioned.
Diff
diff --git a/linux/al2023/ug/configure-spal-repository.md b/linux/al2023/ug/configure-spal-repository.md index 9d5cec5f2..97ee7c8ce 100644 --- a//linux/al2023/ug/configure-spal-repository.md +++ b//linux/al2023/ug/configure-spal-repository.md @@ -7 +7 @@ -PrerequisitesChecking prerequisitesInstalling SPAL on your systemInstalling SPAL packagesUninstalling SPAL repository from your systemRelated topics +PrerequisitesChecking prerequisitesInstalling SPAL on your systemInstalling SPAL packagesDownloading SPAL source packagesInstalling SPAL debuginfo packagesUninstalling SPAL repository from your systemRelated topics @@ -24,0 +25,4 @@ The following tutorial helps you configure the SPAL repository on your AL2023 in + * Downloading SPAL source packages + + * Installing SPAL debuginfo packages + @@ -88,3 +91,0 @@ All three SPAL repositories should be available. Note that the **Amazon Linux 20 - 3. (Optional) Enable the source repository. - -###### Note @@ -92 +92,0 @@ All three SPAL repositories should be available. Note that the **Amazon Linux 20 -RPM source (SRPM) repositories are typically disabled by default because they are primarily used by developers for building packages, not by end-users for software installation. DNF automatically enables source repositories when you use commands that require source packages, such as `dnf download --source `package``. @@ -94 +93,0 @@ RPM source (SRPM) repositories are typically disabled by default because they ar -You do not need to manually enable the source repository for one-off source package operations. Follow this step only if you want to rebuild SRPMs from SPAL on your system. @@ -96 +95 @@ You do not need to manually enable the source repository for one-off source pack -To permanently enable the **Amazon Linux 2023 SPAL repository - Source packages** repository on your system, run the following command: +## Installing SPAL packages @@ -98 +97 @@ To permanently enable the **Amazon Linux 2023 SPAL repository - Source packages* - [ec2-user ~]$ sudo dnf config-manager --enable amazonlinux-spal-source + * Install SPAL packages on your system by running `dnf install` command. @@ -100 +99 @@ To permanently enable the **Amazon Linux 2023 SPAL repository - Source packages* - 4. (Optional) Enable the debuginfo repository. + [ec2-user ~]$ sudo dnf install package @@ -104,3 +103 @@ To permanently enable the **Amazon Linux 2023 SPAL repository - Source packages* -The debuginfo repository contains both debuginfo and debugsource packages. These packages provide debug symbols and source files that are useful for debugging and profiling applications. The debuginfo repository is disabled by default because these packages are primarily used by developers for troubleshooting, not by end-users for regular software installation. - -Follow this step only if you need debug symbols or source files for SPAL packages on your system. +You can use `dnf list` to see a complete list of SPAL packages. @@ -108 +105 @@ Follow this step only if you need debug symbols or source files for SPAL package -To permanently enable the **Amazon Linux 2023 SPAL repository - Debug** repository on your system, run the following command: + [ec2-user ~]$ dnf list --repo=amazonlinux-spal @@ -110 +107 @@ To permanently enable the **Amazon Linux 2023 SPAL repository - Debug** reposito - [ec2-user ~]$ sudo dnf config-manager --enable amazonlinux-spal-debuginfo +###### Note @@ -111,0 +109 @@ To permanently enable the **Amazon Linux 2023 SPAL repository - Debug** reposito +SPAL is a versioned repository. Make sure to have the latest version of `system-release` installed to see the most recent list of packages. @@ -112,0 +111 @@ To permanently enable the **Amazon Linux 2023 SPAL repository - Debug** reposito +For more information on deterministic updates, you can check [Deterministic upgrades through versioned repositories on AL2023](./deterministic-upgrades.html) @@ -115 +113,0 @@ To permanently enable the **Amazon Linux 2023 SPAL repository - Debug** reposito -## Installing SPAL packages @@ -117 +114,0 @@ To permanently enable the **Amazon Linux 2023 SPAL repository - Debug** reposito - * Install SPAL packages on your system by running `dnf install` command. @@ -119 +116 @@ To permanently enable the **Amazon Linux 2023 SPAL repository - Debug** reposito - [ec2-user ~]$ sudo dnf install package +## Downloading SPAL source packages @@ -121 +118 @@ To permanently enable the **Amazon Linux 2023 SPAL repository - Debug** reposito -###### Note +RPM source (SRPM) packages are primarily used by developers for building packages from source. The SPAL source repository is disabled by default. DNF automatically enables it when you use commands that require source packages. @@ -123 +120 @@ To permanently enable the **Amazon Linux 2023 SPAL repository - Debug** reposito -You can use `dnf list` to see a complete list of SPAL packages. +To download the source RPM for an SPAL package, run the following command: @@ -125 +121,0 @@ You can use `dnf list` to see a complete list of SPAL packages. - [ec2-user ~]$ dnf list --repo=amazonlinux-spal @@ -127 +123 @@ You can use `dnf list` to see a complete list of SPAL packages. -###### Note + [ec2-user ~]$ dnf download --source package @@ -129 +125 @@ You can use `dnf list` to see a complete list of SPAL packages. -SPAL is a versioned repository. Make sure to have the latest version of `system-release` installed to see the most recent list of packages. +## Installing SPAL debuginfo packages @@ -131 +127 @@ SPAL is a versioned repository. Make sure to have the latest version of `system- -For more information on deterministic updates, you can check [Deterministic upgrades through versioned repositories on AL2023](./deterministic-upgrades.html) +The debuginfo repository contains both debuginfo and debugsource packages. These packages provide debug symbols and source files that are useful for debugging and profiling applications. The SPAL debuginfo repository is disabled by default. DNF automatically enables it when you use commands that require debug packages. @@ -132,0 +129 @@ For more information on deterministic updates, you can check [Deterministic upgr +To install debuginfo and debugsource packages for an SPAL package, run the following command: @@ -134,0 +132 @@ For more information on deterministic updates, you can check [Deterministic upgr + [ec2-user ~]$ sudo dnf debuginfo-install package