Kbuilder - 版の履歴

Kusanaginoturugi: add en page link.

2023-04-11T09:34:18Z

add en page link.

← 古い版		2023年4月11日 (火) 18:34時点における版
1行目:		1行目:
	[[Category:カーネル]]		[[Category:カーネル]]
			[[en:Kbuilder]]
	kbuilder は、公式にサポートされている 4 つのカーネルのうちの 1 つを、独自のオプションのパッチや設定を加えて、別のパッケージ名でローカルにビルドすることができる bash スクリプトです。		kbuilder は、公式にサポートされている 4 つのカーネルのうちの 1 つを、独自のオプションのパッチや設定を加えて、別のパッケージ名でローカルにビルドすることができる bash スクリプトです。

Kusanaginoturugi: /* ビルド変数 */ 校正

2023-04-03T09:13:27Z

ビルド変数: 校正

← 古い版		2023年4月3日 (月) 18:13時点における版
34行目:		34行目:
	* {{ic\|KBUILDER_PKG_NAME_APPEND}} は、任意の文字列で設定することができます。カーネルバージョンとカーネルパッケージの末尾に追加されます。既定値は 'kbuilder-custom' です。		* {{ic\|KBUILDER_PKG_NAME_APPEND}} は、任意の文字列で設定することができます。カーネルバージョンとカーネルパッケージの末尾に追加されます。既定値は 'kbuilder-custom' です。

	{{ic\|KBUILDER_BUILD_JOBS}} は整数で設定する必要があります。kbuilderは、PKGBUILDの{{ic\|make all}}行を{{ic\|make -jX all}}に置換します。ここでXは指定された整数です。		* {{ic\|KBUILDER_BUILD_JOBS}} は整数で設定する必要があります。kbuilderは、PKGBUILDの{{ic\|make all}}行を{{ic\|make -jX all}}に置換します。ここでXは指定された整数です。

	使用例:		使用例:

Kusanaginoturugi: /* ビルド変数 */ 不要なプロンプトを削除

2023-04-03T09:13:05Z

ビルド変数: 不要なプロンプトを削除

← 古い版		2023年4月3日 (月) 18:13時点における版
38行目:		38行目:
	使用例:		使用例:
	$ KBUILDER_BUILD_JOBS=4 KBUILDER_PKG_NAME_APPEND="my-custom-patch" KBUILDER_SOURCE_PKG="linux-zen" kbuilder build		$ KBUILDER_BUILD_JOBS=4 KBUILDER_PKG_NAME_APPEND="my-custom-patch" KBUILDER_SOURCE_PKG="linux-zen" kbuilder build

	なお、[[ ]] タグや{{ }}タグ内の内容は翻訳せず、そのまま出力します。また、行の先頭にあるスペースは、コード部分であるため、翻訳しないように注意してください。

	== フック ==		== フック ==

Kusanaginoturugi: /* Build variables */ 飜訳

2023-04-03T09:12:38Z

Build variables: 飜訳

