1
0
mirror of https://git.FreeBSD.org/doc.git synced 2026-06-02 19:35:07 +00:00

dev-handbook: Split x86 assembly chapter into new article

The content of this chapter is niche, and has not been significantly
altered since its initial authorship in 2001. Still, it contains highly
detailed information that is still accurate on a largely
undocumented/esoteric topic. Therefore, it is worth preserving.

Move this to a standalone article. This allows us to continue publishing
it while removing any expectation that the text should evolve or stay
up-to-date.

Discussed with:	ziaee, carlavilla
Reviewed by:	emaste (previous version)
Sponsored by:	The FreeBSD Foundation
Differential Revision:	https://reviews.freebsd.org/D45961
This commit is contained in:
Mitchell Horne
2026-05-19 11:13:46 -03:00
parent 3f018dc958
commit 936011df3b
17 changed files with 44 additions and 166 deletions
@@ -1,26 +1,21 @@
---
title: Kapitel 11. x86-Assembler-Programmierung
prev: books/developers-handbook/partiv
next: books/developers-handbook/partv
showBookMenu: true
weight: 15
params:
path: "/books/developers-handbook/x86/"
title: x86-Assembler-Programmierung
authors:
- author: Adam Stanislav
email: adam@redprince.net
description: A tutorial on writing programs for FreeBSD in x86 assembly language
tags: ["x86", "assembly", "programming", "guide"]
---
[[x86]]
= x86-Assembler-Programmierung
:doctype: book
:doctype: article
:toc: macro
:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
:sectnumoffset: 11
:partnums:
:source-highlighter: rouge
:experimental:
:images-path: books/developers-handbook/
ifdef::env-beastie[]
ifdef::backend-html5[]
@@ -76,10 +76,6 @@ include::{chapters-path}partiii.adoc[]
include::{chapters-path}kernelbuild/_index.adoc[leveloffset=+1]
include::{chapters-path}kerneldebug/_index.adoc[leveloffset=+1]
// Section four
include::{chapters-path}partiv.adoc[]
include::{chapters-path}x86/_index.adoc[leveloffset=+1]
// Appendices
include::{chapters-path}partv.adoc[]
include::{chapters-path}partiv.adoc[]
include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
@@ -1,12 +1,12 @@
---
title: Teil IV. Architekturen
title: Teil V. Anhang
prev: books/developers-handbook/kerneldebug
next: books/developers-handbook/x86
next: books/developers-handbook/bibliography
showBookMenu: true
weight: 14
params:
path: "/books/developers-handbook/partiv/"
---
[[architectures]]
= Architekturen
[[appendices]]
= Anhang
@@ -1,12 +0,0 @@
---
title: Teil V. Anhang
prev: books/developers-handbook/x86
next: books/developers-handbook/bibliography
showBookMenu: true
weight: 16
params:
path: "/books/developers-handbook/partv/"
---
[[appendices]]
= Anhang
@@ -1,29 +1,21 @@
---
title: Chapter 11. x86 Assembly Language Programming
title: x86 Assembly Language Programming
authors:
prev: books/developers-handbook/partiv
next: books/developers-handbook/partv
description: x86 Assembly Language Programming
tags: ["x86", "guide"]
showBookMenu: true
weight: 15
params:
path: "/books/developers-handbook/x86/"
- author: Adam Stanislav
email: adam@redprince.net
description: A tutorial on writing programs for FreeBSD in x86 assembly language
tags: ["x86", "assembly", "programming", "guide"]
---
[[x86]]
= x86 Assembly Language Programming
:doctype: book
:doctype: article
:toc: macro
:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
:sectnumoffset: A
:partnums:
:source-highlighter: rouge
:experimental:
:images-path: books/developers-handbook/
ifdef::env-beastie[]
ifdef::backend-html5[]
@@ -4303,7 +4295,7 @@ Of course, creative people often break rules, and it is OK as long as they know
This tutorial would never have been possible without the help of many experienced FreeBSD programmers from the {freebsd-hackers}, many of whom have patiently answered my questions, and pointed me in the right direction in my attempts to explore the inner workings of UNIX(R) system programming in general and FreeBSD in particular.
Thomas M. Sommers opened the door for me .
Thomas M. Sommers opened the door for me.
His https://web.archive.org/web/20090914064615/http://www.codebreakers-journal.com/content/view/262/27[How do I write "Hello, world" in FreeBSD assembler?] web page was my first encounter with an example of assembly language programming under FreeBSD.
Jake Burkholder has kept the door open by willingly answering all of my questions and supplying me with example assembly language source code.
@@ -78,10 +78,6 @@ include::{chapters-path}partiii.adoc[]
include::{chapters-path}kernelbuild/_index.adoc[leveloffset=+1]
include::{chapters-path}kerneldebug/_index.adoc[leveloffset=+1]
// Section four
include::{chapters-path}partiv.adoc[]
include::{chapters-path}x86/_index.adoc[leveloffset=+1]
// Appendices
include::{chapters-path}partv.adoc[]
include::{chapters-path}partiv.adoc[]
include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
@@ -1,12 +1,12 @@
---
title: Part IV. Architectures
title: Part IV. Appendices
prev: books/developers-handbook/kerneldebug
next: books/developers-handbook/x86
next: books/developers-handbook/bibliography
showBookMenu: true
weight: 14
params:
path: "/books/developers-handbook/partiv/"
---
[[architectures]]
= Architectures
[[appendices]]
= Appendices
@@ -1,12 +0,0 @@
---
title: Part V. Appendices
prev: books/developers-handbook/x86
next: books/developers-handbook/bibliography
showBookMenu: true
weight: 16
params:
path: "/books/developers-handbook/partv/"
---
[[appendices]]
= Appendices
@@ -1,29 +1,20 @@
---
title: 'Программирование на языке ассемблера для x86'
authors: ~
description: 'Программирование на ассемблере x86'
next: books/developers-handbook/partv
params:
path: /books/developers-handbook/x86/
prev: books/developers-handbook/partiv
showBookMenu: 'true'
tags: ["x86", "guide"]
title: 'Глава 11. Программирование на языке ассемблера для x86'
weight: 15
tags: ["x86", "assembly", "programming", "guide"]
---
[[x86]]
= Программирование на ассемблере x86
:doctype: book
:doctype: article
:toc: macro
:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
:sectnumoffset: A
:partnums:
:source-highlighter: rouge
:experimental:
:images-path: books/developers-handbook/
ifdef::env-beastie[]
ifdef::backend-html5[]
@@ -75,10 +75,6 @@ include::{chapters-path}partiii.adoc[]
include::{chapters-path}kernelbuild/_index.adoc[leveloffset=+1]
include::{chapters-path}kerneldebug/_index.adoc[leveloffset=+1]
// Section four
include::{chapters-path}partiv.adoc[]
include::{chapters-path}x86/_index.adoc[leveloffset=+1]
// Appendices
include::{chapters-path}partv.adoc[]
include::{chapters-path}partiv.adoc[]
include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
@@ -1,12 +1,12 @@
---
next: books/developers-handbook/x86
next: books/developers-handbook/bibliography
params:
path: /books/developers-handbook/partiv/
prev: books/developers-handbook/kerneldebug
showBookMenu: 'true'
title: 'Часть IV. Архитектуры'
weight: 14
title: 'Часть IV. Приложения'
weight: 16
---
[[architectures]]
= Архитектуры
[[appendices]]
= Приложения
@@ -1,12 +0,0 @@
---
next: books/developers-handbook/bibliography
params:
path: /books/developers-handbook/partv/
prev: books/developers-handbook/x86
showBookMenu: 'true'
title: 'Часть V. Приложения'
weight: 16
---
[[appendices]]
= Приложения
@@ -1,31 +0,0 @@
# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR The FreeBSD Project
# This file is distributed under the same license as the FreeBSD Documentation package.
# Vladlen Popolitov <vladlenpopolitov@list.ru>, 2025.
msgid ""
msgstr ""
"Project-Id-Version: FreeBSD Documentation VERSION\n"
"POT-Creation-Date: 2025-05-01 19:56-0300\n"
"PO-Revision-Date: 2025-06-07 17:10+0000\n"
"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n"
"Language-Team: Russian <https://translate-dev.freebsd.org/projects/"
"documentation/booksdevelopers-handbookpartv/ru/>\n"
"Language: ru\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n"
"X-Generator: Weblate 4.17\n"
#. type: YAML Front Matter: title
#: documentation/content/en/books/developers-handbook/partv.adoc:1
#, no-wrap
msgid "Part V. Appendices"
msgstr "Часть V. Приложения"
#. type: Title =
#: documentation/content/en/books/developers-handbook/partv.adoc:12
#, no-wrap
msgid "Appendices"
msgstr "Приложения"
@@ -1,26 +1,21 @@
---
title: 章 11. x86 Assembly Language Programming
prev: books/developers-handbook/partiv
next: books/developers-handbook/partv
showBookMenu: true
weight: 15
params:
path: "/books/developers-handbook/x86/"
title: x86 Assembly Language Programming
authors:
- author: Adam Stanislav
email: adam@redprince.net
description: A tutorial on writing programs for FreeBSD in x86 assembly language
tags: ["x86", "assembly", "programming", "guide"]
---
[[x86]]
= x86 Assembly Language Programming
:doctype: book
:doctype: article
:toc: macro
:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
:sectnumoffset: 11
:partnums:
:source-highlighter: rouge
:experimental:
:images-path: books/developers-handbook/
ifdef::env-beastie[]
ifdef::backend-html5[]
@@ -73,10 +73,6 @@ include::{chapters-path}partiii.adoc[]
include::{chapters-path}kernelbuild/_index.adoc[leveloffset=+1]
include::{chapters-path}kerneldebug/_index.adoc[leveloffset=+1]
// Section four
include::{chapters-path}partiv.adoc[]
include::{chapters-path}x86/_index.adoc[leveloffset=+1]
// Appendices
include::{chapters-path}partv.adoc[]
include::{chapters-path}partiv.adoc[]
include::{chapters-path}bibliography/_index.adoc[leveloffset=+1]
@@ -1,12 +1,12 @@
---
title: Part IV. Architekturen
prev: books/developers-handbook/kerneldebug
next: books/developers-handbook/x86
next: books/developers-handbook/bibliography
showBookMenu: true
weight: 14
params:
path: "/books/developers-handbook/partiv/"
---
[[architectures]]
= Architectures(電腦架構)
[[appendices]]
= Appendices
@@ -1,12 +0,0 @@
---
title: Part V. Appendices
prev: books/developers-handbook/x86
next: books/developers-handbook/bibliography
showBookMenu: true
weight: 16
params:
path: "/books/developers-handbook/partv/"
---
[[appendices]]
= Appendices