Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions base/comps/kernel/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
============================
Azure Linux Kernel Component
============================

This directory contains the maintained local RPM spec and supporting sources
for the Azure Linux kernel component. The component builds the general-purpose
kernel for x86_64 and aarch64, kernel tools and selftests, and the NVIDIA open
GPU kernel module subpackages.

Source and configuration
========================

The kernel source comes from the Azure Linux ``rolling-lts/azl4`` branch of the
`CBL-Mariner-Linux-Kernel repository`_. ``kernel.comp.toml`` pins the source
archive and its hash. The architecture-specific Azure Linux configurations are
``6.18-x86_64-azl.config`` and ``6.18-aarch64-azl.config``.

``kernel.spec`` is the source of truth for packaging. Edit it directly rather
than editing the generated copy under ``specs/k/kernel/``. Supporting files in
this directory provide module signing, package inspection, gating, and the
NVIDIA open kernel module integration.

Release management
==================

The component uses manual release calculation. For a change that affects the
source RPM or binary RPMs:

* increment ``azl_pkgrelease`` in ``kernel.spec``;
* add a matching entry to the inline ``%changelog``;
* refresh ``locks/kernel.lock`` and ``specs/k/kernel/``.

Build and test
==============

Run all commands from the root of the `Azure Linux repository`_::

azldev comp list -p kernel -q -O json
azldev comp update -p kernel -q
azldev comp render -p kernel -q
azldev comp build -p kernel --preserve-buildenv on-failure -q

Inspect the rendered files before building. Test resulting RPMs in an Azure
Linux mock chroot; do not install them on the development host. See the
repository ``AGENTS.md`` and ``.github/skills/skill-mock/SKILL.md`` for the
required inspection and smoke-test workflow.

Keep packaging changes focused on Azure Linux requirements and avoid restoring
unused architecture or variant machinery inherited from other distributions.

.. _CBL-Mariner-Linux-Kernel repository: https://github.com/microsoft/CBL-Mariner-Linux-Kernel/tree/rolling-lts/azl4
.. _Azure Linux repository: https://github.com/microsoft/azurelinux
Original file line number Diff line number Diff line change
Expand Up @@ -12,18 +12,14 @@ packages:
depends-on:
- modules-core
- modules
- name: modules-partner
depends-on:
- modules-core
- modules


rules:
- .*kunit.*: modules-internal
exact_pkg: True
- .*test[^/]*.ko: modules-internal

- arch/.*: modules-core
- block/t10-pi.ko: modules-core
- crypto/.*: modules-core

- drivers/accel/.*: modules-core
Expand All @@ -39,13 +35,11 @@ rules:
- drivers/block/.*: modules-core
- drivers/bus/.*: modules-core

