Skip to content

Commit

Permalink
refactor: reimplement the depmod extension rebuilder
Browse files Browse the repository at this point in the history
Drop loop device/mounts completely, use userspace utilities to extract
and lay over module trees in the tmpfs.

Discover kernel version automatically instead of hardcoding it to be
current one (required for Image Service).

Signed-off-by: Andrey Smirnov <andrey.smirnov@siderolabs.com>
(cherry picked from commit c5bd0ac)
  • Loading branch information
smira committed Sep 21, 2023
1 parent 6e27fe3 commit 1a14720
Show file tree
Hide file tree
Showing 5 changed files with 125 additions and 84 deletions.
32 changes: 26 additions & 6 deletions internal/pkg/extensions/compress.go
Original file line number Diff line number Diff line change
Expand Up @@ -41,19 +41,31 @@ func (ext *Extension) Compress(squashPath, initramfsPath string) (string, error)
}

func moveFiles(srcPath, dstPath string) error {
return handleFilesOp(srcPath, dstPath, os.Remove)
}

func copyFiles(srcPath, dstPath string) error {
return handleFilesOp(srcPath, dstPath, nil)
}

func handleFilesOp(srcPath, dstPath string, op func(string) error) error {
st, err := os.Stat(srcPath)
if err != nil {
return err
}

if st.IsDir() {
return moveDirectory(st, srcPath, dstPath)
return handleDirectoryOp(st, srcPath, dstPath, op)
}

return moveFile(st, srcPath, dstPath)
return handleFileOp(st, srcPath, dstPath, op)
}

func moveFile(st fs.FileInfo, srcPath, dstPath string) error {
return handleFileOp(st, srcPath, dstPath, os.Remove)
}