← 古い版		2023年4月3日 (月) 18:12時点における版
24行目:		24行目:
	$ kbuilder install		$ kbuilder install

	== ~~Build variables~~ ==		== ビルド変数 ==

			kbuilderには設定ファイルがありませんが、[[環境変数]]でビルドプロセスを制御できます。
	Although kbuilder does not have a configuration file, you can control the build process with [[environment variables]].

	* {{ic\|KBUILDER_SOURCE_PKG}} ~~should be set as~~ 'linux', 'linux-lts', 'linux-zen' or 'linux-hardened'. kbuilder ~~will fetch and build the kernel specified with this variable. Defaults to~~ 'linux'~~. For more information about the official kernels, see~~ [[~~kernel~~]].		* {{ic\|KBUILDER_SOURCE_PKG}} は 'linux'、'linux-lts'、'linux-zen'、または 'linux-hardened' のいずれかで設定する必要があります。kbuilderは、この変数で指定されたカーネルを取得してビルドします。既定値は 'linux' です。公式カーネルについての詳細は[[カーネル]]を参照してください。

			{{Note\|一つのカーネルで動作するパッチが、別のカーネルで動作するとは限りません。}}
	{{Note\|Patches that work on one kernel may not necessarily work on another.}}

	* {{ic\|KBUILDER_PKG_NAME_APPEND}} ~~can be set as any string. It will be appended to the end of the kernel version and the kernel package. Defaults to~~ 'kbuilder-custom'.		* {{ic\|KBUILDER_PKG_NAME_APPEND}} は、任意の文字列で設定することができます。カーネルバージョンとカーネルパッケージの末尾に追加されます。既定値は 'kbuilder-custom' です。

	* {{ic\|KBUILDER_BUILD_JOBS}} ~~should be set as an integer.~~ kbuilder ~~will replace the~~ {{ic\|make all}} ~~line in the PKGBUILD with~~ {{ic\|make -jX all}}~~, where~~ X ~~is the integer specified.~~		{{ic\|KBUILDER_BUILD_JOBS}} は整数で設定する必要があります。kbuilderは、PKGBUILDの{{ic\|make all}}行を{{ic\|make -jX all}}に置換します。ここでXは指定された整数です。

			使用例:
	Example usage:
	$ KBUILDER_BUILD_JOBS=4 KBUILDER_PKG_NAME_APPEND="my-custom-patch" KBUILDER_SOURCE_PKG="linux-zen" kbuilder build		$ KBUILDER_BUILD_JOBS=4 KBUILDER_PKG_NAME_APPEND="my-custom-patch" KBUILDER_SOURCE_PKG="linux-zen" kbuilder build

			なお、[[ ]] タグや{{ }}タグ内の内容は翻訳せず、そのまま出力します。また、行の先頭にあるスペースは、コード部分であるため、翻訳しないように注意してください。

	== フック ==		== フック ==

Kusanaginoturugi: /* Hooks */ 飜訳

2023-04-03T09:09:42Z

Hooks: 飜訳

← 古い版		2023年4月3日 (月) 18:09時点における版
39行目:		39行目:
	$ KBUILDER_BUILD_JOBS=4 KBUILDER_PKG_NAME_APPEND="my-custom-patch" KBUILDER_SOURCE_PKG="linux-zen" kbuilder build		$ KBUILDER_BUILD_JOBS=4 KBUILDER_PKG_NAME_APPEND="my-custom-patch" KBUILDER_SOURCE_PKG="linux-zen" kbuilder build

	== ~~Hooks~~ ==		== フック ==

	kbuilder ~~looks for hooks in~~ {{ic\|/etc/kbuilder/hooks/}}~~, and uses run-parts to execute them right before~~ {{ic\|build()}} ~~is called. The~~ run-parts ~~command is executed with the flag~~ {{ic\|--regex "kbuilder-hook-*"}}.		kbuilderは、{{ic\|/etc/kbuilder/hooks/}} 内のフックを検索し、{{ic\|build()}} が呼び出される直前に、run-parts を使用してそれらを実行します。run-parts コマンドは、フラグ{{ic\|--regex "kbuilder-hook-*"}}で実行されます。

			例えば以下のようなフックがあります:
	An example hook:

	{{hc\|/etc/kbuilder/hooks/05-kbuilder-hook-cpu-optimize.sh\|<nowiki>		{{hc\|/etc/kbuilder/hooks/05-kbuilder-hook-cpu-optimize.sh\|<nowiki>
60行目:		60行目:
	</nowiki>}}		</nowiki>}}

			フックを作成するには、ファイル名を {{ic\|''xx''-kbuilder-hook-''hookname''}} の形式に従って[[作成]]し、[[実行可能属性]]にします。その後、''xx''の値に従って順次実行されます。
	To create a hook, [[create]] and make [[executable]] a file, with a name following the {{ic\|''xx''-kbuilder-hook-''hookname''}} form: they will be run in order according to the ''xx'' value.

	== 参照 ==		== 参照 ==