- drivers/cdrom/.*: modules-core
- drivers/cdx/.*: modules-core
- drivers/char/mwave.*: modules
- drivers/char/.*: modules-core
- drivers/clk/.*: modules-core
- drivers/counter/.*: modules-core
- drivers/cpufreq/amd-pstate-ut.ko: modules-internal
- drivers/cpufreq/.*: modules-core
- drivers/crypto/caam/.*: modules
- drivers/crypto/cavium/.*: modules
Expand Down Expand Up @@ -109,7 +103,6 @@ rules:
- drivers/hwmon/hp-wmi-sensors.*: modules
- drivers/hwmon/intel-m10-bmc-hwmon.*: modules
- drivers/hwmon/nct6775.*: modules
- drivers/hwmon/ntc_thermistor.*: modules
- drivers/hwmon/.*: modules-core
- drivers/hwspinlock/.*: modules-core
- drivers/hwtracing/.*: modules-core
Expand All @@ -119,8 +112,15 @@ rules:
- drivers/i2c/.*: modules-core
- drivers/i3c/.*: modules-core
- drivers/iio/adc/dln2-adc.*: modules-extra
- drivers/iio/accel/.*: modules
- drivers/iio/common/cros_ec_sensors/.*: modules
- drivers/iio/light/.*: modules
- drivers/iio/pressure/.*: modules
- drivers/iio/proximity/.*: modules
- drivers/iio/.*: modules-core
- drivers/input/gameport/.*: modules
- drivers/input/joystick/.*: modules-extra
- drivers/input/misc/pcspkr.*: modules-extra
- drivers/input/tablet/.*: modules
- drivers/input/touchscreen/.*: modules
- drivers/input/.*: modules-core
Expand Down Expand Up @@ -167,14 +167,12 @@ rules:
- drivers/net/ethernet/fungible/.*: modules-core
- drivers/net/ethernet/google/.*: modules-core
- drivers/net/ethernet/hisilicon/.*: modules-core
- drivers/net/ethernet/huawei/.*: modules-core
- drivers/net/ethernet/ibm/.*: modules-core
- drivers/net/ethernet/intel/.*: modules-core
- drivers/net/ethernet/jme.ko: modules-core
- drivers/net/ethernet/litex/.*: modules-core
- drivers/net/ethernet/mellanox/.*: modules-core
- drivers/net/ethernet/microsoft/.*: modules-core
- drivers/net/ethernet/myricom/.*: modules-core
- drivers/net/ethernet/natsemi/.*: modules-core
- drivers/net/ethernet/netronome/.*: modules-core
- drivers/net/ethernet/pensando/.*: modules-core
Expand Down Expand Up @@ -221,7 +219,6 @@ rules:
- drivers/net/vrf.ko: modules-core
- drivers/net/vsockmon.ko: modules-core
- drivers/net/vxlan/.*: modules-core
- drivers/net/wan/hdlc.*: modules-core
- drivers/net/wireguard/.*: modules-core
- drivers/net/wireless/virtual/mac80211_hwsim.*: modules-internal
- drivers/net/wwan/wwan_hwsim.*: modules-internal
Expand All @@ -242,7 +239,6 @@ rules:
- drivers/perf/.*: modules-core
- drivers/phy/.*: modules-core
- drivers/pinctrl/.*: modules-core
- drivers/platform/x86/intel/intel_vsec.*: modules-core
- drivers/pmdomain/.*: modules-core
- drivers/powercap/intel_rapl_tpmi.*: modules
- drivers/powercap/.*: modules-core
Expand All @@ -260,7 +256,6 @@ rules:
- drivers/rpmsg/.*: modules-core
- drivers/rtc/.*: modules-core

- drivers/s390/net/ism.*: modules
- drivers/s390/.*: modules-core

- drivers/scsi/3w.*: modules-core
Expand Down Expand Up @@ -295,12 +290,9 @@ rules:
- drivers/scsi/raid_class.ko: modules-core
- drivers/scsi/scsi_debug.ko: modules-core
- drivers/scsi/scsi_transport_.*: modules-core
- drivers/scsi/sd_mod.ko: modules-core
- drivers/scsi/ses.ko: modules-core
- drivers/scsi/sg.ko: modules-core
- drivers/scsi/smartpqi/.*: modules-core
- drivers/scsi/snic/.*: modules-core
- drivers/scsi/sr_mod.ko: modules-core
- drivers/scsi/st.ko: modules-core
- drivers/scsi/stex.ko: modules-core
- drivers/scsi/virtio_scsi.ko: modules-core
Expand Down Expand Up @@ -333,7 +325,7 @@ rules:
- drivers/usb/misc/.*: modules
- drivers/usb/serial/.*: modules
- drivers/usb/typec/mux/nb7vpq904m.*: modules
- drivers/usb/usbip/.*: modules-internal
- drivers/usb/usbip/.*: modules-extra
- drivers/usb/.*: modules-core

- drivers/vdpa/mlx5/mlx5_vdpa.*: modules
Expand All @@ -348,6 +340,7 @@ rules:
- drivers/virt/.*: modules-core
- drivers/virtio/.*: modules-core

- drivers/watchdog/iTCO_wdt.*: modules
- drivers/watchdog/.*: modules-core

- drivers/xen/.*: modules-core
Expand All @@ -365,27 +358,24 @@ rules:
- drivers/w1/slaves/w1_therm.*: modules-extra