func handleFileOp(st fs.FileInfo, srcPath, dstPath string, op func(string) error) error {
src, err := os.Open(srcPath)
if err != nil {
return err
Expand All @@ -73,10 +85,14 @@ func moveFile(st fs.FileInfo, srcPath, dstPath string) error {
return err
}

return os.Remove(srcPath)
if op != nil {
return op(srcPath)
}

return nil
}

func moveDirectory(st fs.FileInfo, srcPath, dstPath string) error {
func handleDirectoryOp(st fs.FileInfo, srcPath, dstPath string, op func(string) error) error {
if err := os.MkdirAll(dstPath, st.Mode().Perm()); err != nil {
return err
}
Expand All @@ -87,10 +103,14 @@ func moveDirectory(st fs.FileInfo, srcPath, dstPath string) error {
}

for _, item := range contents {
if err = moveFiles(filepath.Join(srcPath, item.Name()), filepath.Join(dstPath, item.Name())); err != nil {
if err = handleFilesOp(filepath.Join(srcPath, item.Name()), filepath.Join(dstPath, item.Name()), op); err != nil {
return err
}
}

return os.Remove(srcPath)
if op != nil {
return op(srcPath)
}

return nil
}
47 changes: 47 additions & 0 deletions internal/pkg/extensions/discarder.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.

package extensions

import (
"fmt"
"io"
)

// discarder is used to implement ReadAt from a Reader
// by reading, and discarding, data until the offset
// is reached. It can only go forward. It is designed
// for pipe-like files.
type discarder struct {
r io.Reader
pos int64
}

// ReadAt implements ReadAt for a discarder.
// It is an error for the offset to be negative.
func (r *discarder) ReadAt(p []byte, off int64) (int, error) {
if off-r.pos < 0 {
return 0, fmt.Errorf("negative seek on discarder not allowed")
}

if off != r.pos {
i, err := io.Copy(io.Discard, io.LimitReader(r.r, off-r.pos))
if err != nil || i != off-r.pos {
return 0, err
}

r.pos += i
}

n, err := io.ReadFull(r.r, p)
if err != nil {
return n, err
}

r.pos += int64(n)

return n, err
}

var _ io.ReaderAt = &discarder{}
124 changes: 49 additions & 75 deletions internal/pkg/extensions/kernel_modules.go
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@
package extensions

import (
"bytes"
"errors"
"fmt"
"io"
Expand All @@ -16,19 +15,16 @@ import (
"path/filepath"
"strings"

"github.com/freddierice/go-losetup/v2"
"github.com/u-root/u-root/pkg/cpio"
"github.com/ulikunitz/xz"
"golang.org/x/sys/unix"

"github.com/siderolabs/talos/internal/pkg/mount"
"github.com/siderolabs/talos/pkg/machinery/constants"
"github.com/siderolabs/talos/pkg/machinery/extensions"
)

// ProvidesKernelModules returns true if the extension provides kernel modules.
func (ext *Extension) ProvidesKernelModules() bool {
if _, err := os.Stat(filepath.Join(ext.rootfsPath, constants.DefaultKernelModulesPath)); os.IsNotExist(err) {
if _, err := os.Stat(ext.KernelModuleDirectory()); os.IsNotExist(err) {
return false
}

Expand All @@ -37,29 +33,30 @@ func (ext *Extension) ProvidesKernelModules() bool {

// KernelModuleDirectory returns the path to the kernel modules directory.
func (ext *Extension) KernelModuleDirectory() string {
return filepath.Join(ext.rootfsPath, constants.DefaultKernelModulesPath)
return filepath.Join(ext.rootfsPath, constants.KernelModulesPath)
}

// GenerateKernelModuleDependencyTreeExtension generates a kernel module dependency tree extension.
// nolint:gocyclo
func GenerateKernelModuleDependencyTreeExtension(extensionsPathWithKernelModules []string, arch string) (*Extension, error) {
log.Println("preparing to run depmod to generate kernel modules dependency tree")
//
//nolint:gocyclo
func GenerateKernelModuleDependencyTreeExtension(extensionsPathWithKernelModules []string, initramfsPath string, printFunc func(format string, v ...any)) (*Extension, error) {
printFunc("preparing to run depmod to generate kernel modules dependency tree")

tempDir, err := os.MkdirTemp("", "ext-modules")
if err != nil {
return nil, err
}

defer logErr(func() error {
defer logErr("removing temporary directory", func() error {
return os.RemoveAll(tempDir)
})

initramfsxz, err := os.Open(fmt.Sprintf(constants.InitramfsAssetPath, arch))
initramfsxz, err := os.Open(initramfsPath)
if err != nil {
return nil, err
}

defer logErr(func() error {
defer logErr("closing initramfs", func() error {
return initramfsxz.Close()
})

Expand All @@ -68,74 +65,44 @@ func GenerateKernelModuleDependencyTreeExtension(extensionsPathWithKernelModules
return nil, err
}

var buff bytes.Buffer
tempRootfsFile := filepath.Join(tempDir, constants.RootfsAsset)

if _, err = io.Copy(&buff, r); err != nil {
return nil, err
if err = extractRootfsFromInitramfs(r, tempRootfsFile); err != nil {
return nil, fmt.Errorf("error extacting cpio: %w", err)
}

tempRootfsFile := filepath.Join(tempDir, constants.RootfsAsset)
// extract /lib/modules from the squashfs under a temporary root to run depmod on it
tempLibModules := filepath.Join(tempDir, "modules")

if err = extractRootfsFromInitramfs(buff, tempRootfsFile); err != nil {
return nil, err
if err = unsquash(tempRootfsFile, tempLibModules, constants.KernelModulesPath); err != nil {
return nil, fmt.Errorf("error running unsquashfs: %w", err)
}

// now we are ready to mount rootfs.sqsh
// create a mount point under tempDir
rootfsMountPath := filepath.Join(tempDir, "rootfs-mnt")
rootfsKernelModulesPath := filepath.Join(tempLibModules, constants.KernelModulesPath)

// create the loopback device from the squashfs file
dev, err := losetup.Attach(tempRootfsFile, 0, true)
// under the /lib/modules there should be the only path which is the kernel version
contents, err := os.ReadDir(rootfsKernelModulesPath)
if err != nil {
return nil, err
}

defer logErr(func() error {
if err = dev.Detach(); err != nil {
return err
}

return dev.Remove()
})

// setup a temporary mount point for the squashfs file and mount it
m := mount.NewMountPoint(dev.Path(), rootfsMountPath, "squashfs", unix.MS_RDONLY|unix.MS_I_VERSION, "", mount.WithFlags(mount.ReadOnly|mount.Shared))

if err = m.Mount(); err != nil {
return nil, err
if len(contents) != 1 || !contents[0].IsDir() {
return nil, fmt.Errorf("invalid kernel modules path: %s", rootfsKernelModulesPath)
}

defer logErr(func() error {
return m.Unmount()
})

// create an overlayfs which contains the rootfs squashfs mount as the base
// and the extension modules as subsequent lower directories
overlays := mount.NewMountPoints()
// writable overlayfs mount inside a container required a tmpfs mount
overlays.Set("overlays-tmpfs", mount.NewMountPoint("tmpfs", constants.VarSystemOverlaysPath, "tmpfs", unix.MS_I_VERSION, ""))
kernelVersionPath := contents[0].Name()

rootfsKernelModulesPath := filepath.Join(rootfsMountPath, constants.DefaultKernelModulesPath)

// append the rootfs mount point
extensionsPathWithKernelModules = append(extensionsPathWithKernelModules, rootfsKernelModulesPath)

// create the overlayfs mount point as read write
mp := mount.NewMountPoint(strings.Join(extensionsPathWithKernelModules, ":"), rootfsKernelModulesPath, "", unix.MS_I_VERSION, "", mount.WithFlags(mount.Overlay|mount.Shared))
overlays.Set("overlays-mnt", mp)

if err = mount.Mount(overlays); err != nil {
return nil, err
// copy to the same location modules from all extensions
for _, path := range extensionsPathWithKernelModules {
if err = copyFiles(filepath.Join(path, kernelVersionPath), filepath.Join(rootfsKernelModulesPath, kernelVersionPath)); err != nil {
return nil, fmt.Errorf("copying kernel modules from %s failed: %w", path, err)
}
}

defer logErr(func() error {
return mount.Unmount(overlays)
})

log.Println("running depmod to generate kernel modules dependency tree")
printFunc("running depmod to generate kernel modules dependency tree")

if err = depmod(mp.Target()); err != nil {
return nil, err
if err = depmod(tempLibModules, kernelVersionPath); err != nil {
return nil, fmt.Errorf("error running depmod: %w", err)
}

// we want this temp directory to be present until the extension is compressed later on, so not removing it here
Expand All @@ -149,22 +116,22 @@ func GenerateKernelModuleDependencyTreeExtension(extensionsPathWithKernelModules
return nil, err
}

kernelModulesDepenencyTreeDirectory := filepath.Join(kernelModulesDependencyTreeStagingDir, constants.DefaultKernelModulesPath)
kernelModulesDepenencyTreeDirectory := filepath.Join(kernelModulesDependencyTreeStagingDir, constants.KernelModulesPath, kernelVersionPath)

if err := os.MkdirAll(kernelModulesDepenencyTreeDirectory, 0o755); err != nil {
return nil, err
}

if err := findAndMoveKernelModulesDepFiles(kernelModulesDepenencyTreeDirectory, mp.Target()); err != nil {
if err := findAndMoveKernelModulesDepFiles(kernelModulesDepenencyTreeDirectory, filepath.Join(rootfsKernelModulesPath, kernelVersionPath)); err != nil {
return nil, err
}

kernelModulesDepTreeExtension := newExtension(kernelModulesDependencyTreeStagingDir, "modules.dep")
kernelModulesDepTreeExtension.Manifest = extensions.Manifest{
Version: constants.DefaultKernelVersion,
Version: kernelVersionPath,
Metadata: extensions.Metadata{
Name: "modules.dep",
Version: constants.DefaultKernelVersion,
Version: kernelVersionPath,
Author: "Talos Machinery",
Description: "Combined modules.dep for all extensions",
},
Expand All @@ -173,15 +140,15 @@ func GenerateKernelModuleDependencyTreeExtension(extensionsPathWithKernelModules
return kernelModulesDepTreeExtension, nil
}

func logErr(f func() error) {
func logErr(msg string, f func() error) {
// if file is already closed, ignore the error
if err := f(); err != nil && !errors.Is(err, os.ErrClosed) {
log.Println(err)
log.Println(msg, err)
}
}

func extractRootfsFromInitramfs(input bytes.Buffer, rootfsFilePath string) error {
recReader := cpio.Newc.Reader(bytes.NewReader(input.Bytes()))
func extractRootfsFromInitramfs(r io.Reader, rootfsFilePath string) error {
recReader := cpio.Newc.Reader(&discarder{r: r})

return cpio.ForEachRecord(recReader, func(r cpio.Record) error {
if r.Name != constants.RootfsAsset {
Expand All @@ -194,7 +161,7 @@ func extractRootfsFromInitramfs(input bytes.Buffer, rootfsFilePath string) error
return err
}

defer logErr(func() error {
defer logErr("closing rootfs", func() error {
return f.Close()
})

Expand All @@ -207,10 +174,17 @@ func extractRootfsFromInitramfs(input bytes.Buffer, rootfsFilePath string) error
})
}

func depmod(kernelModulesPath string) error {
baseDir := strings.TrimSuffix(kernelModulesPath, constants.DefaultKernelModulesPath)
func unsquash(squashfsPath, dest, path string) error {
cmd := exec.Command("unsquashfs", "-d", dest, "-f", "-n", squashfsPath, path)
cmd.Stderr = os.Stderr

return cmd.Run()
}

func depmod(baseDir, kernelVersionPath string) error {
baseDir = strings.TrimSuffix(baseDir, constants.KernelModulesPath)

cmd := exec.Command("depmod", "--all", "--basedir", baseDir, "--config", "/etc/modules.d/10-extra-modules.conf", constants.DefaultKernelVersion)
cmd := exec.Command("depmod", "--all", "--basedir", baseDir, "--config", "/etc/modules.d/10-extra-modules.conf", kernelVersionPath)
cmd.Stderr = os.Stderr

return cmd.Run()
Expand Down
2 changes: 1 addition & 1 deletion pkg/imager/extensions/extensions.go
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ func (builder *Builder) Build() error {
extensionsPathWithKernelModules := findExtensionsWithKernelModules(extensionsList)

if len(extensionsPathWithKernelModules) > 0 {
kernelModuleDepExtension, genErr := extensions.GenerateKernelModuleDependencyTreeExtension(extensionsPathWithKernelModules, builder.Arch)
kernelModuleDepExtension, genErr := extensions.GenerateKernelModuleDependencyTreeExtension(extensionsPathWithKernelModules, builder.InitramfsPath, builder.Printf)
if genErr != nil {
return genErr
}
Expand Down
4 changes: 2 additions & 2 deletions pkg/machinery/constants/constants.go
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@ const (
// DefaultKernelVersion is the default Linux kernel version.
DefaultKernelVersion = "6.1.51-talos"

// DefaultKernelModulesPath is the default path to the kernel modules.
DefaultKernelModulesPath = "/lib/modules" + "/" + DefaultKernelVersion
// KernelModulesPath is the default path to the kernel modules without the kernel version.
KernelModulesPath = "/lib/modules"

// KernelParamConfig is the kernel parameter name for specifying the URL.
// to the config.
Expand Down

0 comments on commit 1a14720

Please sign in to comment.