Glossary [FreeBSD WIKI]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== FreeBSD Glossary =====

List of common terms and definitions that are used within the %%FreeBSD%% project, community and by its members.

===== ABI -- Application Binary Interface =====

Acronym: **A**pplication **B**inary **I**nterface.

ABI compatibility is maintained (not changed) within %%FreeBSD%% //major// versions.

See Also: [[#STABLE|STABLE]], WikiPedia:ABI

===== Base =====

The "base" %%FreeBSD%% operating system – kernel and world. Everything that comes from and lives in the [[https://cgit.freebsd.org/src/|src]] repository ((This was the //[[https://svnweb.freebsd.org/base|base SVN repository]]//, before git))

See Also: [[#Local|Local]]

===== CFT -- Call For Testing =====

Acronym: **C**all **F**or **T**esting.

A call to action for the community to test something. Used on mailing lists, IRC, forums, Twitter and other communication channels.

===== CURRENT =====

Name given to the version of [[#Base|base]] in the [[https://cgit.freebsd.org/src/log/|src repository main branch]]. ((This was the //[[https://svnweb.freebsd.org/base/head|HEAD branch of base in SVN]]//, before git))

Example: ''%%14-CURRENT%%''

Also known as: **head**, **main**

===== EN -- Errata Notice =====

Acronym: **E**rrata **N**otice

Published notices that include patches, workarounds and other information about important bug or regression fixes for ''%%X.Y-RELEASE%%'' version of %%FreeBSD%%. Fixes are [[#MFC|MFC]]'d to %%FreeBSD%% [[#releng|releng/x.y]] code branches.

See Also:

  * [[#releng|releng]]
  * [[#security-advisory|SA -- Security Advisory]]
  * [[https://www.freebsd.org/security/notices/|List of FreeBSD Errata Notices]]

===== EXP-RUN -- Experimental Run =====

Acronym: **Exp**erimental **Run**

A test build of all ports run by [[portmgr]] using a specific proposed changeset or patch(es). Used to QA changes with large potential for regression/impact.

===== Linuxulator =====

Linux compatibility layer in [[#Base|base]] that can run unmodified (native) Linux binaries.

Also known as: //lemul// (**L**inux **Emul**ation).

More Information: [[Linuxulator]]

===== Local =====

Everything that is installed separately, in addition to or after, and that is not, //[[#Base|Base]]//. In a nutshell, [[#Ports|Ports]] and [[#Packages|Packages]]. %%FreeBSD%% has a fairly strict separation of Base and Local, with base installed in ''%%/%%'' and Local installed (by default) in ''%%/usr/local%%'', also known as //LOCALBASE//.

===== LOR -- Lock Order Reversal =====

Acronym: **L**ock **O**rder **R**eversal.

See: [[LockOrderReversal]]

===== MFC -- Merge From Current =====

Acronym: **M**erge **F**rom **C**urrent.

Merging or back-porting a //base// commit from CURRENT (main/base/HEAD) to another, usually lower, %%FreeBSD%% version branch. Can be seen in commit log messages.

Example: ''%%MFC: After 2 weeks%%''

See Also: [[#CURRENT|CURRENT]]

===== MFH -- Merge From Head =====

Acronym: **M**erge **F**rom **H**EAD.

Merging or back-porting [[Ports]] commits from HEAD (main) to another (usually [[Ports/QuarterlyBranch|quarterly branch]]). Can be seen in commit log messages.

Example: ''%%MFH: 2020Q4%%''

===== MFV -- Merge From Vendor =====

Acronym: **M**erge **F**rom **V**endor.

Merging code from an external, upstream vendor repository into %%FreeBSD%%. Usually done with software that lives in [[https://cgit.freebsd.org/src/tree/contrib|src: contrib]]

===== Package =====

A "pre-built" [[#Ports|port]] containing compiled (binary) software artifacts, executables, libraries and documentation, usually in ''%%tbz%%'' or ''%%txz%%'' archives. Analogous to Debian 'packages'. These are the things you get (from package repositories) when you ''%%pkg install <package name>%%''.

===== Phabricator =====

Project code review system, used for discussion and review of proposed changes to repositories. Sometimes referred to as //Phab//.

More Information: [[Phabricator]]

===== Ports =====

Recipes for automatically building and installing third-party software. Binary [[#Packages|packages]] are produced from ports. Ports are analogous to Debian //source packages//.

Ports can be obtained and updated via ''%%portsnap%%'' or ''%%git%%''

More Information: [[Ports]]

===== Poudriere =====

Tool for [[https://www.freebsd.org/doc/handbook/ports-poudriere.html|creating packages]] and [[https://www.freebsd.org/doc/en/books/porters-handbook/testing-poudriere.html|testing ports]].

See also: [[https://github.com/freebsd/poudriere#readme|Poudriere GitHub Repository]]

===== PR -- Problem Report =====

Acronym: **P**roblem **R**eport.

An issue/bug report in [[Bugzilla]]. Seen in commit log messages to refer to an issue being worked on or resolved. When referenced in a commit log message, that commit log message is added to the issue as a comment.

Example: ''%%PR: 346543%%''

More Information: [[Bugzilla]]

Acronym: **P**ull **R**equest.

Example: https://github.com/freebsd/drm-kmod/pulls

===== Quarterly =====

[[#Ports|Ports]] repository branches created every 3 months (quarterly).

See Also: [[Ports/QuarterlyBranch]]

===== Releng -- Release Engineering =====

Acronym: **Rel**ease **Eng**ineering.

Refers to [[#Base|base]] release code branches. Release branches receive important bugfixes (via Errata Notices) and security fixes (via Security Advisories).

Example: [[https://cgit.freebsd.org/src/tree/?h=releng%2F13.1|releng/13.1]] the release branch for %%FreeBSD%% 13.1-RELEASE.

===== SA -- Security Advisory =====

Acronym: **S**ecurity **A**dvisory

Published notifications for security vulnerabilities and fixes that include patches, workarounds, and other information for ''%%X.Y-RELEASE%%'' version of %%FreeBSD%%. Fixes are [[#MFC|MFC]]'d to %%FreeBSD%% [[#releng|releng/x.y]] code branches.

See Also:

  * [[#releng|releng]]
  * [[#errata-notice|EN -- Errata Notice]]
  * [[https://www.freebsd.org/security/advisories/|List of FreeBSD Security Advisories]]

===== STABLE =====

Version label given to %%FreeBSD%% (src) major versions in [[https://cgit.freebsd.org/src/refs/heads|stable/*]] repository branches.

Means: A stable //[[#ABI|ABI]]// within that branch, not the common or dictionary //stability// meaning.

Examples: ''%%13-STABLE%%'' (Code branch: [[https://cgit.freebsd.org/src/log/?h=stable/13|stable/13]])

See Also:

  * [[#CURRENT|CURRENT]]
  * [[#releng|releng]]