- fs/9p/.*: modules-core
- fs/afs/.*: modules-partner
- fs/afs/.*: modules-core
- fs/affs/affs.*: modules-extra
- fs/bcachefs/.*: modules-core
- fs/befs/befs.*: modules-extra
- fs/binfmt_misc.ko: modules-core
- fs/cachefiles/.*: modules-core
- fs/ceph/.*: modules-core
- fs/coda/coda.*: modules-extra
- fs/dlm/.*: modules-core
- fs/dlm/.*: modules-extra
- fs/erofs/.*: modules-core
- fs/exfat/.*: modules-core
- fs/ext4/.*: modules-core
- fs/f2fs/.*: modules-core
- fs/fat/.*: modules-core
- fs/fuse/cuse.*: modules-extra
- fs/fuse/.*: modules-core
- fs/gfs2/.*: modules-core
- fs/gfs2/.*: modules-extra
- fs/isofs/.*: modules-core
- fs/jbd2/.*: modules-core
- fs/lockd/.*: modules-core
- fs/mbcache.ko: modules-core
- fs/netfs/.*: modules-core
- fs/nfs.*: modules-core
- fs/nilfs2/nilfs2.*: modules-extra
Expand All @@ -395,6 +385,8 @@ rules:
- fs/orangefs/.*: modules-core
- fs/overlayfs/.*: modules-core
- fs/pstore/.*: modules-core
- fs/smb/.*: modules-core
- fs/squashfs/.*: modules-core
- fs/sysv/.*: modules-extra
- fs/ubifs/.*: modules-extra
- fs/udf/.*: modules-core
Expand All @@ -413,8 +405,6 @@ rules:

- lib/.*: modules-core

- mm/zsmalloc.ko: modules-core

- net/802/.*: modules-core
- net/8021q/.*: modules-core
- net/9p/9pnet_rdma.ko: modules
Expand All @@ -426,17 +416,13 @@ rules:
- net/atm/pppoatm.*: modules-extra
- net/ax25/ax25.*: modules-extra
- net/batman-adv/batman-adv.*: modules-extra
- net/bridge/br_netfilter.*: modules-extra
- net/bridge/netfilter/ebt.*: modules-extra
- net/bridge/.*: modules-core
- net/ceph/.*: modules-core
- net/core/pktgen.*: modules-internal
- net/core/.*: modules-core
- net/dns_resolver/.*: modules-core
- net/hsr/.*: modules-core
- net/ife/.*: modules-core
- net/ipv4/netfilter/arp.*: modules-extra
- net/ipv4/netfilter/ip[_t].*: modules-extra
- net/ipv4/tcp_bic.*: modules-extra
- net/ipv4/tcp_highspeed.*: modules-extra
- net/ipv4/tcp_htcp.*: modules-extra
Expand All @@ -449,17 +435,15 @@ rules:
- net/ipv4/tcp_westwood.*: modules-extra
- net/ipv4/tcp_yeah.*: modules-extra
- net/ipv4/.*: modules-core
- net/ipv6/netfilter/ebt.*: modules-extra
- net/ipv6/netfilter/ip6[_t].*: modules-extra
- net/ipv6/.*: modules-core
- net/iucv/.*: modules-core
- net/kcm/.*: modules-core
- net/key/.*: modules-core
- net/l2tp/.*: modules-extra
- net/l2tp/l2tp_debugfs.*: modules-extra
- net/l2tp/l2tp_eth.*: modules-extra
- net/l2tp/l2tp_netlink.*: modules-extra
- net/l2tp/l2tp_ppp.*: modules-extra
- net/llc/.*: modules-core
- net/netfilter/ipset/.*: modules-extra
- net/netfilter/nft_compat.*: modules-extra
- net/netfilter/xt_.*: modules-extra
- net/netfilter/.*: modules-core
- net/netrom/netrom.*: modules-extra
- net/nsh/.*: modules-core
Expand All @@ -468,19 +452,16 @@ rules:
- net/qrtr/.*: modules-core
- net/rds/rds.*: modules-extra
- net/rose/rose.*: modules-extra
- net/rxrpc/.*: modules-partner
- net/rxrpc/.*: modules-core
- net/sched/.*: modules-core
- net/sctp/.*: modules-extra
- net/sunrpc/xprtrdma/rpcrdma.*: modules
- net/sunrpc/.*: modules-core
- net/tipc/.*: modules-extra
- net/tipc/.*: modules-core
- net/tls/.*: modules-core
- net/vmw_vsock/.*: modules-core
- net/xdp/.*: modules-core
- net/xfrm/.*: modules-core

- samples/.*: modules-internal

- virt/.*: modules-core

- default: modules
Loading
Loading