Документация к arch linux

Help : Reading

Because the vast majority of the ArchWiki contains indications that may need clarification for users new to Arch Linux (or GNU/Linux in general), this rundown of basic procedures was written both to avoid confusion in the assimilation of the articles and to deter repetition in the content itself.

Organization

Most articles on the ArchWiki do not attempt to provide a holistic introduction to a single topic; they are instead written in adherence to the «Don’t Repeat Yourself» principle, under the assumption that the user will seek out and read any supporting material that they do not yet understand. Where possible, such supporting material is indicated in the article via special formatting, see #Formatting.

Because of this organization, it may be necessary to examine several related sources in order to fully understand an ArchWiki article. In particular, users who are new to Arch (or GNU/Linux in general) should expect to end up reading a great number of articles even when solving simple problems. It is especially important to study the supporting material before seeking additional help from other users.

Formatting

• link to a section in the current article: #Organization
• link to another ArchWiki article
• link to an external web page
• link to a man page: intro(1)
• a man page that’s only available offline: foo(1)
• link to a package in the official repositories: foobar
• link to a package in the AUR: foobarAUR

Regular user or root

Some lines are written like so:

Others have a different prefix:

The numeral or hash sign ( # ) indicates that the command needs to be run as root, whereas the dollar sign ( $ ) shows that the command should be run as a regular user.

Note: The commands prefixed with # are intended to be executed from a root shell, which can for example be easily accessed with sudo -i . Running sudo command from an unprivileged shell instead of command from a root shell will also work in most cases, with some notable exceptions such as redirection and command substitution, which strictly require a root shell. See also sudo.

A notable exception to watch out for:

# This alias makes ls colorize the listing alias ls='ls --color=auto'

In this example, the context surrounding the numeral sign communicates that this is not to be run as a command; it should be edited into a file instead. So in this case, the numeral sign denotes a comment. A comment can be explanatory text that will not be interpreted by the associated program. Bash scripts denotation for comments happens to coincide with the root PS1.

After further examination, «give away» signs include the uppercase character following the # sign. Usually, Unix commands are not written this way and most of the time they are short abbreviations instead of full-blown English words (e.g., Copy becomes cp).

Regardless, most articles make this easy to discern by notifying the reader:

Append to ~/path/to/file :

# This alias makes ls colorize the listing alias ls='ls --color=auto'

Append, add, create, edit

When prompted to append to, add to, create, or edit one or more files, it is implied that you should use one of the following methods.

To create or modify multiline files, it is suggested to use a text editor. For example, using the nano command to edit the file /etc/bash.bashrc is:

To create or overwrite a file from a string, it may be simpler to use output redirection. The following example creates or overwrites the contents of the file /etc/hostname with the text myhostname .

# echo myhostname > /etc/hostname

Output redirection can also be used to append a string to a file. The following example appends the text [custom-repo] to the file /etc/pacman.conf .

# echo "[custom-repo]" >> /etc/pacman.conf

When prompted to create directories, use the mkdir command:

Make executable

After creating a file, if it is meant to be run as a script (whether manually or called by another program), it needs to be set as executable, for example with:

See chmod. Some applications such as file managers may provide graphical interfaces to do the same.

Source

Some applications, notably command-line shells, use scripts for their configuration: after modifying them, they must be sourced in order for the changes to be applied. In the case of bash, for example, this is done by running (you can also replace source with . ):

When the wiki suggests modifying such a configuration script, it will not explicitly remind you to source the file, and only in some cases will it point to this section with a reminder link.

Installation of packages

When an article invites you to install some packages in the conventional way, it will not indicate the detailed instructions to do so; instead, it will simply mention the names of the packages to be installed.

Note: Frequently, the install or installed links are used to point to this article section. However, JavaScript has to be enabled for these links to work.

The subsections below give an overview of the generic installation procedures depending on the package type.

Official packages

For packages from the official repositories, you will read something like:

This means that you have to run:

The pacman article contains detailed explanations to deal with package management in Arch Linux proficiently.

Arch User Repository

For packages from the Arch User Repository (AUR), you will read something like:

This means that in general you have to follow the foobar AUR link, download the PKGBUILD archive, extract it, verify the content and finally run, in the same folder:

Note: The base-devel meta package is required to build packages from the AUR or with the Arch build system.

The Arch User Repository article contains all the detailed explanations and best practices to deal with AUR packages.

Control of systemd units

When an article invites to start, enable, stop or restart some systemd units (e.g. a service), it will not indicate the detailed instructions to do so, but instead you will read something like:

This means that you have to run:

# systemctl start example.service

The systemd article contains all the detailed explanations to interact with systemd units in Arch Linux proficiently.

System-wide versus user-specific configuration

It is important to remember that there are two different kinds of configurations on a GNU/Linux system. System-wide configuration affects all users. Since system-wide settings are generally located in the /etc directory, root privileges are required in order to alter them. For example, to apply a Bash setting that affects all users, /etc/bash.bashrc should be modified.

User-specific configuration affects only a single user. Dotfiles are used for user-specific configuration. For example, the file ~/.bashrc is the user-specific configuration file. The idea is that each user can define their own settings, such as aliases, functions and other interactive features like the prompt, without affecting other users’ preferences.

Common shell files

Bash and other Bourne-compatible shells, such as Zsh, also source files depending on whether the shell is a login shell or an interactive shell. See Bash#Configuration files and Zsh#Startup/Shutdown files for details.

Pseudo-variables in code examples

Some code blocks may contain so-called pseudo-variables, which, as the name says, are not actual variables used in the code. Instead they are generic placeholders and have to be manually replaced with system-specific configuration items before the code may be run or parsed. Common shells such as bash and zsh provide tab-completion to auto-complete parameters for common commands such as systemctl.

In the articles that comply with Help:Style/Formatting and punctuation, pseudo-variables are formatted in italics. For example:

• Enable the dhcpcd@interface_name.service for the network interface identified from the output of the ip link command.

In this case interface_name is used as a pseudo-variable placeholder in a systemd template unit. All systemd template units, identifiable by the @ sign, require a system-specific configuration item as argument. See systemd#Using units.

• The command dd if=data_source of=/dev/sdX bs=sector_size count=sector_number seek=partitions_start_sector can be run as root to wipe a partition with the specific parameters.

In this case the pseudo-variables are used to describe the parameters that must be substituted for them. Details on how to gather them are elaborated on in the section Securely wipe disk#Calculate blocks to wipe manually, which features the command.

This article or section needs expansion.

Reason: Mention other examples, ideally from other device categories (e.g. storage), with links to background articles. The examples are meant to avoid duplicating existing explanations in other articles. (Discuss in Help talk:Reading)

In case of file examples, pasting pseudo-variables in real configuration files might break the programs that use them.

Ellipses

In most cases, ellipses ( . ) are not part of the actual file content or code output, and instead represent omitted or optional text that is not relevant for the discussed subject.

For example HOOKS=». encrypt . filesystems . » or:

/etc/X11/xorg.conf.d/50-synaptics.conf

Section "InputClass" . Option "CircularScrolling" "on" Option "CircScrollTrigger" "0" . EndSection

Be aware though that, in a few instances, ellipses may be a meaningful part of the code syntax: attentive users will be able to easily recognize these cases by the context.

Источник

DESCRIPTION

This website is a repository of all manual pages available in the Arch Linux packages. There are 73089 manual pages and 7584 symbolic links from 3573 packages, another 10305 packages do not contain any indexable manual pages.

Traditionally, manual pages are organized into several sections. Read the introduction pages for each section: intro(1), intro(2), intro(3), intro(4), intro(5), intro(6), intro(7), intro(8). Some packages provide their manuals in a subsection (e.g. 3ssl) and some use non-standard sections (e.g. 0 or n).

USAGE

• Use the search form to search for keywords in the names and descriptions of manual pages and packages. You can also the !archman DuckDuckGo bang to search Arch manual pages.
• Use the listing form to list all manual pages matching the specified filtering and sorting criteria.
• Manually use the addressing scheme as explained below.

The manual pages are addressable as /man///… . Any part except is optional:

• and can be used to disambiguate the page version found in multiple packages. If omitted, manual pages are looked up in package repositories in the following order: core, extra, community, multilib.
• If is missing, you will be redirected to the first manual page found in sections in the following order: 1, n, l, 8, 6, 3, 0, 2, 5, 7, 4, 9.
• The default language is en . Note that en is also the fallback language for pages, which are not available in any other language.
• The default format is html (other supported formats are txt and raw ).

Note that symbolic links, such as bunzip2(1), are implemented as HTTP redirects with the 302 status code. Symbolic links are included in per-package listings, such as core/openssl.

LAST UPDATES

This is just a brief summary of the last updates to the internal database.

Time (UTC)	Duration	Updated packages	Updated man pages
2023-07-15 00:58:05	00:02:22	277	1095
2023-07-14 00:58:54	00:01:34	85	160
2023-07-13 00:27:17	00:01:31	174	69
2023-07-12 00:59:51	00:02:09	220	1632
2023-07-11 00:08:41	00:01:40	144	184

NOTES

AUTHORS

The project was initially created for the man template on the Arch wiki. The code is developed in a GitLab repository.

SEE ALSO

There are other manual page websites using different sources and providing different features. See a list on the wiki.

Powered by archmanweb, using mandoc for the conversion of manual pages.

The website is available under the terms of the GPL-3.0 license, except for the contents of the manual pages, which have their own license specified in the corresponding Arch Linux package.

Источник