Core utilities on Arch Linux are programs that are part of the core functionality of the operating system. Without them you cannot do much of anything. These functions include things like file operations, mounting disks, displaying information and managing processes.

+

''Core utilities'' are the basic, fundamental tools of a [[GNU]]/[[Linux]] system. On Arch Linux they are found in the [[base group]]. This article provides an incomplete overview of them, links their documentation and describes useful alternatives. The scope of this article includes, but is not limited to, the [https://www.gnu.org/software/coreutils/coreutils.html GNU coreutils]. Most core utilities are traditional [[Wikipedia:Unix|Unix]] tools (see [[Heirloom]]) and many were standardized by [[Wikipedia:POSIX|POSIX]] but have been developed further to provide more features.

−

The core utilities are installed on an Arch Linux system through the [https://www.archlinux.org/groups/x86_64/base/ base] package group. This includes GNU {{Pkg|coreutils}}, {{Pkg|util-linux}}, {{Pkg|findutils}}, the {{Pkg|vi}} and {{Pkg|nano}} text editors, and {{Pkg|man-pages}}.

+

Most command-line interfaces are documented in [[man page]]s, utilities by the [[GNU Project]] are documented primarily in [[Info manual]]s, some [[shell]]s provide a {{ic|help}} command for shell builtin commands. Additionally most utilities print their usage when run with the {{ic|--help}} flag.

−

This article is not going to give an in depth tutorial for every core program. Rather the scope of this article will focus on giving an introduction to those tools essential for installing/configuring Arch Linux and troubleshooting the operating system. Users need to have a passing familiarity with these programs in order to successfully use and install Arch.

+

== Essentials ==

−

All of the core utilities have usage manuals, called [[man page]]s. You can read a man page by typing ''man'' and the name of the program you want to read about. [[GNU]] commands tend to be documented in {{man|1|info}} pages, some [[shell]]s provide a {{ic|help}} command for [[shell]]-builtin commands. Additionally most commands print their usage when run with the {{ic|--help}} argument.

+

The following table lists some important utilities which Arch Linux users should be familiar with. See also {{man|1|intro}}.

See {{ic|info ls}} or [https://www.gnu.org/software/coreutils/manual/html_node/ls-invocation.html#ls-invocation the online manual] for more information.

−

−

[https://the.exa.website exa] is a modern, and more user friendly alternative to {{ic|ls}} and {{ic|tree}}, that has more features, such as displaying [[Git]] modifications along with filenames, colouring differently each columnn in {{ic|--long}} mode, or displaying {{ic|--long}} mode metadata along with a {{ic|tree}} view. {{Pkg|exa}}

−

==== Long format ====

−

−

The {{ic|-l}} option displays some metadata, for example:

−

−

{{hc|$ ls -l ''/path/to/directory''|

−

total 128

−

drwxr-xr-x 2 archie users 4096 Jul 5 21:03 Desktop

−

drwxr-xr-x 6 archie users 4096 Jul 5 17:37 Documents

−

drwxr-xr-x 2 archie users 4096 Jul 5 13:45 Downloads

−

-rw-rw-r-- 1 archie users 5120 Jun 27 08:28 customers.ods

−

-rw-r--r-- 1 archie users 3339 Jun 27 08:28 todo

−

-rwxr-xr-x 1 archie users 2048 Jul 6 12:56 myscript.sh

−

}}

−

−

The {{ic|total}} value represents the total disk allocation for the files in the directory, by default in number of blocks.

−

−

Below, each file and subdirectory is represented by a line divided into 7 metadata fields, in the following order:

−

−

* type and permissions:

−

** the first character is the entry type, see {{ic|info ls -n "What information is listed"}} for an explanation of all the possible types; for example:

−

*** {{ic|-}} denotes a normal file;

−

*** {{ic|d}} denotes a directory, i.e. a folder containing other files or folders;

−

*** {{ic|p}} denotes a named pipe (aka FIFO);

−

*** {{ic|l}} denotes a symbolic link;

−

** the remaining characters are the entry's [[permissions]];

−

* number of [[Wikipedia:Hard link|hard links]] for the entity; files will have at least 1, i.e. the showed reference itself; folders will have at least 2: the showed reference, the self-referencing {{ic|.}} entry, and then a {{ic|..}} entry in each of its subfolders;

−

* owner [[user]] name;

−

* [[group]] name;

−

* size;

−

* last modification timestamp;

−

* entity name.

−

−

==== File names containing spaces enclosed in quotes ====

−

−

By default, file and directory names that contain spaces are displayed surrounded by single quotes. To change this behavior use the {{ic|-N}} or {{ic|1=--quoting-style=literal}} options. Alternatively, set the {{ic|QUOTING_STYLE}} [[environment variable]] to {{ic|literal}}. [https://unix.stackexchange.com/questions/258679/why-is-ls-suddenly-surrounding-items-with-spaces-in-single-quotes]

−

−

=== cat ===

−

−

[[Wikipedia:cat_(Unix)|cat]] is a standard Unix utility that concatenates files to standard output.

−

−

* Because ''cat'' is not built into the shell, on many occasions you may find it more convenient to use a [[Wikipedia:Redirection (computing)|redirection]], for example in scripts, or if you care a lot about performance. In fact {{ic|< ''file''}} does the same as {{ic|cat ''file''}}.

−

−

* ''cat'' can work with multiple lines:

−

−

{{bc|

−

$ cat << EOF >> ''path/file''

−

''first line''

−

...

−

''last line''

−

EOF

−

}}

−

−

Alternatively, using {{ic|printf}}:

−

−

{{bc|

−

$ printf '%s\n' 'first line' ... 'last line'

−

}}

−

−

* If you need to list file lines in reverse order, there is a coreutil command called [[Wikipedia:tac (Unix)|tac]] (''cat'' reversed).

−

−

=== less ===

−

−

{{Expansion|less is a complex beast, and this section should explain some of the basic less commands}}

−

−

[[Wikipedia:less (Unix)|less]] is a terminal pager program used to view the contents of a text file one screen at a time. Whilst similar to other pagers such as [[Wikipedia:more (command)|more]] and the [https://git.kernel.org/cgit/utils/util-linux/util-linux.git/tree/Documentation/deprecated.txt deprecated] [[Wikipedia:pg (Unix)|pg]], ''less'' offers a more advanced interface and complete [http://www.greenwoodsoftware.com/less/faq.html feature-set].

−

−

See [[List of applications#Terminal pagers]] for alternatives.

−

−

==== Vim as alternative pager ====

−

−

[[Vim]] includes a script to view the content of text files, compressed files, binaries and directories. Add the following line to your shell configuration file to use it as a pager:

−

{{hc|~/.bashrc|2=alias less='/usr/share/vim/vim80/macros/less.sh'}}

−

−

There is also an alternative to the ''less.sh'' macro, which may work as the {{ic|PAGER}} environment variable. Install {{Pkg|vimpager}} and add the following to your shell configuration file:

−

{{hc|~/.bashrc|2=

−

export PAGER='vimpager'

−

alias less=$PAGER

−

}}

−

−

Now programs that use the {{ic|PAGER}} environment variable, like [[git]], will use ''vim'' as pager.

−

−

=== mkdir ===

−

−

[[Wikipedia:mkdir|mkdir]] makes directories.

−

−

To create a directory and its whole hierarchy, the {{ic|-p}} switch is used, otherwise an error is printed.

−

−

Changing mode of a just created directory using ''chmod'' is not necessary as the {{ic|-m}} option lets you define the access permissions.

−

−

{{Tip|If you just want a temporary directory, a better alternative may be [[Wikipedia:Temporary file|mktemp]]: {{ic|mktemp -d}}}}

−

−

=== mv ===

−

−

[[Wikipedia:mv|mv]] moves and renames files and directories.

−

−

{{Note|"Security aliases" are dangerous because you get used to them, resulting in potential data loss when you use another system / user that doesn't have these aliases.}}

−

−

To limit potential damage caused by the command, use an alias:

−

−

alias mv='mv -iv'

−

−

This alias asks for confirmation before overwriting any existing files and lists the operations in progress.

−

−

=== rm ===

−

−

[[Wikipedia:rm_(Unix)|rm]] removes files or directories.

−

−

{{Note|"Security aliases" are dangerous because you get used to them, resulting in potential data loss when you use another system / user that doesn't have these aliases.}}

−

−

To limit potential damage caused by the command, use an alias:

−

−

alias rm='rm -Iv --one-file-system'

−

−

This alias asks confirmation to delete three or more files, lists the operations in progress, does not involve more than one file systems. Substitute {{ic|-I}} with {{ic|-i}} if you prefer to confirm even for one file.

One would probably expect a ''find'' command to take as argument a file name and search the filesystem for files matching that name. For a program that does exactly that see [[#locate]] below.

−

−

Instead, find takes a set of directories and matches each file under them against a set of expressions. This design allows for some very powerful "one-liners" that would not be possible using the "intuitive" design described above. See [[GregsWiki:UsingFind]] for usage details.

−

−

=== locate ===

−

−

[[Install]] the {{Pkg|mlocate}} package. The package contains an {{ic|updatedb.timer}} unit, which invokes a database update each day. The timer is enabled right after installation, [[start]] it manually if you want to use it before reboot. You can also manually run ''updatedb'' as root at any time. By default, paths such as {{ic|/media}} and {{ic|/mnt}} are ignored, so ''locate'' may not discover files on external devices. See {{man|8|updatedb}} for details.

−

−

The ''locate'' command is a common Unix tool for quickly finding files by name. It offers speed improvements over the [[wikipedia:Find (Unix)|find]] tool by searching a pre-constructed database file, rather than the filesystem directly. The downside of this approach is that changes made since the construction of the database file cannot be detected by ''locate''.

−

−

Before ''locate'' can be used, the database will need to be created. To do this, execute {{ic|updatedb}} as root.

−

−

See also [http://jvns.ca/blog/2015/03/05/how-the-locate-command-works-and-lets-rewrite-it-in-one-minute/ How locate works and rewrite it in one minute].

−

−

=== diff ===

−

−

''diff'' compares files line by line. The default Arch Linux ''diff'' is from the GNU {{Pkg|diffutils}}, which also provides ''cmp'' to compare files byte by byte.

−

−

When comparing text files a word per word diff is often more desirable:

−

−

* [[git]]'s {{ic|git diff}} can do a word diff with {{ic|--color-words}}, using {{ic|--no-index}} it can be used for files outside of Git working trees.

[[Wikipedia:grep|grep]] is a command line text search utility originally written for Unix. The ''grep'' command searches files or standard input for lines matching a given regular expression, and prints these lines to standard output.

* There are ''grep'' alternatives optimized for VCS source code, such as {{Pkg|ripgrep}}, {{Pkg|the_silver_searcher}}, and {{Pkg|ack}}.

−

* To include file line numbers in the output, use the {{ic|-n}} option.

−

* ''grep'' can also be used for hexadecimal search in a binary file, to look for let say the {{ic|A1 F2}} sequence in a file, the command line is: {{bc|1=$ LANG=C grep --text --perl-regexp "\xA1\xF2" ''/path/to/file''}}

−

−

{{Note|Some commands send their output to {{man|3|stderr}}, and grep has no apparent effect. In this case, redirect ''stderr'' to ''stdout'' with {{ic|''command'' 2>&1 {{!}} grep ''args''}} or (for Bash 4) {{ic|''command'' {{!}}& grep ''args''}}. See also [http://www.tldp.org/LDP/abs/html/io-redirection.html I/O Redirection].}}

−

−

For color support, see [[Color output in console#grep]].

−

−

See {{man|1|grep}} for more details.

−

−

=== sed ===

−

−

[[Wikipedia:sed|sed]] is stream editor for filtering and transforming text.

−

−

Here is a handy [http://sed.sourceforge.net/sed1line.txt list] of ''sed'' one-liners examples.

−

−

{{Tip|More powerful alternatives are [[#awk|awk]] and the [[Perl]] language.}}

−

−

=== awk ===

−

−

[[Wikipedia:AWK|AWK]] is a pattern scanning and processing language. There are multiple implementations:

−

−

* {{App|gawk|GNU version of awk, see {{man|1|gawk}}.|https://www.gnu.org/software/gawk/|{{Pkg|gawk}} (part of {{Grp|base}})}}

[[wikipedia:Which_(Unix)|which]] shows the full path of shell commands. In the following example the full path of {{ic|ssh}} is used as an argument for {{ic|journalctl}}:

−

−

# journalctl $(which sshd)

−

=== lsblk ===

+

{{ic|rm}}, {{ic|mv}}, {{ic|cp}} and shell redirections happily delete or overwrite files without asking. {{ic|rm}}, {{ic|mv}}, and {{ic|cp}} all support the {{ic|-i}} flag to prompt the user before every removal / overwrite. Some users like to enable the {{ic|-i}} flag by default using [[alias]]es. Relying upon these shell options can be dangerous, because you get used to them, resulting in potential data loss when you use another system or user that does not have them. The best way to prevent data loss is to create [[backup]]s.

−

{{man|8|lsblk}} will show all available [[Wikipedia:Device file#Block devices|block devices]] along with their partitioning schemes, for example:

+

== Nonessentials ==

−

{{hc|$ lsblk -f|

+

This table lists core utilities that often come in handy.

−

NAME FSTYPE LABEL UUID MOUNTPOINT

−

sda

−

├─sda1 vfat C4DA-2C4D /boot

−

├─sda2 swap 5b1564b2-2e2c-452c-bcfa-d1f572ae99f2 [SWAP]

−

└─sda3 ext4 56adc99b-a61e-46af-aab7-a6d07e504652 /

−

}}

−

The beginning of the device name specifies the type of block device. Most modern storage devices (e.g. hard disks, [[SSD]]s and USB flash drives) are recognised as SCSI disks ({{ic|sd}}). The type is followed by a lower-case letter starting from {{ic|a}} for the first device ({{ic|sda}}), {{ic|b}} for the second device ({{ic|sdb}}), and so on. ''Existing'' partitions on each device will be listed with a number starting from {{ic|1}} for the first partition ({{ic|sda1}}), {{ic|2}} for the second ({{ic|sda2}}), and so on. In the example above, only one device is available ({{ic|sda}}), and that device has three partitions ({{ic|sda1}} to {{ic|sda3}}), each with a different [[file system]].

+

{| class=wikitable

−

+

! Package !! Utility !! Description !! Documentation !! Alternatives

−

Other common block device types include for example {{ic|mmcblk}} for memory cards and {{ic|nvme}} for [[NVMe]] devices. Unknown types can be searched in the [https://www.kernel.org/doc/html/latest/admin-guide/devices.html kernel documentation].

−

−

=== ip ===

−

−

[[Wikipedia:Iproute2|ip]] allows you to show information about network devices, IP addresses, routing tables, and other objects in the Linux [[Wikipedia:Internet Protocol|IP]] software stack. By appending various commands, you can also manipulate or configure most of these objects.

−

−

{{Note|The ''ip'' utility is provided by the {{Pkg|iproute2}} package, which is included in the {{Grp|base}} group.}}

The {{ic|help}} command is available for all objects. For example, typing {{ic|ip addr help}} will show you the command syntax available for the address object. For advanced usage see the [http://www.policyrouting.org/iproute2.doc.html iproute2 documentation].

+

The {{Pkg|moreutils}} package provides useful tools like {{man|1|sponge}} that are missing from the GNU coreutils.

−

The [[Network configuration]] article shows how the ''ip'' command is used in practice for various common tasks.

+

== Alternatives ==

−

{{Note|You might be familiar with the [[Wikipedia:ifconfig|ifconfig]] command, which is deprecated in Arch Linux; use ''ip'' instead. }}

+

Alternatives to the core utilities in the {{Grp|base}} group are [[BusyBox]], the [[Heirloom|Heirloom Toolchest]], {{Pkg|9base}}, {{AUR|sbase-git}} and {{AUR|ubase-git}}.

−

=== ss ===

+

=== cp alternatives ===

−

''ss'' is a utility to investigate network ports and is part of the {{Pkg|iproute2}} package in the {{Grp|base}} group. It has a similar functionality to the [https://www.archlinux.org/news/deprecation-of-net-tools/ deprecated] netstat utility.

+

Using [[rsync#As cp/mv alternative]] allows you to resume a failed transfer, to show the transfer status, to skip already existing files and to make sure of the destination files integrity using checksums.

The [[Wikipedia:od (Unix)|od]] (''o''ctal ''d''ump) command is useful for visualizing data that is not in a human-readable format, like the executable code of a program, or the contents of an unformatted device. See the [https://www.gnu.org/software/coreutils/manual/html_node/od-invocation.html#od-invocation manual] for more information.

−

−

=== seq ===

−

−

''seq'' prints a sequence of numbers. Shell built-in alternatives are available, so it is good practice to use them as explained on [[Wikipedia:Seq (Unix)|Wikipedia]].

−

−

=== tar ===

−

−

As an early Unix archiving format, .tar files—known as "tarballs"—are widely used for packaging in Unix-like operating systems. Both [[pacman]] and [[AUR]] packages are compressed tarballs, and Arch uses [[GNU Project|GNU's]] ''tar'' program by default.

−

−

For ''.tar'' archives, ''tar'' by default will extract the file according to its extension:

''wipefs'' can list or erase [[file system]], [[RAID]] or [[partition|partition-table]] signatures (magic strings) from the specified device. It does not erase the file systems themselves nor any other data from the device.

+

The following three tools aim to replace grep for code search. They do recursive search by default, skip binary files and respect {{ic|.gitignore}}.

Latest revision as of 03:37, 31 July 2019

Core utilities are the basic, fundamental tools of a GNU/Linux system. On Arch Linux they are found in the base group. This article provides an incomplete overview of them, links their documentation and describes useful alternatives. The scope of this article includes, but is not limited to, the GNU coreutils. Most core utilities are traditional Unix tools (see Heirloom) and many were standardized by POSIX but have been developed further to provide more features.

Most command-line interfaces are documented in man pages, utilities by the GNU Project are documented primarily in Info manuals, some shells provide a help command for shell builtin commands. Additionally most utilities print their usage when run with the --help flag.

Preventing data loss

rm, mv, cp and shell redirections happily delete or overwrite files without asking. rm, mv, and cp all support the -i flag to prompt the user before every removal / overwrite. Some users like to enable the -i flag by default using aliases. Relying upon these shell options can be dangerous, because you get used to them, resulting in potential data loss when you use another system or user that does not have them. The best way to prevent data loss is to create backups.

Alternatives

cp alternatives

Using rsync#As cp/mv alternative allows you to resume a failed transfer, to show the transfer status, to skip already existing files and to make sure of the destination files integrity using checksums.