Kusanaginoturugi: 一部飜訳

2023-04-03T08:42:08Z

一部飜訳

← 古い版		2023年4月3日 (月) 17:42時点における版
1行目:		1行目:
	[[Category:カーネル]]		[[Category:カーネル]]
			kbuilder は、公式にサポートされている 4 つのカーネルのうちの 1 つを、独自のオプションのパッチや設定を加えて、別のパッケージ名でローカルにビルドすることができる bash スクリプトです。
	kbuilder is a bash script that allows you to build one of the four officially supported kernels locally with your own optional patches and configuration, under a different package name.

			例えば、{{Pkg\|linux-lts}} カーネルのソースを取得し、カーネルをインテルプロセッサに最適化するパッチを適用し、そのカーネルを '''linux-lts-intel-optimized''' としてインストールすることができます。
	For example, you could fetch the sources of the {{Pkg\|linux-lts}} kernel, apply a patch that optimizes the kernel for intel processors, and install that kernel as '''linux-lts-intel-optimized'''.

	== ~~Installation~~ ==		== インストール ==

			kbuilder の取得には以下の方法があります：
	The following methods can be used to get kbuilder:
	* ~~[[Install]] the~~ {{AUR\|kbuilder}} ~~package.~~		* {{AUR\|kbuilder}} パッケージを[[インストール]]する。
	* ~~Install the latest development version from the~~ [https://github.com/AnnikaV9/kbuilder github ~~repository~~].		* [https://github.com/AnnikaV9/kbuilder github リポジトリ]から最新の開発版をインストールする。

			== カーネルのビルド ==
	== Building a kernel ==

	~~To fetch the default vanilla~~ {{Pkg\|linux}} ~~kernel sources and build the package with the default name~~ '''linux-kbuilder-custom''':		デフォルトのバニラ {{Pkg\|linux}} カーネルソースを取得し、デフォルトの名前 '''linux-kbuilder-custom''' でパッケージをビルドします:

	$ kbuilder build		$ kbuilder build

	{{Note\|~~The build directory is~~ {{ic\|~/.kbuilder/cache}}.}}		{{Note\|ビルドディレクトリは {{ic\|~/.kbuilder/cache}} です。}}

			ビルドの過程で、kbuilder は PKGBUILD に bash シェルを注入します。このシェルは {{ic\|build()}} が呼ばれる直前に実行され、パッチの追加やカーネル設定の変更をインタラクティブに行うことができます。シェルから抜けるとビルドは継続されます。
	During the build process, kbuilder will inject a bash shell into the PKGBUILD. The shell will be run right before {{ic\|build()}} is called, allowing you to add any patches or change the kernel config interactively. The build will continue once you exit from the shell.

			ビルドしたパッケージをインストールする:
	To install the built packages:

	$ kbuilder install		$ kbuilder install

Kusanaginoturugi: /* See also */ 飜訳

2023-04-03T08:38:27Z

Kusanaginoturugi: 英語版より転載

2023-04-03T08:37:59Z

英語版より転載

新規ページ

[[Category:カーネル]]
kbuilder is a bash script that allows you to build one of the four officially supported kernels locally with your own optional patches and configuration, under a different package name.

For example, you could fetch the sources of the {{Pkg|linux-lts}} kernel, apply a patch that optimizes the kernel for intel processors, and install that kernel as '''linux-lts-intel-optimized'''.

== Installation ==

The following methods can be used to get kbuilder:
* [[Install]] the {{AUR|kbuilder}} package.
* Install the latest development version from the [https://github.com/AnnikaV9/kbuilder github repository].

== Building a kernel ==

To fetch the default vanilla {{Pkg|linux}} kernel sources and build the package with the default name '''linux-kbuilder-custom''':

$ kbuilder build

{{Note|The build directory is {{ic|~/.kbuilder/cache}}.}}

During the build process, kbuilder will inject a bash shell into the PKGBUILD. The shell will be run right before {{ic|build()}} is called, allowing you to add any patches or change the kernel config interactively. The build will continue once you exit from the shell.

To install the built packages:

$ kbuilder install

== Build variables ==

Although kbuilder does not have a configuration file, you can control the build process with [[environment variables]].

* {{ic|KBUILDER_SOURCE_PKG}} should be set as 'linux', 'linux-lts', 'linux-zen' or 'linux-hardened'. kbuilder will fetch and build the kernel specified with this variable. Defaults to 'linux'. For more information about the official kernels, see [[kernel]].

{{Note|Patches that work on one kernel may not necessarily work on another.}}

* {{ic|KBUILDER_PKG_NAME_APPEND}} can be set as any string. It will be appended to the end of the kernel version and the kernel package. Defaults to 'kbuilder-custom'.

* {{ic|KBUILDER_BUILD_JOBS}} should be set as an integer. kbuilder will replace the {{ic|make all}} line in the PKGBUILD with {{ic|make -jX all}}, where X is the integer specified.

Example usage:
$ KBUILDER_BUILD_JOBS=4 KBUILDER_PKG_NAME_APPEND="my-custom-patch" KBUILDER_SOURCE_PKG="linux-zen" kbuilder build

== Hooks ==

kbuilder looks for hooks in {{ic|/etc/kbuilder/hooks/}}, and uses run-parts to execute them right before {{ic|build()}} is called. The run-parts command is executed with the flag {{ic|--regex "kbuilder-hook-*"}}.

An example hook:

{{hc|/etc/kbuilder/hooks/05-kbuilder-hook-cpu-optimize.sh|<nowiki>
#!/bin/bash
#
# kbuilder hook for applying graysky2's kernel compiler patch:
# https://github.com/graysky2/kernel_compiler_patch
#

SOURCE="https://raw.githubusercontent.com/graysky2/kernel_compiler_patch/master"
PATCH="more-uarches-for-kernel-5.17+.patch"
HOOK_NAME="cpu-optimize-hook"

curl -o $PATCH $SOURCE/$PATCH || { echo "$HOOK_NAME failed when fetching $PATCH from $SOURCE" ; exit 1 ; }
patch -Np1 -i "$PATCH" || { echo "$HOOK_NAME failed when applying $PATCH" ; exit 1 ; }
</nowiki>}}

To create a hook, [[create]] and make [[executable]] a file, with a name following the {{ic|''xx''-kbuilder-hook-''hookname''}} form: they will be run in order according to the ''xx'' value.

== See also ==

* [[Kernel]]
* [https://docs.kernel.org/ The Linux Kernel Documentation]
* [https://docs.kernel.org/process/applying-patches.html Applying Patches To The Linux Kernel]

← 古い版		2023年4月3日 (月) 17:38時点における版
62行目:		62行目:
	To create a hook, [[create]] and make [[executable]] a file, with a name following the {{ic\|''xx''-kbuilder-hook-''hookname''}} form: they will be run in order according to the ''xx'' value.		To create a hook, [[create]] and make [[executable]] a file, with a name following the {{ic\|''xx''-kbuilder-hook-''hookname''}} form: they will be run in order according to the ''xx'' value.

	== ~~See also~~ ==		== 参照 ==

	* [[~~Kernel~~]]		* [[カーネル]]
	* [https://docs.kernel.org/ The Linux Kernel Documentation]		* [https://docs.kernel.org/ The Linux Kernel Documentation]
	* [https://docs.kernel.org/process/applying-patches.html Applying Patches To The Linux Kernel]		* [https://docs.kernel.org/process/applying-patches.html Applying Patches To The Linux Kernel]