diff options
| -rw-r--r-- | LIESMICH | 53 | ||||
| -rw-r--r-- | README | 58 |
2 files changed, 97 insertions, 14 deletions
@@ -1,6 +1,6 @@ -$Id: LIESMICH 1.39 2023/07/10 14:25:53 martin.burnicki REL_M $ +$Id: LIESMICH 1.40 2023/12/19 10:23:38 martin.burnicki REL_M $ -Dies ist die LIESMICH-Datei fuer mbgtools-lx-4.2.24 +Dies ist die LIESMICH-Datei fuer mbgtools-lx-4.2.26 --------------------------------------------------- Bitte senden Sie Anregungen und Vorschlaege an den @@ -22,7 +22,8 @@ Inhalt 3.5 Laden des Kernelmoduls 3.6 Wenn das Kernelmodul nicht geladen werden kann ... 3.7 Compilieren des Treibers fuer eine andere Kernel-Version - 3.8 Compilieren des Treibers fuer einen anderen Kernel Source Tree + 3.8 Compilieren des Treibers fuer einen anderen Kernel-Source-Tree + 3.9 Staged Builds 4. Verwendung der Treibersoftware mit ntpd 4.1 Konfiguration mit dem Shared-Memory-Treiber des ntpd 4.2 Konfiguration mit dem Parse-Treiber des ntpd @@ -78,7 +79,7 @@ von Distributionen wie SuSE/openSUSE, Debian/Ubuntu, RedHat/Fedora/CentOS, usw. Diese Version des Treibers sollte problemlos mit Linux-Kernels 2.6.x, -3.x, 4.x, 5.x und 6.x bis mindestens 6.4 funktionieren +3.x, 4.x, 5.x und 6.x bis mindestens 6.6 funktionieren - auf Standard-PCs (i386-Architektur) - auf Intel/AMD-Systemen mit 64 Bit-Architektur (x86_64-Architektur) - auf SPARC64-Architektur @@ -294,6 +295,10 @@ Unter Fedora/Redhat/CentOS muss das RPM-Paket "kernel-devel" und eventuell "kernel-headers" installiert werden, sowie der Compiler und das "make"-Programm: + sudo dnf install kernel-devel-$(uname -r) gcc make + +-oder-, wenn der Paketmanager dnf noch nicht unterstuetzt wird: + sudo yum install kernel-devel-$(uname -r) gcc make @@ -585,7 +590,7 @@ kopiert werden. -3.8 Compilieren des Treibers fuer einen anderen Kernel Source Tree +3.8 Compilieren des Treibers fuer einen anderen Kernel-Source-Tree ------------------------------------------------------------------ Wenn der Kernel-Treiber fuer einen komplett anderen Kernel compiliert werden soll, der nicht ueber die im vorherigen Abschnitt angegebenen @@ -601,6 +606,44 @@ Kernel ausgefuehrt wird. +3.9 Staged Builds +----------------- +Ein "Staged Build" bedeutet, dass ein Paket auf einem Build-System so +kompiliert wird, dass es auf einem anderen Zielsystem lauffaehig ist. + +Anstatt auf dem Build-System installiert zu werden, werden die kompilierten +Binaerdateien normalerweise nur in einem lokalen Ausgabeverzeichnis +installiert, von wo aus sie spaeter auf das Zielsystem kopiert werden. + +Nuetzliche Umgebungsvariablen fuer Staged Builds: + +STAGED_BUILD: Wenn definiert, werden einige Systempruefungen uebersprungen +und es sind keine root-Rechte fuer die Installation erforderlich, da die +Installation in lokale Unterverzeichnisse ergolgt, die ebenfalls definiert +werden muessen. + +INSTALL_MOD_PATH: Das Ausgabeverzeichnis, in das der Kerneltreiber +installiert wird. + +DESTDIR: Das Verzeichnis, in dem die User-Space-Dateien installiert werden. +prefix: Praefix fuer das 'bin'-Verzeichnis, z.B. '/usr' statt '/usr/local'. + +DONT_BUILD_USERSPACE: Falls definiert, nur den Kernel-Treiber erstellen +bzw. installieren. + +DONT_BUILD_DRIVER: Wenn definiert, werden nur die User-Space-Dateien +erstellt bzw. installiert. + +BUILD_DIR: sollte wie im vorherigen Kapitel erlaeutert auf den +konfigurierten Kernel-Source-Tree. + + +Die fruehere Makefile-Variable "CALLED_FROM_SPEC" heisst jetzt "STAGED_BUILD". +Aus Gruenden der Abwaertskompatibilitaet wird jedoch ein Alias +"CALLED_FROM_SPEC" bereitgestellt. + + + 4. Verwendung der Treibersoftware mit ntpd ------------------------------------------ Dieses Treiberpaket kann auf 2 unterschiedliche Arten dem NTP-Daemon @@ -1,6 +1,6 @@ -$Id: README 1.39 2023/07/10 14:25:56 martin.burnicki REL_M $ +$Id: README 1.40 2023/12/19 10:23:33 martin.burnicki REL_M $ -This is the README file for mbgtools-lx-4.2.24 +This is the README file for mbgtools-lx-4.2.26 ---------------------------------------------- Please send comments and required modifications to @@ -21,8 +21,9 @@ Contents 3.4 Installing the Driver 3.5 Loading the Kernel Module 3.6 If the Kernel Module Fails to be Loaded ... - 3.7 Compiling For a Different Target Kernel - 3.8 Compiling For a Completely Different Kernel Source Tree + 3.7 Compiling for a Different Target Kernel + 3.8 Compiling for a Completely Different Kernel Source Tree + 3.9 Staged Builds 4. Using the Driver With ntpd 4.1 Configuration With ntpd's Shared Memory Driver 4.2 Configuration With ntpd's Parse Driver @@ -31,7 +32,7 @@ Contents 6.1 Old SuSE Naming Conventions 6.2 NTP and "Operation not permitted" Under SuSE Linux 10.1 and Newer 6.3 Error "module is unsupported" - 7. "Permission denied" with SELinux (e.g. RedHat/Fedora/CentOS) + 7. "Permission denied" With SELinux (e.g. RedHat/Fedora/CentOS) @@ -77,7 +78,7 @@ given Linux distribution, not on the specific type of distribution, e.g. SuSE/openSUSE, Debian/Ubuntu, RedHat/Fedora/CentOS, etc. This version of the driver package should compile fine with -Linux kernels 2.6.x, 3.x, 4.x, 5.x and 6.x up to at least 6.4 +Linux kernels 2.6.x, 3.x, 4.x, 5.x and 6.x up to at least 6.6 - on standard PCs (i386 architecture) - on Intel/AMD 64 Bit systems (x86_64 architecture) - on SPARC64 architecture @@ -269,6 +270,10 @@ Under Fedora/Redhat/CentOS, the RPM packages "kernel-devel" and perhaps "kernel-headers" need to be installed, and of course the compiler and make utility: + sudo dnf install kernel-devel-$(uname -r) gcc make + +-or-, if the dnf command is not available: + sudo yum install kernel-devel-$(uname -r) gcc make @@ -514,7 +519,7 @@ corresponding to the current kernel version. -3.7 Compiling For a Different Target Kernel +3.7 Compiling for a Different Target Kernel ------------------------------------------- By default, the build environment is accessed via the directories @@ -539,7 +544,7 @@ The compiled kernel module has to be copied manually to the target system. -3.8 Compiling For A Completely Different Kernel Source Tree +3.8 Compiling for A Completely Different Kernel Source Tree ----------------------------------------------------------- If the kernel driver is to be build for an completely different kernel source tree that is not accessible via the default paths mentioned in @@ -555,6 +560,41 @@ has been build under the specified source tree. +3.9 Staged Builds +----------------- +A staged build is commonly used to build a package for a remote target. + +Instead of being installed on the build system, the compiled binaries +are usually just installed into a local output directory, from where +they are later copied to the target system. + +Therefore, no root permissions are required for a staged build, and +instead of some properties of the build system, it's more important +to correctly specify the properties of the final target system. + +Environment variables useful for staged builds: + +STAGED_BUILD: If defined, some system checks are skipped, and no root +permissions are requested for install, so it's only possible to install +to local subdirs that need to be defined, too. + +INSTALL_MOD_PATH: The base directory to which the kernel driver binary is installed. + +DESTDIR: The base directory to which the user space stuff is installed. +prefix: Prefix for the 'bin' directory, e.g. '/usr' instead of '/usr/local'. + +DONT_BUILD_USERSPACE: If defined, only build/install the kernel driver. +DONT_BUILD_DRIVER: If defined, only built/install the user space stuff. + +BUILD_DIR: should point to the configured kernel source tree, as explained +in the previous chapter. + +The former makefile variable 'CALLED_FROM_SPEC' is now called 'STAGED_BUILD', +but a 'CALLED_FROM_SPEC' alias is provided for backward compatibility. + + + + 4. Using the Driver With ntpd ----------------------------- This driver package supports two different ways to provide the NTP @@ -793,7 +833,7 @@ error message quoted above. -7. "Permission denied" with SELinux (e.g. RedHat/Fedora/CentOS) +7. "Permission denied" With SELinux (e.g. RedHat/Fedora/CentOS) --------------------------------------------------------------- RedHat Linux and other distributions based on RedHat (e.g. Fedora or CentOS) often use SELinux to control which processes are allowed to access certain |