ACC SHELL
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 10. YaST in Text Mode</title><link rel="stylesheet" href="susebooks.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="Documentation"><link rel="up" href="part.reference.administration.html" title="Part III. Administration"><link rel="prev" href="cha.y2.lang.html" title="Chapter 9. Changing Language and Country Settings with YaST"><link rel="next" href="cha.p.html" title="Chapter 11. Printer Operation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header" border="0" class="bctable"><tr><td width="80%"><div class="breadcrumbs"><p><a href="index.html"> Documentation</a><span class="breadcrumbs-sep"> > </span><a href="book.opensuse.reference.html">Reference</a><span class="breadcrumbs-sep"> > </span><a href="part.reference.administration.html">Administration</a><span class="breadcrumbs-sep"> > </span><strong><a accesskey="p" title="Chapter 9. Changing Language and Country Settings with YaST" href="cha.y2.lang.html"><span>◀</span></a> <a accesskey="n" title="Chapter 11. Printer Operation" href="cha.p.html"><span>▶</span></a></strong></p></div></td></tr></table></div><div class="chapter" title="Chapter 10. YaST in Text Mode"><div class="titlepage"><div><div><h2 class="title"><a name="cha.yast.text"></a>Chapter 10. YaST in Text Mode<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#cha.yast.text">¶</a></span></h2></div></div></div><div class="toc"><p><b>Contents</b></p><dl><dt><span class="sect1"><a href="cha.yast.text.html#sec.yast.navi.ncurses_modul">10.1. Navigation in Modules</a></span></dt><dt><span class="sect1"><a href="cha.yast.text.html#sec.yast.ncurses_tasten">10.2. Restriction of Key Combinations</a></span></dt><dt><span class="sect1"><a href="cha.yast.text.html#sec.yast.ncurses_commands">10.3. YaST Command Line Options</a></span></dt></dl></div><a class="indexterm" name="idx.YaST_text_mode"></a><p>
This section is intended for system administrators and experts who do not
run an X server on their systems and depend on the text-based installation
tool. It provides basic information about starting and operating YaST in
text mode.
</p><a class="indexterm" name="id449838"></a><p>
YaST in text mode uses the ncurses library to provide an easy
pseudo-graphical user interface. The ncurses library is installed by
default. The minimum supported size of the terminal emulator in which to
run YaST is 80x25 characters.
</p><div class="figure"><a name="fig.yast2.ncurses"></a><p class="title"><b>Figure 10.1. Main Window of YaST in Text Mode</b><span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#fig.yast2.ncurses">¶</a></span></p><div class="figure-contents"><div class="mediaobject"><table border="0" summary="manufactured viewport for HTML img" cellspacing="0" cellpadding="0" width="75%"><tr><td><img src="images/yast2_ncurses_main.png" width="100%" alt="Main Window of YaST in Text Mode"></td></tr></table></div></div></div><br class="figure-break"><p>
When you start YaST in text mode, the YaST Control Center appears (see
<a class="xref" href="cha.yast.text.html#fig.yast2.ncurses" title="Figure 10.1. Main Window of YaST in Text Mode">Figure 10.1</a>).
The main window consists of three areas. The left frame features the
categories to which the various modules belong. This frame is active when
YaST is started and therefore it is marked by a bold white border. The
active category is highlighted. The right frame provides an overview of
the modules available in the active category. The bottom frame contains
the buttons for <span class="guimenu">Help</span> and <span class="guimenu">Quit</span>.
</p><p>
When you start the YaST Control Center, the category
<span class="guimenu">Software</span> is selected automatically. Use
<span class="keycap">↓</span> and <span class="keycap">↑</span> to change the
category. To select a module from the category, activate the right frame
with <span class="keycap">→</span> and then use <span class="keycap">↓</span> and
<span class="keycap">↑</span> to select the module. Keep the arrow keys pressed
to scroll through the list of available modules. The selected module is
highlighted. Press <span class="keycap">Enter</span> to start the active module.
</p><p>
Various buttons or selection fields in the module contain a highlighted
letter (yellow by default). Use
<span class="keycap">Alt</span>-<span class="keycap">highlighted_letter</span>
to select a button directly instead of navigating there with
<span class="keycap">Tab</span>. Exit the YaST Control Center by pressing
<span class="keycap">Alt</span>-<span class="keycap">Q</span>
or by selecting <span class="guimenu">Quit</span> and pressing
<span class="keycap">Enter</span>.
</p><div class="sect1" title="10.1. Navigation in Modules"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec.yast.navi.ncurses_modul"></a>10.1. Navigation in Modules<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#sec.yast.navi.ncurses_modul">¶</a></span></h2></div></div></div><p>
The following description of the control elements in the YaST modules
assumes that all function keys and <span class="keycap">Alt</span> key
combinations work and are not assigned to different global functions.
Read <a class="xref" href="cha.yast.text.html#sec.yast.ncurses_tasten" title="10.2. Restriction of Key Combinations">Section 10.2, “Restriction of Key Combinations”</a> for information about
possible exceptions.
</p><div class="variablelist"><dl><dt><span class="term">Navigation among Buttons and Selection Lists</span></dt><dd><p>
Use <span class="keycap">Tab</span> to navigate among the buttons and frames
containing selection lists. To navigate in reverse order, use
<span class="keycap">Alt</span>-<span class="keycap">Tab</span> or <span class="keycap">Shift</span>-<span class="keycap">Tab</span>
combinations.
</p></dd><dt><span class="term">Navigation in Selection Lists</span></dt><dd><p>
Use the arrow keys (<span class="keycap">↑</span> and
<span class="keycap">↓</span>) to navigate among the individual elements in
an active frame containing a selection list. If individual entries
within a frame exceed its width, use
<span class="keycap">Shift</span>-<span class="keycap">→</span> or <span class="keycap">Shift</span>-<span class="keycap">←</span> to
scroll horizontally to the right and left. Alternatively, use
<span class="keycap">Ctrl</span>-<span class="keycap">E</span> or <span class="keycap">Ctrl</span>-<span class="keycap">A</span>. This
combination can also be used if using <span class="keycap">→</span> or
<span class="keycap">←</span> results in changing the active frame or the
current selection list, as in the Control Center.
</p></dd><dt><span class="term">Buttons, Radio Buttons, and Check Boxes</span></dt><dd><p>
To select buttons with empty square brackets (check boxes) or empty
parentheses (radio buttons), press <span class="keycap">Space</span> or
<span class="keycap">Enter</span>. Alternatively, radio buttons and check
boxes can be selected directly with <span class="keycap">Alt</span>-<span class="keycap">highlighted_letter</span>. In this case, you do
not need to confirm with <span class="keycap">Enter</span>. If you navigate
to an item with <span class="keycap">Tab</span>, press <span class="keycap">Enter</span>
to execute the selected action or activate the respective menu item.
</p></dd><dt><span class="term">Function Keys</span></dt><dd><p>
The F keys (<span class="keycap">F1</span> through <span class="keycap">F12</span>) enable
quick access to the various buttons. Available F key shortcuts are
shown in the bottom line of the YaST screen. Which function keys are
actually mapped to which buttons depend on the active YaST module,
because the different modules offer different buttons (Details, Info,
Add, Delete, etc.). Use <span class="keycap">F10</span> for
<span class="guimenu">Accept</span>, <span class="guimenu">OK</span>,
<span class="guimenu">Next</span>, and <span class="guimenu">Finish</span>. Press
<span class="keycap">F1</span> to access the YaST help.
</p></dd><dt><span class="term">Using Navigation Tree in ncurses Mode</span></dt><dd><p>
Some YaST modules use a navigation tree in the left part of the
window to select configuration dialogs. Use the arrow keys
(<span class="keycap">↑</span> and <span class="keycap">↓</span>) to navigate in
the tree. Use <span class="keycap">Space</span> to open or close tree items. In
ncurses mode, <span class="keycap">Enter</span> must be pressed after a
selection in the navigation tree in order to show the selected dialog.
This is an intentional behaviour to save time consuming redraws when
browsing through the navigation tree.
</p></dd></dl></div><div class="figure"><a name="fig.yast2.ncurses_inst"></a><p class="title"><b>Figure 10.2. The Software Installation Module</b><span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#fig.yast2.ncurses_inst">¶</a></span></p><div class="figure-contents"><div class="mediaobject"><table border="0" summary="manufactured viewport for HTML img" cellspacing="0" cellpadding="0" width="75%"><tr><td><img src="images/yast2_ncurses_inst.png" width="100%" alt="The Software Installation Module"></td></tr></table></div></div></div><br class="figure-break"></div><div class="sect1" title="10.2. Restriction of Key Combinations"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec.yast.ncurses_tasten"></a>10.2. Restriction of Key Combinations<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#sec.yast.ncurses_tasten">¶</a></span></h2></div></div></div><p>
If your window manager uses global <span class="keycap">Alt</span> combinations,
the <span class="keycap">Alt</span> combinations in YaST might not work.
Keys like <span class="keycap">Alt</span> or <span class="keycap">Shift</span> can also
be occupied by the settings of the terminal.
</p><div class="variablelist"><dl><dt><span class="term">Replacing <span class="keycap">Alt</span> with <span class="keycap">Esc</span>
</span></dt><dd><p>
<span class="keycap">Alt</span> shortcuts can be executed with
<span class="keycap">Esc</span> instead of <span class="keycap">Alt</span>. For
example, <span class="keycap">Esc</span> <span class="keycap">H</span> replaces
<span class="keycap">Alt</span>-<span class="keycap">H</span>. (First press
<span class="keycap">Esc</span>, <span class="emphasis"><em>then</em></span> press
<span class="keycap">H</span>.)
</p></dd><dt><span class="term"> Backward and Forward Navigation with <span class="keycap">Ctrl</span>-<span class="keycap">F</span> and <span class="keycap">Ctrl</span>-<span class="keycap">B</span>
</span></dt><dd><p>
If the <span class="keycap">Alt</span> and <span class="keycap">Shift</span>
combinations are occupied by the window manager or the terminal, use
the combinations <span class="keycap">Ctrl</span>-<span class="keycap">F</span> (forward)
and <span class="keycap">Ctrl</span>-<span class="keycap">B</span> (backward)
instead.
</p></dd><dt><span class="term">Restriction of Function Keys</span></dt><dd><p>
The F keys are also used for functions. Certain function keys might be
occupied by the terminal and may not be available for YaST. However,
the <span class="keycap">Alt</span> key combinations and function keys should
always be fully available on a pure text console.
</p></dd></dl></div></div><div class="sect1" title="10.3. YaST Command Line Options"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec.yast.ncurses_commands"></a>10.3. YaST Command Line Options<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#sec.yast.ncurses_commands">¶</a></span></h2></div></div></div><a class="indexterm" name="id450549"></a><p>
Besides the text mode interface, YaST provides a pure command line
interface. To get a list of YaST command line options, enter:
</p><pre class="screen">yast -h</pre><div class="sect2" title="10.3.1. Starting the Individual Modules"><div class="titlepage"><div><div><h3 class="title"><a name="sec.yast.ncurses_modulaufruf"></a>10.3.1. Starting the Individual Modules<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#sec.yast.ncurses_modulaufruf">¶</a></span></h3></div></div></div><a class="indexterm" name="id450576"></a><p>
To save time, the individual YaST modules can be started directly. To
start a module, enter:
</p><pre class="screen">yast <module_name></pre><p>
View a list of all module names available on your system with
<span class="command"><strong>yast -l</strong></span> or <span class="command"><strong>yast --list</strong></span>. Start the
network module, for example, with <span class="command"><strong>yast lan</strong></span>.
</p></div><div class="sect2" title="10.3.2. Installing Packages from the Command Line"><div class="titlepage"><div><div><h3 class="title"><a name="id450615"></a>10.3.2. Installing Packages from the Command Line<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#id450615">¶</a></span></h3></div></div></div><p>
If you know a package name and the package is provided by any of your
active installation repositories, you can use the command line option
<code class="option">-i</code> to install the package:
</p><pre class="screen">yast -i <package_name></pre><p>
or
</p><pre class="screen">yast --install <package_name></pre><p>
<em class="replaceable"><code>package_name</code></em> can be a single short package
name, for example <code class="systemitem">gvim</code>, which
is installed with dependency checking, or the full path to an rpm
package, which is installed without dependency checking.
</p><p>
If you need a command-line based software management utility with
functionality beyond what YaST provides, consider using zypper. This
new utility uses the same software management library that is also the
foundation for the YaST package manager. The basic usage of zypper is
covered in <a class="xref" href="cha.sw_cl.html#sec.zypper" title="7.1. Using Zypper">Section 7.1, “Using Zypper”</a>.
</p></div><div class="sect2" title="10.3.3. Command Line Parameters of the YaST Modules"><div class="titlepage"><div><div><h3 class="title"><a name="id450668"></a>10.3.3. Command Line Parameters of the YaST Modules<span class="permalink"><a alt="Permalink" title="Copy Permalink" href="#id450668">¶</a></span></h3></div></div></div><p>
To use YaST functionality in scripts, YaST provides command line
support for individual modules. Not all modules have command line
support. To display the available options of a module, enter:
</p><pre class="screen">yast <module_name> help</pre><p>
If a module does not provide command line support, the module is started
in text mode and the following message appears:
</p><pre class="screen">This YaST module does not support the command line interface.</pre><a class="indexterm" name="id450691"></a></div></div></div><div class="navfooter"><table width="100%" summary="Navigation footer" border="0" class="bctable"><tr><td width="80%"><div class="breadcrumbs"><p><a href="index.html"> Documentation</a><span class="breadcrumbs-sep"> > </span><a href="book.opensuse.reference.html">Reference</a><span class="breadcrumbs-sep"> > </span><a href="part.reference.administration.html">Administration</a><span class="breadcrumbs-sep"> > </span><strong><a accesskey="p" title="Chapter 9. Changing Language and Country Settings with YaST" href="cha.y2.lang.html"><span>◀</span></a> <a accesskey="n" title="Chapter 11. Printer Operation" href="cha.p.html"><span>▶</span></a></strong></p></div></td></tr></table></div></body></html>
ACC SHELL 2018