Publication Date 19 Dec 2011
Copyright © 2006– 2011 Novell, Inc. and contributors. All rights reserved.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or (at your option) version 1.3; with the Invariant Section being this copyright notice and license. A copy of the license version 1.2 is included in the section entitled “GNU Free Documentation License”.
For Novell trademarks, see the Novell Trademark and Service Mark list http://www.novell.com/company/legal/trademarks/tmlist.html. Linux* is a registered trademark of Linus Torvalds. All other third party trademarks are the property of their respective owners. A trademark symbol (®, ™ etc.) denotes a Novell trademark; an asterisk (*) denotes a third party trademark.
All information found in this book has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Novell, Inc., SUSE LINUX Products GmbH, the authors, nor the translators shall be held liable for possible errors or the consequences thereof.
Contents
List of Figures
List of Tables
/proc File System/sys File SystemList of Examples
/etc/modprobe.conf: Interrupt Mode for the First Parallel PortThis manual will see you through your initial contact with openSUSE®. Check out the various parts of this manual to learn how to install, use and enjoy your system.
Guides you through the installation process and the basic configuration of your system. Introduces YaST, the central tool for installation and configuration of your system. Learn how to set up or modify key components of your system and how to connect to the internet.
This part mainly addresses to users changing to Linux from other operating systems. It introduces basic Linux concepts such as the user concept, the structure of the file system and access permissions for files and directories. An introduction to the shell is also provided, although you hardly ever need the command line to interact with your system nowadays.
Provides an overview of where to find help and additional documentation in case you need more information or want to perform specific tasks with your system. Also find a compilation of the most frequent problems and annoyances and learn how to solve these problems on your own.
This manual documents milestone 7 of openSUSE 12.1.
Many chapters in this manual contain links to additional documentation resources. This includes documentation that is available on the system as well as documentation available on the Internet.
For an overview of the documentation available for your product and the latest documentation updates, refer to http://www.novell.com/documentation/opensuse114 or to the following section.
We provide HTML and PDF versions of our books in different languages. The following manuals for users and administrators are available on this product:
Guides you step-by-step through the installation of openSUSE from DVD, or from an ISO image, gives short introductions to the GNOME and KDE desktops including some key applications running on it. Also gives an overview of LibreOffice and its modules for writing texts, working with spreadsheets, or creating graphics and presentations.
Gives you a general understanding of openSUSE and covers advanced system administration tasks. It is intended mainly for system administrators and home users with basic system administration knowledge. It provides detailed information about advanced deployment scenarios, administration of your system, the interaction of key system components and the set-up of various network and file services openSUSE offers.
Introduces basic concepts of system security, covering both local and network security aspects. Shows how to make use of the product inherent security software like AppArmor (which lets you specify per program which files the program may read, write, and execute) or the auditing system that reliably collects information about any security-relevant events.
An administrator's guide for problem detection, resolution and optimization. Find how to inspect and optimize your system by means of monitoring tools and how to efficiently manage resources. Also contains an overview of common problems and solutions and of additional help and documentation resources.
This manual offers an introduction to setting up and managing
virtualization with KVM (Kernel-based Virtual Machine) on
openSUSE. Also shows how to manage VM Guests with libvirt and
QEMU.
Find HTML versions of most product manuals in your installed system under
/usr/share/doc/manual or in the help centers of your
desktop. Find the latest documentation updates at
http://www.novell.com/documentation where you can download
PDF or HTML versions of the manuals for your product.
Several feedback channels are available:
To report bugs for a product component, or to submit enhancement requests, please use https://bugzilla.novell.com/. For documentation bugs, submit a bug against the component for the respective product.
If you are new to Bugzilla, you might find the following articles helpful:
We want to hear your comments and suggestions about this manual and the other documentation included with this product. Use the User Comments feature at the bottom of each page in the online documentation or go to http://www.novell.com/documentation/feedback.html and enter your comments there.
The following typographical conventions are used in this manual:
/etc/passwd: directory names and filenames
placeholder: replace
placeholder with the actual value
PATH: the environment variable PATH
ls, --help: commands, options, and
parameters
user: users or groups
Alt, Alt+F1: a key to press or a key combination; keys are shown in uppercase as on a keyboard
, +: menu items, buttons
Dancing Penguins (Chapter Penguins, ↑Another Manual): This is a reference to a chapter in another manual.
This book is written in Novdoc, a subset of DocBook (see
http://www.docbook.org). The XML source files were
validated by xmllint, processed by
xsltproc, and converted into XSL-FO using a customized
version of Norman Walsh's stylesheets. The final PDF is formatted through
XEP from RenderX. The open source tools and the
environment used to build this manual are available in the package
susedoc that is shipped with
openSUSE.
The source code of openSUSE is publicly available. Refer to http://en.opensuse.org/Source_code for download links and more information.
With a lot of voluntary commitment, the developers of Linux cooperate on a global scale to promote the development of Linux. We thank them for their efforts—this distribution would not exist without them. Furthermore, we thank Frank Zappa and Pawar. Special thanks, of course, goes to Linus Torvalds.
Have a lot of fun!
Your SUSE Team
Contents
Contents
Abstract
Use the following procedures to install a new version of openSUSE® 12.1. This document gives a quick overview on how to run through a default installation of openSUSE.
For more detailed installation instructions and deployment strategies, see the openSUSE documentation at http://www.novell.com/documentation/opensuse114/.
Pentium* III 500 MHz or higher processor (Pentium 4 2.4 GHz or higher or any AMD64 or Intel* EM64T processor recommended)
512 MB physical RAM (1 GB recommended)
3 GB available disk space (more recommended)
800 x 600 display resolution (1024 x 768 or higher recommended)
Use these instructions if there is no existing Linux system on your machine, or if you want to replace an existing Linux system.
Insert the openSUSE DVD into the drive, then reboot the computer to start the installation program.
![]() |
Select on the boot screen and press Enter. This loads the openSUSE installation program and starts the installation in normal mode.
![]() |
Select the language and the keyboard layout to be used during the installation and for the installed system.
Read the License Agreement and proceed with if you agree. If you do not agree, press to terminate the installation.
![]() |
Select and proceed with .
![]() |
Either use the map or the drop down lists for and to select the clock and time zone to use in your system. Proceed with .
![]() |
Select the desktop system you would like to use. and , are powerful graphical desktop environments similar to Windows, alternative selections are available when checking . Proceed with .
![]() |
Define a partition setup for openSUSE in this step. In most cases a reasonable scheme that can be accepted without change is proposed. Accept the proposal with and proceed with the installation. Experienced users can also customize the proposal () or apply their own partitioning scheme ().
![]() |
Type your first and last name in the field, your login name in the field, and your password in the field.
For security reasons, your password should be at least eight characters long and should contain uppercase and lowercase letters and numbers. Passwords are case-sensitive. Proceed with .
By default, the password you enter here is also used for the system
administrator, root. Uncheck the relevant option if you prefer
to specify a different password for root in the next step.
With automatic login enabled, the system boots straight to your desktop with no authentication at all. If you store sensitive data on your system, you should not enable this option as long as the computer can also be accessed by others.
![]() |
Type a password for the system administrator account (called the
root user). This step is skipped in case you had activated
in the
previous step.
You should never forget the root password.
After you enter it here, the password cannot be retrieved. It can only
be reset with administrative assistance. Proceed with
.
![]() |
Use the Installation Settings screen to review your choices as well as some automatically proposed settings. If necessary, change the settings.
Click to proceed. Depending on your software selection you may have to accept additional license agreements by clicking . Before the actual installation starts you will see the following screen:
![]() |
Click to start the installation.
![]() |
The installation usually takes between 15 and 30 minutes, depending on the system performance and the selected software scope. During the installation you may either view the product presentation, the release notes containing last-minute information, or the detailed installation log.
![]() |
After completing the installation of all selected software packages and the basic system setup, the openSUSE installation boots into the new Linux system, to perform the automatic system configuration. This routine attempts to configure your network and Internet access and sets up your hardware. This process does not need any interaction.
![]() |
If you have chosen the automatic login function, the desktop directly starts. Otherwise you will see the login screen. Click on your username, and type your password in the field. Press Enter to login.
Contents
Abstract
openSUSE® provides the tools that Linux* users require in their daily activities. It comes with an easy-to-use graphical environment, the KDE* desktop, that communicates with the underlying Linux system to access and manage files, folders, and programs. openSUSE provides an integrated suite of applications for a wide range of purposes (office, multimedia, Internet). The LibreOffice suite is also included, which allows you to edit and save files in a number of formats. Because the office suite is available for several operating systems, you can use the same data across different computing platforms.
When you start your system, you are usually prompted to enter your username and password. If you did not install the system yourself, check with the system administrator for your username and password.
After logging in to KDE for the first time, you see the KDE desktop, which shows the following basic elements:
![]() |
Desktop Folder:
By default, the desktop folder shows the contents of its
~/Desktop directory. Whenever you insert a file
into this directory, it appears in this view too.
Desktop Context Menu: Right-click an empty area on the desktop to access the context menu for configuring the appearance of the desktop, adding panels or widgets to the desktop, configuring desktop settings, locking the widgets in their current position, leaving the current session, or for locking the screen.
Desktop Toolbox: Move your mouse pointer to the icon in the upper right corner of the desktop to access the menu that lets you add or lock widgets.
KDE Panel: By default, the panel of your KDE desktop consists of the icon on the left, further widgets and program icons, and the panel settings icon on the right. If you hover the mouse pointer over an icon in the panel, a short description is displayed.
Main Menu. Click on the left side of the bottom panel to open the main menu. The consists of the following elements: a search function at the top and several tabs at the bottom, providing quick access to the key functions of the menu. Additionally, the menu displays your login name and the hostname of your computer.
Start programs from the or from the command line, using a shell or the . Additionally, you can start programs from the desktop or the panel by left-clicking the program icon once.
To open the , click the icon in the panel or press Alt+F1.
shows a default selection of key programs for quick access, whereas shows all applications installed on your system. To navigate through the menu structure, click an entry and use the arrow icons at the right or the left to switch back and forth. and provide quick access to some frequently used places, applications, or documents. shows several options for leaving the session such as logging out, locking the screen (access can only be regained with a password), shutting down or restarting the computer. Some computers offer to suspend your session to RAM or disc.
![]() |
If you often need a program and do not want to dig into the menu structure, you can integrate the icon into the tab. Right-click the icon on any of the other tabs and choose .
KRunner is a helper application that lets you quickly start programs. Apart from that, it offers a search function for finding applications or locations.
Press Alt+F2 to open the dialog. Type a command, for example, dolphin. While you are typing, the dialog shows a list of applications or actions that match your input. Select one of the results or press Enter to start the highlighted application or action. The command to start the application is often (but not always) the application name written in lowercase.
![]() |
The dialog allows you also to use
different features. Click on the question mark icon to see a list of
active features. To configure or get a list of all features, click on
the wrench icon. You can use so-called Web
shortcuts defined in Konqueror to send search requests
directly to a search engine without first opening the browser. Another
interesting feature is to calculate a mathematical expression like
=2+2^4-sin(2). Very useful is to convert units, for
example, from miles per hour into kilometres per hour. Just insert the
expression 60 mph in km/h to get the converted value.
Both the and the dialog offer a search function that lets you quickly start programs even if you do not already know the exact application name or command. To search for an application, start typing a command or part of the application name in the field or the input field in the dialog. Each character you enter narrows down the search.
From the list below the input field, choose the application matching your query.
If you insert a CD or DVD into your drive or plug in a pluggable device (for example, a USB stick or removable hard disk), the device notifier widget opens a small window alerting you to this. It also proposes possible actions, depending on the type of the device.
![]() |
For example, if you plugged in a digital camera, the actions allow you to download your photos with Gwenview or digiKam. Click the device entry in the widget to access the available actions. To safely remove the device from your computer, use the icon on the right side of the device entry.
You can change the way your KDE desktop looks and behaves to suit your personal preferences.
Desktop elements can be locked in their current position to prevent them from being moved around on the desktop. As long as the desktop elements are locked you cannot add, move, or remove any objects to or from your desktop.
To lock or unlock the desktop elements, click the cashew icon (desktop toolbox) at the upper right corner of the desktop and select or .
Alternatively, right-click an empty patch on the desktop and select or .
In the following, you can find some examples of how to change individual desktops elements.
Procedure 2.1. Adding Program Icons to the Desktop¶
To create a link to an application and place it on the desktop or the panel, proceed as follows:
Click the button and browse to the desired application.
Right-click and select from the context menu that appears. If this menu item is not available, your desktop elements are probably locked. Unlock them first as described in Section 2.4.1, “Locking and Unlocking Desktop Objects”.
To change the icon position on the desktop, left-click the icon and drag it to the desired position.
To delete an icon from your desktop, right-click the program icon and select .
Procedure 2.2. Adding Widgets to the Desktop or to the Panel¶
To add widgets to you desktop, right-click an empty patch on your desktop and select .
To add a widget to the panel, right-click an empty patch on the panel, and select +.
If these menu items are not available, your desktop elements are probably locked. In this case, right-click and select first.
In the list that appears, select a widget. Use the scrollbar to browse through the available widgets. To limit the selection of widgets, either enter a search term in the input field or choose a Category.
To make the selected widget appear on the desktop or in the panel, double-click it and close the dialog box.
To remove a widget from your desktop or panel, right-click the widget and select the entry.
Procedure 2.3. Configuring Desktop Widgets¶
Hover your mouse pointer over the widget until a translucent frame appears around the widget, showing a number of symbols:
![]() |
If the frame does not appear, your widgets are probably locked. Unlock them first as described in Section 2.4.1, “Locking and Unlocking Desktop Objects”.
To change the widget size, left-click the scale symbol in the frame and keep the mouse button pressed while slowly moving your cursor across the desktop.
To rotate the widget in any direction, left-click the arrow symbol in the frame and keep the mouse button pressed while moving your cursor in a circle across the desktop. There is a sticky boundary in the horizontal and vertical positions where you can “clamp” the widget, if you like. Of course, you can also arrange it in any tilted position.
To change the contents, settings, or properties of a widget, left-click the wrench symbol in the frame. In the configuration dialog box that appears, set the options according to your wishes.
Procedure 2.4. Adding and Removing Panels¶
If you want multiple panels on the desktop, right-click an empty area on the desktop, select and choose a panel type from the list.
If these menu items are not available, your desktop objects are probably locked. In this case, right-click and select first.
Click the cashew icon at the end of the new panel to access the configuration options and customize the panel as described in Procedure 2.5, “Configuring Panels”.
To delete a panel, right-click a blank space in the panel you want to delete and select +. openSUSE requires that at least one panel is left on the desktop.
Procedure 2.5. Configuring Panels¶
You can customize all KDE panels according to your preferences. Applications and widgets can be added to the quick launch area or the system tray in the main panel or to additional panels. Panel elements and additional panels can be moved to different places or be completely removed at any time.
To access any options for the current panel, right-click an empty patch in the panel (or click the cashew icon at the end of the panel) and select +. The panel changes view and shows its configurations options.
![]() |
If the menu item and the icon are not available, your desktop objects are probably locked. To unlock, right-click and select first.
To move panel objects to a different place within the panel, hover the mouse cursor over the respective panel object (for example, program icon, pager, task manager, system tray). The mouse cursor turns into a crosslines-like form. Click the object and move the cursor to the desired position in the panel. Click again to fix it at this place.
To enlarge the distance between two widgets, use . A spacer widget appears on the right side. Drag and drop it to the preferred place.
To change the panel width, click and drag the small arrow icons at the left and right end of the settings panel. Use the arrow on the left side to set the panel's position and the arrows at the left side to set the maximum and minimum size.
To change the panel height, click the button and move the mouse cursor to the desired end location.
To place the panel at different sides of the screen use the button. Drag and drop the panel to the preferred location.
If you need additional widgets on your panel, add them with the button as described in Procedure 2.2, “Adding Widgets to the Desktop or to the Panel”.
To remove program icons or widgets from the panel, right-click the unwanted object and select the menu item to remove the icon or widget.
The icons in the system tray usually belong to applications running in the background. Therefore you can only remove those icons if you close those applications (right-click the icon and select ).
To prevent the panel and widgets from being moved accidentally, use .
For additional configurations options like alignment and functions (like auto hide), click .
If all panel changes are according to your wishes, close the panel settings with the red close button on the right side.
Procedure 2.6. Changing the Desktop Background¶
You can change the desktop background to display images, a slideshow, patterns or colors. It is even possible to use a map of the globe or the weather report as desktop background.
Right-click an empty patch of the desktop and select . A configuration dialog appears.
In the section, choose a type from the drop-down list. The further configuration options depend on the choice of the object to use as background.
For example, to use an image wallpaper:
Set to .
Define the of the image.
To use one of the available wallpapers, either choose a wallpaper from the list or click to download additional wallpapers.
To use a custom picture, click and select an image file from the file system.
![]() |
Set the other options in the configuration dialog according to your wishes, and click to save your changes and leave the configuration dialog.
Apart from changing individual desktop elements, KDE allows you to personalize your desktop to a very high degree. Possibilities to adjust the overall appearance and behavior of your desktop can be found in the configuration dialog.
Start the from the by selecting +.
The settings are grouped into different categories. Hover over an icon
to see more details. Performing tasks in some areas of the personal
settings requires system administrator (root) permissions.
![]() |
Change the settings as desired. No changes take effect until you click . To discard changes in the recent view that you have not yet applied, click . To reset all items in the recent view to the default values, click .
To get back to the start-up view (showing all categories) again, click at the top left corner of the dialog. You can also enter a search string at the top of the window (for example, ) to find the category which holds options related to the search string. Each character you enter in the field further narrows the search.
For easier overview of all categories, you can also switch to a tree view by clicking and selecting another .
If your computer supports a 3D graphics card with Xgl, you can use graphical effects like turning your desktop into a rotating 3D cube, enabling translucent or transparent windows, and zooming in and out of the desktop screen. You can also use other window effects such as shadows, fading, and transformations. If you do not have a 3D graphics card, some effects may be disabled or reduce the performance of your system. If the performance of your system is too low, disable the effects for your current session with Alt+Shift+F12.
To configure effects on your desktop, proceed as follows:
Start the as described in Section 2.4.3, “Modifying Personal Settings”.
Select from the category and choose . If your graphic card does not support 3D, you will be notified.
Optionally, change some options below .
On the tab, select the effects you want to activate. Click the information icon for a short explanation of the respective effect. If an effect is activated, the wrench icon on the right gives access to further configuration options like assigning keyboard shortcuts to the effect.
Use to enable the effects permanently.
The desktop environment allows you to organize your programs and tasks on several virtual desktops. If you often run a lot of programs simultaneously, this minimizes the number of windows to arrange on your screen. You might, for example, use one desktop for e-mailing and calendaring and another for word processing and graphics applications.
Procedure 2.7. Moving an Application to Another Virtual Desktop¶
You can display a running application on one or all virtual desktops, or move it to other desktops.
Open the application.
Right-click the title bar of the application.
Click .
Select the desktop on which to place the application.
To switch to a certain desktop, click the desired desktop in the pager in the panel. Switch to the next or previous desktop by placing the mouse cursor on an empty patch on the desktop and move the mouse wheel.
Procedure 2.8. Configuring Virtual Desktops¶
You can increase the number of virtual desktops, change the default names, assign activities, configure effect animations or assign keyboard shortcuts for switching virtual desktops.
To add additional desktops, right-click the pager in the panel and select . A new desktop is shown in the pager.
For any configuration options, right-click the pager and select .
![]() |
Use the options on the screen to configure the appearance of the pager in the panel.
Desktop names, keyboard shortcuts for switching desktops and the switching type can be configured on the screen.
Set the options according to your wishes and click to apply the changes and to close the configuration dialog.
With KDE 4, Dolphin has replaced Konqueror as the default file manager. Konqueror remains a Web browser (refer to Section 2.8, “Browsing the Internet”). Start Dolphin, from the Main Menu by selecting + or press Alt+F2 and enter dolphin.
The Dolphin main window consists of the following elements:
![]() |
Menu Bar: The menu bar holds menu items for actions like copying, moving, or deleting files, changing views, starting additional tools, defining your settings, and getting help.
Toolbar: The toolbar provides quick access to frequently used functions that can also be accessed via the menu. If you hover the mouse pointer over an icon, a short description is displayed.
Location Bar: The location bar displays the path to the current directory. It is available in two versions: one shows the path to the current directory with icons for every parent folder in a “bread crumb” view. Click any icon in the bread crumb view to change to that directory. The second version of the location bar shows the path to the current directory as a string of text you can edit.
Panels:
By default, Dolphin shows the panel. It
allows quick access to some often-used places like your home directory,
the root directory of the file system (/), the
trash bin, and removable media. There are several other panels you can
add to the main window by clicking +.
Display Field (Working Space): The display field shows the contents of the selected directory or file. By default, Dolphin displays the contents of your home directory on start-up. By default, clicking a folder or file in Dolphin directly starts an action: Dolphin loads the file into an application for further processing or opens the folder.
Status Bar: Shows the file type and size of the currently selected object and allows you to enlarge or diminish the size of the icons or entries shown in the display field.
To perform actions like copying, moving, creating or deleting files, you need appropriate permissions to the folders and files involved in your action.
To copy, move, or delete a file or folder, proceed as follows:
In order to select one or multiple files and folders in Dolphin, move your mouse pointer over the file or folder but do not click. A green cross appears on the upper-left edge. If you click it, the object is selected. To deselect again, click the red minus icon that appears if the object is currently selected.
Alternatively, press Ctrl and click the objects you want to select or deselect.
Right-click and select or from the context menu.
Navigate to the destination folder in which to insert the object.
To create a new folder at the current location, select ++ or press F10. Enter a folder name in the new window and press Enter.
To insert the object you copied or cut in Step 2, right-click the destination folder in the main display field and select . The object is copied or moved there.
To delete a file or folder, right-click the object in the main display field and select from the context menu. The object is moved to the trash bin. From there, you can restore it if necessary or delete the object permanently.
To quickly filter for certain filenames in the current directory, press Ctrl+I to add the input field to the bottom of the Dolphin main window. Type any part of the filename you are searching for to see all files in the current directory containing the search string. For more detailed and advanced searches, press Ctrl+F to use the desktop search. For more information, refer to Section 2.14.2, “Using Strigi Desktop Search”.
Dolphin offers many options for adjusting the view and the overall settings according to your preferences.
Procedure 2.9. Changing the View
To switch from the bread crumb view to the editable version of the location bar, press F6. Enter a path to a directory by typing it in. After typing an address, press Enter or click on the background of the bread crumb view.
To delete the contents of the location bar click the black
X symbol on the left. To switch back to bread crumb
view, press Ctrl+L.
![]() |
To change the view of the currently displayed folder, either click , , or in the toolbar. Dolphin remembers the selected view for each folder. Click or press F3 to view the contents of the current folder in two separate columns. Now you can navigate to a different directory in each column and easily drag or drop objects or compare the contents of directories. Press F3 again to leave the split view.
![]() |
To make Dolphin also show hidden files, select +.
To view more details about the files (like access permissions or ownership) in the working space, select + and enable the corresponding options.
To add further directories to the panel, drag a folder from the working space to the panel and drop it there. Right-click and use the context menu to hide, edit or remove entries from .
To add more panels to the main window, select + and select additional panels such as , or .
Detach the panels from the main Dolphin window by clicking the left icon at the top of each panel. Click the panel's title bar and drag it to another place on the desktop. To reintegrate the panel into the Dolphin window, click the left symbol at the top of the panel again.
Procedure 2.10. Changing Dolphin's Overall Behavior
If you want to change Dolphin's overall behavior or view, select + and explore the options offered in the Dolphin configuration dialog.
To use the same view mode for all folders, click in the left sidebar and activate . Click in the left sidebar and adjust the options for the individual view modes. Click to save the changes.
If you want Dolphin to show a different directory on start-up, or if you want to permanently use the editable location bar instead of the bread crumb view, click in the left sidebar and change the relevant options.
To configure which entries and services to show in the Dolphin context menu, click . On the tab, activate the entries to show. Click in the left sidebar and activate or deactivate the respective services to appear in the context menu.
Click to save the changes and to close the Dolphin configuration dialog.
Apart from Konqueror (KDE's default Web browser), openSUSE also includes the default Firefox Web browser. To start Konqueror or Firefox, press Alt+F2 and enter konqueror or firefox.
With features like tabbed browsing, pop-up window blocking, and download and image management, both browsers combine the latest Web technologies. Their easy access to different search engines helps you find the information you need.
![]() |
Enter a URL in the location bar to start browsing. To open a new, empty tab, press Ctrl+T. To open a link in a new tab, click the link with your middle mouse button. Right-click the tab itself to access more tab options. You can create a new tab, reload one or all existing tabs, or close them. You can also change the sequence of the tabs by dragging and dropping them to the desired position.
Both browsers offer different kinds of search options: you can find information on the Web or you can search the current Web page for keywords.
Procedure 2.11. Searching the Web
To start a search on the Web, click the left icon in the search bar (located next to the location bar) to open a list of search engines.
Select the desired engine and type your search keywords into the input field.
Press Enter to start the search.
To search the current Web page with Firefox or Konqueror, press Ctrl+F to open a find bar at the bottom of the window. Enter your search keyword there and use the buttons beneath the bar to search in different directions or to configure search options such as .
Konqueror offers predefined Web shortcuts for quickly searching the Web.
For example, to search the Web for yast using the
Google search engine, just type gg: yast into the
Konqueror location bar (or the dialog)
and press Enter.
You can also define individual Web shortcuts in Konqueror and Firefox as described in Section 2.8.3, “Configuring Preferences”.
If you download a file with Firefox or Konqueror, a dialog window appears asking you if you want to save the file or to open it with a specific application. Also choose if to remember the action you selected for this type of file. By default, Firefox saves the file to the folder configured in the and shows your finished downloads in the dialog.
To open the downloaded files directly from there, right-click and select . To clean up the history of downloaded files, click .
Adjust preferences in Konqueror or Firefox. In Konqueror, access the configuration dialog with +. To change the behavior of Konqueror as Web browser, select one of the sub categories in the left sidebar to show the options for the relevant category. For example, you can “hide” Konqueror's real identity and make Konqueror identify as a different browser (for example, Internet Explorer*) for certain Web sites you visit. To do so, select , and click to add a new, site-specific identification.
![]() |
You might also want to configure the Web shortcuts you can use with Konqueror (and the dialog). In the Konqueror configuration dialog, click to see which shortcuts are already defined. Click to define new shortcuts. Leave the Konqueror configuration dialog with to apply your changes.
In Firefox, select + to open the . Click the icons in the upper display field to access the options for the relevant category. For example, change the default download folder on the page, or adjust the pop-up blocking feature on the page. Click to apply the changes.
To configure a Web shortcut for a search in Firefox, browse to the Web page with the desired search field. Right-click the search field and choose . Enter a and leave the dialog with .
When you enter a password in a KDE application for the first time (in
KMail or Konqueror, for example), you are asked if you want to store the
password. If you click , KWallet wizard starts by
default. KWallet is a password management tool that can collect all
passwords and store them in one or more encrypted files (called
wallets).
![]() |
To activate KWallet, select and click
. Select and enter a password.
This is your master password for the default wallet (named
kdewallet) that is created during the next step.
![]() | Protect Your KWallet Password |
|---|---|
If you forget your master password for any wallet, it cannot be recovered. Furthermore, anyone who knows your master password can obtain all information contained in the respective wallet. | |
Click to close the wizard. If you started the KWallet wizard initially from another application like Konqueror or KMail, KWallet will prompt you to enter the password once again in order to store the password for this application in the newly created wallet. After initial configuration you can open your wallet at any time to view, search, delete, or create entries. Normally you do not need to insert an entry manually. KDE recognizes if a resource requires authentication and KWallet starts automatically, prompting you for the KWallet password. However, you can add additional data if you wish. To configure any KWallet options, press Alt+F2 and enter kwalletmanager. In the that opens select +.
Whereas KWallet is designed to centrally manage passwords for several KDE applications, Firefox also offers the ability to store data when you enter a username and a password on a Web site. If you accept by clicking , the password will be stored on your hard disk in an encrypted format. The next time you access this site, Firefox will automatically populate the login fields.
To review or manage your passwords in Firefox, click +++.
For reading and managing your mails and appointments, you can use Kontact as your personal information management tool (PIM). Kontact combines KDE applications like KMail, KOrganizer, and KAddressBook into a single interface. This gives you easy access to your e-mails, calendar, address book, and other PIM functionality. Kontact can also manage multiple e-mail accounts.
To start Kontact, press Alt+F2 and enter kontact. To access one of its components like KMail, click the corresponding icon in the left sidebar.
![]() |
Before you can send or receive mails, you must configure an e-mail identity and account:
From the menu, select +.
In the left side pane under , click and select the identity that KMail has automatically created for you. it by entering your full name and e-mail address and confirming your changes.
Click in the left side pane under and at least one account on the tabs for and mails. (Optionally, you can configure multiple mail accounts).
Usually, the following information is required for both incoming and outgoing mail: , and . Depending on the account, you may also need to set encryption or authentication options. If you are not sure about the settings or items to select, consult your Internet Service Provider or system administrator.
Confirm the setup and leave the configuration dialog with .
To write a new mail, click the icon in the Kontact main window and press Ctrl+N to open the mail composer. After you have finished your mail, click to send it immediately. In case you have configured multiple e-mail accounts, keep the button pressed, then select the account from which you want to send the mail.
Kopete is an online messenger application that allows multiple partners connected to the Internet to chat with each other. Kopete currently supports a number of common messenger protocols, such as AOL* Instant Messenger (AIM), Gadu-Gadu, GroupWise® Messenger, ICQ, Jabber*, SMS, and Yahoo!*. To be able to use instant messaging (IM), you must register with a provider offering IM services and configure a Kopete account.
To start Kopete, press Alt+F2 and enter kopete. If started for the first time, click the wrench icon at the bottom of the Kopete window to create an account. Kopete guides you through the setup steps like selecting the messaging service, and entering the respective account information like user name or ID, server name and port and any authentication details like passwords. If you have not registered with the provider for the selected messaging service yet, click . In the browser window that opens, enter your user data to register. Switch back to Kopete and enter the data received on registration. Complete the configuration of your account by clicking .
If you decided to go online after configuring your account, you can now
add contacts in the main Kopete window. If the Kopete window shows
offline , first click ++ and enter your password if you
are prompted for it. After connecting, click + and
select the Kopete account for which you want to add contacts. Enter the
contact data or search for a contact and click .
To view all your contacts, even if they are offline at the moment, select +.
To start a chat with someone, click the desired contact and type your message in the lower part of the chat window. Press Enter to send the message. The upper part of the window displays the messages you have sent and received.
![]() |
The office suite LibreOffice offers a complete set of office tools, including word processor, spreadsheet, presentation, vector drawing, and database components. Because LibreOffice is available for a number of operating systems, you can use the same data across different computing platforms.
To start LibreOffice press Alt+F2 and enter libreoffice. To create a new document, select + and choose the type of document to create. To open an existing document, select and choose the appropriate file from the file system.
Find more information in the LibreOffice Quick Start.
Documents that need to be shared or printed across multiple platforms can be saved as PDF (Portable Document Format) files, for example, in the LibreOffice suite. View them with Okular, the default KDE document viewer.
Apart from PDF files, Okular allows you to view a great number of file formats, such as PostScript, several image formats, OpenDocument format (ODF), OpenDocument text (ODT), some eBook formats (ePub), and even Microsoft* Compiled HTML Help (CHM). Okular also provides support for bookmarks, annotations, form fields and multimedia content, and the rotation of pages.
Start Okular from the or press Alt+F2 and enter okular.
To open a document, select + and choose the desired file from the file system. Navigate through the document by using the navigation icons at the top or bottom of the window. Depending on which icon you click on the navigation panel on the left, the sidebar either shows a table of , a view of each page, the , or your for this file. To filter for any text listed in the sidebar or the overall document, enter a string into the input field at the top of the sidebar. If you want to select and copy text or images from the file in Okular, click the icon in the toolbar and select one of the options from the context menu. Click the icon to switch back to browsing the document.
Procedure 2.12. Working with Bookmarks and Annotations
With Okular, you can review a document by highlighting certain text parts or adding annotations or bookmarks that Okular then attaches to the file in the form of metadata. Note that the annotations and markers you add are not stored within the document, so you cannot print them or pass them on to other users.
To add a bookmark for a page, click the page in the sidebar or in the main display field and press Ctrl+B. The page is added to the list on the left sidebar. Right-click the bookmark entry to access a context menu for going to this bookmark or renaming, or removing it.
To create an annotation for a page, press F6 and select one of the annotation tools from the toolbar that appears. The annotation is added to the list of and is flagged with the login name of the user who created it. Use the icons at the bottom of the sidebar to group the annotations by page, by author or to show the annotations for the current page only.
![]() |
To open a pop-up note and add text for an annotation (or to remove an annotation), right-click the annotation entry in the list and select the corresponding menu item. The annotations or markers you added are automatically attached to the file, you do not need to save them.
If Acrobat Reader is not installed by default, install the
acroread package with YaST. To start Acrobat
reader, press Alt+F2 and enter acroread. Click +, locate
the desired PDF file and click to view the file.
KDE provides more than one application for finding data on your computer or in the file system. One application is KFind, which is described below.
To perform basic and advanced searches, use KFind. Start it from the by clicking + or press Alt+F2 and enter kfind.
Procedure 2.13. Searching by Name¶
To use a filename (or a part of it) as the search keyword, proceed as follows:
Enter the filename or a part of the filename in the
input field. Use wild cards, such as an
asterisk (*), to indicate missing characters in the
filename.
Specify the folder in which to search for the file. Either enter a path to the folder in or click to locate the folder.
To search subfolders, check .
Click to start the search. The results are displayed in the lower part of the dialog. To directly open the result, just click it. Right-click it to choose one of the options from the context menu.
Procedure 2.14. Searching by Contents or Properties¶
For a more detailed search, you can also specify further options, such as a text the file must contain or the creation or modification date of a file. To search for content or properties, proceed as follows:
On the tab, specify at least the path to search for the file. You can leave empty.
To search for certain content in a file, click the tab. In , enter the word or phrase the file to find must contain. This option does not work for all types of files.
To search for properties such as creation or modification date of the file, click the tab and choose the options you want.
![]() |
Click to start the search.
Strigi Desktop Search offers advanced search capabilities,by
additionally searching for metadata such as tags, ratings, and even
source URLs for downloads. It requires the services
nepomuk and
strigi to run. To activate
these services, press Alt+F2 and enter strigi.
Choose to start
the configuration dialog. Enable the two services on the tab
and leave the dialog by clicking
and .
Once activated, you can use KRunner (Alt+F2) to search for files by just typing a keyword. A more advanced search interface is available in the Dolphin file manager. Press Ctrl+F in Dolphin to activate the desktop search. You can filter the search results for , or location.
If you possess a CD or DVD writer, you can burn files to a CD or DVD with K3b. To create a data CD or DVD, proceed as follows:
Press Alt+F2 and enter k3b. K3b opens.
Select ++ from the main menu.
Use the tree view in the top left part of the window to search for the files or folders to burn. When they appear in the top right part of the window, drag and drop them into the window.
![]() |
Insert a writable CD or DVD into the device then click the icon.
Check the settings on the tab. Usually the defaults should work well for almost all files. If you wish, you can change more options (for example the ) on the tab.
Click .
With digiKam, it is easy to manage your digital images: download your images from the camera, edit and improve them, organize them in albums (or flag them with tags for easy retrieval, independent of folders or albums), archive them on CD or DVD, or export them to a Web image gallery.
digiKam also contains a set of useful batch functions and plug-ins, allowing you to convert multiple images to various different formats, rename multiple images, or automatically improve them with functions such as red eye reduction, speck removal, and hot pixel removal. Various filter and effects plug-ins help create works of art from your digital images.
To start digiKam, press Alt+F2 and enter digikam. On initial start-up, the first-run wizard appears to guide you through the setup.
![]() |
digiKam's main window contains a tree view on the left and shows thumbnails of the images on the right. For quick access to your images, use the sidebar on the left, which allows you to switch between different views, for example, sorting the images according to , , or . To enter digiKam's viewing and editing mode, double-click an image thumbnail.
KDE's Amarok music player allows you to play various audio formats, create playlists, listen to streaming audio broadcasts of radio stations on the Internet and subscribe to podcasts. The file types supported depend on the engine used for Amarok.
To start Amarok, press Alt+F2 and enter amarok. On first start, Amarok asks for the folders where to look for your music files.
![]() |
Amarok's main window shows a sidebar on the left providing different views: your local music collection, some addresses to listen to podcasts or streams from the Internet, your playlists and a file browser. The middle part, the context browser, displays information about the current track, the Wikipedia page of the artist and the song's lyrics by default. The right part of the window shows the current playlist. To play music, just drag and drop items from any of the sidebar browsers to the playlist area. Double-click an item in the playlist to start playback.
If your music files are properly tagged (containing at least information about the artist and album), you can make use of several nice Amarok features. To automatically retrieve the album cover images from Amazon, select + and click . The next time you play a track from this album, the cover is displayed in the context browser and on the on-screen display. To learn more about the artist, click on the button in the middle area to make Amarok search for the appropriate Wikipedia article.
To configure the use of another engine (or various other Amarok features), select +.
Log out (and leave the system running), restart or shut down the computer.
Click the button on your panel and select +. This ends your session but leaves the system running. To start a parallel session as a different user, select + instead.
Click , then select one of the following options:
Only available if your computer provides power management functionality. Pauses your computer without logging you out. All your data and the session data is saved to RAM.
Only available if your computer provides power management functionality. Pauses your computer without logging you out. All your data and the session data is saved to disk before the system is laid to rest. It is thus protected against data loss should you lose power in the meantime.
Restarts your computer.
Logs you out of the current session, then turns off the computer.
To learn more about KDE and KDE applications, also refer to http://www.kde.org/ and http://www.kde-apps.org/.
Contents
Abstract
openSUSE® provides the tools that Linux* users require in their daily activities. It comes with an easy-to-use graphical environment, the GNOME* desktop, that communicates with the underlying Linux system, to let you access and manage files, folders, and programs. openSUSE provides an integrated suite of applications for a wide range of office, multimedia, and Internet activities. The LibreOffice suite, which allows you to edit and save files in a number of formats, is also included. The office suite is available for several operating systems. Therefore, you can use the same data across different computing platforms.
When you start your system, you are usually prompted to enter your username and password. If someone else installed your system, check with your system administrator for your username and password.
After logging in to GNOME for the first time, you see the GNOME desktop, offering the following basic elements:
![]() |
Desktop Icons: Access programs and features on your system by double-clicking an icon. Right-click an icon to get additional menus and options. By default, the desktop features several key icons, including your personal folder and a trash can for deleted items. Other icons representing devices on your computer, such as CD drives or USB flash disks, may also be present on the desktop, and you can add as many icons on your desktop as you like. If you double-click your folder, the Nautilus file manager starts and displays the contents of your home directory.
Bottom Panel: The desktop includes a panel at the bottom of the screen. This panel contains the menu, the Tomboy Notes applet, a taskbar to display buttons for all currently running applications, and the system tray. You can also add applications and applets to the panel for easy access.
Main Menu: Click on the left side of the bottom panel to open the main menu. Commonly used applications appear in the main menu along with recently used applications. Click the button to display your recent documents, or click the button to display your favorite places (such as your home directory, your desktop, or available network servers). Click to access additional applications, listed in categories. Use the options on the right to access help, open the GNOME Control Center, run YaST, install additional software, lock your screen, log out of the desktop, shut down the system, or check the status of your hard drive and network connections.
System Tray: The right side of the bottom panel shows some smaller icons, including the system clock that displays the current date and time, the Workspace Switcher, the volume control, and icons for several other helper applications.
Taskbar: By default, all applications running on the current desktop are displayed in the taskbar (the area in the middle of the panel between the Computer button and the system tray). You can access these applications by clicking their names in the taskbar. Right-click the application's name to see options for moving, restoring, or minimizing the window.
Desktop Menu: Right-click an empty spot on the desktop to display a menu with various options. Click to create a new folder on the desktop. Use to create a launcher icon for an application. Provide the name of the application and the command for starting it, then select an icon to represent it. You can also change the desktop background, open a terminal, create a document, and align desktop icons.
The bottom panel can be customized to meet your individual needs, and additional panels can be added and configured to further personalize your desktop.
To add a new panel, right-click a blank space in the bottom panel and select . To delete a panel, right-click a blank space in the panel and select . openSUSE requires that at least one panel is left on the desktop.
Start programs from the or from the command line, using a shell or the . Additionally, you can start programs from the desktop or the panel by left-clicking the program icon once.
To run a program in openSUSE, click on the panel to open the main menu screen. If the program you want does not appear in the main menu screen, click to view a list of all available applications grouped in categories. You can also limit the list to show only applications with a specific name by entering all or part of the name into the field. Click an entry in the list to start the corresponding program.
![]() |
You can also add an icon to your panel that opens a more traditional version of the main menu. Right-click a blank space on the panel, select , then double-click .
If you already know the name of an application but are not sure how to start it from the main menu, use the field in the main menu. Click , type a portion of the application name in the field, then press Enter. If the application is installed on your system, the name of the application appears in the search dialog box. Click the name to start the program.
Press Alt+F2 to open the dialog. Type a command, for example, f-spot, and press Enter or click to start the application. The command to start the application is often (but not always) the application name written in lowercase.
![]() |
If you insert a CD or DVD into your drive or plug in a pluggable device (for example, a USB stick or removable hard disk), GNOME opens Nautilus and shows the content of the media.
Easily add, delete, and create shortcut icons on your desktop. You can also change icon properties and the desktop background to suit your needs.
Click .
Browse to the desired program.
Click and drag the icon to the desktop and position it as desired.
To delete an icon from your desktop, simply click the program icon and press the Delete key on your keyboard.
Right-click the background.
Select .
![]() |
To select a wallpaper from the pre-installed images, browse to and select the desired image. After you select it, the background changes automatically.
To add an image, select , browse to the desired image, then click .
To display a colored background, select the solid color rectangle from the top of the list; then, from , select the fill pattern and the desired colors.
Click .
In addition to letting you change individual desktop elements, GNOME lets you extensively personalize your desktop. You can find more settings to adjust the overall appearance and behavior of your desktop in the GNOME Control Center. There, you can also change fonts, keyboard and mouse configurations, regional and language settings, parameters for your Internet and network usage, and more.
To start the Control Center, click , then click on the right of the main menu.
![]() |
If your computer supports a 3D graphics card with Xgl, you can use graphical effects like turning your desktop into a rotating 3D cube, enabling translucent or transparent windows, and zooming in and out of the desktop screen. You can also use other window effects such as shadows, fading, and transformations. If you do not have a 3D graphics card, some effects may be disabled or reduce the performance of your system. If the performance of your system is too low, disable the compositing effect for your current session with Alt+Shift+F12.
![]() |
To configure the effects on your desktop, proceed as follows:
Start the personal settings window as described in Section 3.4.3, “Using the GNOME Control Center”.
Select + and choose . If your graphic card does not support 3D, you will be notified.
Select the effects in one of the tabs.
The desktop environment allows you to organize your programs and tasks on several virtual desktops. If you often run a lot of programs simultaneously, this minimizes the number of windows to arrange on your screen. You might, for example, use one desktop for e-mailing and calendaring and another for word processing and graphics applications.
Procedure 3.1. Moving an Application to Another Virtual Desktop¶
You can display a running application on one or all virtual desktops, or move it to other desktops.
Open the application.
Right-click the title bar of the application.
Click .
Select the desktop on which to place the application.
To switch between desktops, click the desired desktop in the pager in the panel.
Procedure 3.2. Adding Additional Virtual Desktops¶
Some users might need more desktops than are provided by default. To add additional desktops, do the following:
Right-click the pager in the panel and select . A configuration dialog appears:
![]() |
Decrease or increase the .
If you want to change the names of the desktops double click on the list entries and enter the new names.
Use the Nautilus File Manager to create and view folders and documents, run scripts, and create CDs of your data. To open Nautilus, double-click your home directory icon on the desktop. You see the contents of your home directory.
![]() |
The elements of the Nautilus window include the following:
Menu. Lets you perform most tasks.
Toolbar. Lets you quickly navigate among files and folders, and provides access to files and folders.
Location Bar. Lets you locate files, folders, and URI sites. If you prefer text based location display to the button based one, select +.
Side Pane. Lets you navigate or display information about the selected file or folder. Use the drop-down list to customize what is shown in the pane. The list includes ways to view information about files, perform actions on files, attach emblems to files, view a history of recently visited sites, and display your files in the tree system.
View Pane. Displays folders and files. Use the options on the menu to increase or decrease the size of content in the view pane and to display items as a list or as icons.
Status Bar. Displays the number of items in a folder and gives the available free space. When a file is selected, the status bar displays the filename and size.
If you have files you have not used recently but want to keep on your computer, you can compress the files into a tape archive (TAR) format.
In the Nautilus view pane, right-click the folder you want to archive and select .
![]() |
Accept the default archive filename or provide a new name.
Select a file extension from the drop-down list. Use
tar.gz for the most common archive form. Use
zip if you need to protect the archive with a
password.
Specify a location for the archive file, then click .
To extract an archived file, right-click the file and select .
Use the Nautilus bookmarks feature to mark your favorite folders.
Open the folder you want to create a bookmark for.
Click +. The bookmark is added to the list, with the folder name as the bookmark name.
To select an item from your bookmarks list, click , then click the desired bookmark in the list.
You can also organize your bookmarks list by clicking + and making your selections in the dialog box.
![]() |
To change the order of your bookmarks, click a bookmark shown in the dialog and drag it to the desired location.
Firefox* is one of the most popular Web browsers. It has all the familiarity of other browsers, plus added features such as security and privacy tools.
![]() |
To start Firefox, click +.
With features like tabbed browsing, pop-up window blocking, and download and image management, Firefox combines the latest Web technologies. Its easy access to different search engines helps you find the information you need. Enter a URL in the location bar to start browsing.
To open a new empty tab in Firefox, press Ctrl+T or the “+” button next to the last tab . Type a new URL to browse. To open a link in a new tab, click the link with your middle mouse button. Right-click a tab to access more tab options. You can create a new tab, reload one or all existing tabs, or close a single tab or all tabs. You can also change the sequence of the tabs by dragging and dropping them to a new position.
To start a search on the Web type your search keywords in the integrated search box on the right of the location bar, then press Enter. The results are displayed in the active window or tab.
To use a different search engine than the default, click the icon in the search box to open a list of other search engines.
Click the desired engine, then press Enter to start the search.
To search the current Web page for words, press Ctrl+F to open the bar at the bottom of the window. Enter your search keyword there and use the buttons to the right of the box to search in different directions or to select all hits in the text.
If you download a file with Firefox, the Firefox download manager starts
and saves this file to the folder configured in Firefox
. By default, the
Downloads folder in your home directory is the
destination for downloaded files. Firefox shows your finished downloads
in the window.
![]() |
Open the downloaded files directly from the window or from the destination folder. To clean up the history of downloaded files, click .
To adjust the default download folder or to activate or modify the pop-up blocking feature, click +.
![]() |
Here also configure many other settings such as appearance, language, privacy, and tab options. Click the icons and set the options on each page according to your preferences. Click to apply the changes.
GNOME allows you to store your passwords and encryption keys in a keyring. This is useful if you want to store passwords for different web sites.
To create a new keyring, proceed as follows:
Press Alt+F2 and enter seahorse.
Select +.
Choose and proceed with .
Enter a name for your keyring. Then, a dialog box opens.
Enter your password, confirm the password, and click .
You can create as many keyrings as you like. For example, you can create one for private and one for business. To store passwords in your keyring, proceed as follows:
Press Alt+F2 and enter seahorse.
Select +.
Choose and proceed with .
Select your keyring, enter description and password.
Finish with .
For reading and managing your mail and events, openSUSE offers you Evolution™, a groupware program that makes it easy to store, organize, and retrieve your personal information.
Evolution seamlessly combines an e-mail, a calendar, an address book, and a task list in one easy-to-use application. With its extensive support for communications and data interchange standards, Evolution can work with existing corporate networks and applications, including Microsoft* Exchange.
![]() |
To start Evolution, click +.
The first time you start it, Evolution prompts you with a few questions as it sets up a mail account and helps you import mail from your old mail client. It shows you how many new messages you have and lists upcoming appointments and tasks, as well as the current weather and news from news feeds. The calendar, address book, and mail tools are available in the shortcut bar on the left.
Press Ctrl+N to open a new item for whatever part of Evolution you are working in. In mail, this creates a new message. If you are in the address book, Ctrl+N creates a new contact card, and in the calendar, it creates a new appointment.
For more information on using Evolution, click + in any Evolution window.
Empathy is a multiprotocol instant messaging (IM) client. It is compatible with AOL* Instant Messenger (AIM), Google Talk, GroupWise® Messenger, ICQ, IRC, MSN Messenger, Jabber/XMPP, Yahoo!*, and other networks.
With Empathy, you can log in to multiple accounts on multiple IM networks simultaneously. Empathy also supports many features of the various networks, such as video chat, file transfer, away messages, and typing notification.
To start Empathy, click +++, or press Alt+F2 and enter empathy.
To add an account to Empathy, either use the initial configuration wizard, or select +. Click and select the protocol you want to use, and type your login information in the appropriate fields. Click to activate you IM account. Finally click to start chatting with your friends.
Add contacts by clicking +. Select account, identifier and alias information relevant for the new contact and confirm with . However, you must be online and connected to the selected messaging service to add a contact to your list.
To start a chat, double-click the desired contact and type your message in the lower part of the chatting window. Press Enter to send the message. The upper part of the window displays the messages you have sent and received.
The LibreOffice office suite offers a complete set of office tools, including word processing, spreadsheet, presentation, vector drawing, and database components. Because LibreOffice is available for a number of operating systems, you can use the same data across multiple platforms.
To start LibreOffice, click +. To create a new document, click +, then choose the type of document you want to create. To open an existing document, click , then select the file you want from the file system.
Documents that need to be shared or printed across platforms are often distributed as PDF (Portable Document Format) files. PDF files can be created using the LibreOffice suite or other applications. The GNOME PDF viewer is called Evince. It can be used to view PDFs and many other document formats, like PostScript, DjVu, DVI, and multi-page TIFFs.
To start Evince, press Alt+F2 and enter evince .
GNOME provides more than one application for finding data on your computer or in the file system.
To locate files or programs on your computer, click . Enter a search term in the field and press Enter. The results are displayed in the .
You can also start the Needle application by clicking +++.
GNOME Do describes itself as an “intelligent launcher that makes performing common tasks on your computer simple and efficient.” It is extensible with plug-ins.
Start it by pressing Super+Space. The Super is normally located on the left and right Windows or Penguin key.
GNOME Do allows you to perform specific actions. For example, if you
type b, it displays a starter button for the Banshee,
the music player:
![]() |
To customize GNOME Do to your needs, select the arrow button on the upper-right corner of the window and select . It gives you a list of plug-ins to search for mails in Evolution, listen to your music, etc.
![]() |
If your system has a CD or DVD writer, use the Nautilus file manager to burn CDs and DVDs.
Click +++, or just insert a blank disk.
Copy the files and folders you want to put on the CD or DVD into the Nautilus window.
![]() |
Click .
Modify the relevant information in the dialog box, or accept the default values, then click . The files are burned to the disk. This could take a few minutes, depending on the amount of data being burned and the speed of your burner.
You can also use the more advanced burning tool Brasero, or Banshee to burn data and audio CDs.
F-Spot is a management tool for your collection of digital images, tailored for the GNOME desktop. It allows you to assign different tags to your images in order to categorize them, and offers various image editing options. For example, you can remove red-eye, crop, and adjust brightness and colors. F-Spot supports all important image formats, including JPEG, PNG, TIFF, and several vendor specific RAW formats.
You can import photos from your hard drive, your digital camera, or your iPod. You can also use F-Spot to create photo CDs, generate a Website gallery, or export your photos to your Flickr, 23, Picasa Web, or SmugMug account.
To access F-Spot, click + or press Alt+F2 and enter f-spot. The first time you run F-Spot, you must define the location from where you want to import images into your collection. If you already have a collection of images stored on your hard drive, enter the path to the directory and (optionally) include subfolders. F-Spot imports these images into its database.
![]() |
Thumbnails of your images are displayed in the right part of the window, and detailed information for a selected image is displayed in a sidebar to the left. By default, your photos are displayed in reverse-chronological order, so your newest photos are always at the top. You can sort your photos in chronological order or reverse-alphabetical order by clicking +.
A menu bar at the top of the window allows you to access the main menus. A toolbar below offers several different functions depicted by a matching icon.
Use Banshee to import CDs, sync your media collection to a digital media player, play music directly from a digital media player, create playlists with songs or videos from your library, create audio and data CDs from subsets of your library, and subscribe to, download, and listen to your favorite podcasts. Banshee also has an Internet Radio plug-in that allows you to listen to audio streams.
To open Banshee, click + or press Alt+F2 and enter banshee-1.
When you start Banshee for the first time, you need to import your media to make them available in the library. To do so, select + from the menu. Choose an import source and click . After successfully importing your media, you can access them from your library.
![]() |
To play a song or a movie, simply select it in the library and click the play button. You can also use the buttons in the upper left corner to pause a song or play the next or previous song. Use the loudspeaker button on the right to adjust the volume.
Banshee also has an integrated CD player. When you insert a music CD, your CD title appears in the left panel. Select the title and click the button to play your full CD.
To create audio and MP3 CDs, select the songs you want, then click the + from the menu.
When you are finished using the computer, you can log out and leave the system running, or restart or shut down the computer.
Click +, then select one of the following options:
Log out. Logs you out of the current session and returns you to the login screen.
Switch User. Suspends your session, allowing another user to log in and use the computer.
Click +, then select one of the following options:
Shutdown. Logs you out of the current session, then turns off the computer.
Restart. Logs you out of the current session, then restarts the computer.
Suspend. Puts your computer in a temporary state that conserves power. The state of your session is preserved, however, including all applications you have running and all documents you have open.
Hibernate. Suspends your session, using no power until the computer is restarted. The state of your session is preserved, however, including all applications you have running and all documents you have open.
To learn more about GNOME and GNOME applications, refer to http://www.gnome.org/.
Contents
Abstract
LibreOffice—formerly known as OpenOffice.org—is a powerful open-source office suite that provides tools for all types of office tasks such as writing texts, working with spreadsheets, creating graphics and presentations, or designing scientific formulas. With LibreOffice, you can use the same data across different computing platforms. You can also open and edit files in other formats, including Microsoft Office, then save them back to this format.
For a full list of new core features available with LibreOffice 3.4, refer to http://www.libreoffice.org/download/3-4-new-features-and-fixes/.
LibreOffice can work with documents, spreadsheets, presentations, and databases in many other formats, including Microsoft Office™. They can be seamlessly opened like other files and saved back to the original format. Though some work has already been invested in interoperability, occasionally there are still formatting issues. If you have problems with your documents, consider opening them in the original application and resaving them in an open format such as RTF for text documents. In case of migration problems with spreadsheets however, it is advisable to resave them as Excel files and use this as intermediate format (with CSV format you would lose all cell formatting and CSV sometimes leads to incorrect cell type detection for spreadsheets).
LibreOffice consists of several application modules (subprograms), which are designed to interact with each other. All modules feature the same graphical user interface and similar functionality.
Table 4.1. The LibreOffice Modules¶
|
Module |
Usage |
|---|---|
|
Writer |
Text document module |
|
Calc |
Spreadsheet module |
|
Impress |
Presentation module |
|
Base |
Database module |
|
Draw |
Vector graphics module |
|
Math |
Mathematical equation module |
A number of new improvements common to all LibreOffice modules were introduced since the last openSUSE release. Here are the most notable ones:
A unified search toolbar is now present in each LibreOffice module to ease searching for a text string within open documents. You can toggle the toolbar with ++.
If no package with help information
(libreoffice-hell-*) is installed, LibreOffice tries to
view the relevant help page online in a Web browser.
The dialog has been reworked to include useful features, such as simple page preview and pages per sheet option, in one place.
The new dialog improved in usability so that it is now easier to find similar or related terms to make the documents language more vivid.
LibreOffice modules can now import RGBA TIFF images with their alpha channel information.
![]() |
To start the LibreOffice suite, press Alt+F2, type libreoffice and press Enter. In the dialog, select the module you want to open. If an LibreOffice application is open, you can start any of the other applications by clicking ++.
To save a new file, select + or from the or use the shortcut Ctrl+Shift+S.
Select the directory where you want to save the file.
Enter the filename in the box.
From the box, select the format in which you want to save the file.
In all modules you can save your documents as native LibreOffice files, LibreOffice templates, Microsoft files and StarOffice files.
The tool displays information about the contents of a document. It also lets you quickly jump to different elements. For example, you can use the Navigator to get a quick overview of all images included in the document. To open the , click + or with F5. The elements listed in the vary according to the LibreOffice module being used.
You can also navigate your files with the following shortcuts:
Table 4.2. Navigation Shortcuts
|
Action |
Shortcut |
|---|---|
|
Delete to the End of the Word |
Ctrl+Del |
|
Delete to the Beginning of the Word |
Ctrl+<— |
|
End of Document |
Ctrl+End |
|
End of Line |
End |
|
Select All |
Ctrl+A |
|
Start of Line |
Home |
|
Top of Document |
Ctrl+Home |
|
Word Left |
Ctrl+← |
|
Word Right |
Ctrl+→ |
LibreOffice comes with a set of predefined templates, and you can find additional templates on the Internet. If you want to create your own templates, you need to determine what you want the document to look like and create the styles you need in that template.
For text document, spreadsheets, presentations, and drawings, you can easily create a template from an existing document as follows:
Start LibreOffice and open or create a document that contains the styles that you want to use as a template.
Click ++.
Specify a name for the template.
In the box, click the category where you want to place the template.
Click .
LibreOffice Writer is a full-featured word processor with page and text-formatting capabilities. It also includes some features that are usually found only in expensive desktop publishing applications. Many of the LibreOffice Writer features apply also to other LibreOffice modules.
LibreOffice Writer allows you to create a new document in one of the following ways:
From Scratch. To create a document from scratch, click ++ and a new empty Writer document is created.
Wizard. To use a standard format and predefined elements for your own documents use a wizard. Click ++ and follow the steps.
Templates.
To use a template, click ++ and choose one of the many folders (for example,
Business Correspondence) and a new document
based on the style of your selected template is created.
To use a standard format and predefined elements for your own documents, try a wizard (a small utility that lets you make some basic initial decisions and then produces a ready-made document from a template). For example, to create a business letter, click ++. With the wizard's dialogs, you can create a basic document that uses a standard format.
Enter text in the document window as desired. Use the toolbar or the menu to adjust the appearance of the document. Use the menu or the relevant buttons in the toolbar to print and save your document. With the options under , add extra items to your document, such as a table, picture, or chart.
With LibreOffice you can customize the default settings with the menu.
Below is a list of the most popular options available in most modules:
To set all character elements at the same time, select +.
To format paragraphs, select + and select the appropriate tabs for making changes.
To modify the alignment, select + and choose the alignment you want.
If you want to add headers and footers, click and select either or .
If you want to insert special characters, select +.
If you want to insert footnotes, click and select .
If you want to insert columns, click and select . Then in the tab, specify the number of columns to use for the current section.
If you want to insert indexes or a table of contents, click and select .
The offers additional text formatting options.
If you want to comment your text for others or for yourself, click +.
![]() |
If you are working with a very large document (such as a book), you might find it easier to manage the book with a master document, rather than keeping the book in a single file. A master document enables you to quickly apply formatting changes to a large document or to jump to each subdocument for editing.
A master document is a Writer document that serves as a container for multiple Writer files. You can maintain chapters or other subdocuments as individual files collected in the master document. Master documents are also useful if multiple people are working on a document. You can separate each person’s relevant part of the document into subdocuments, allowing multiple writers to work on their subdocuments at the same time without the danger of overwriting each other’s work.
Click +.
or
Open an existing document and click ++.
Insert subdocuments.
Click .
The LibreOffice help files contain more complete information about working with master documents. Look for the topic entitled .
In addition to being a full-featured word processor, Writer also functions as an HTML editor. Writer includes HTML tags that can be applied the same way as any other style in a Writer document. You can view the document as it will appear online, or you can directly edit the HTML code.
Click ++.
Press to open the window.
Click the arrow at the bottom of the .
Select .
Create your HTML document, using the styles to tag your text.
Click +.
Select the location where you want to save your file, name the file, and select HTML Document (.html) from the list.
Click .
If you prefer to edit HTML code directly, or if you want to see the HTML code created when you edited the HTML file as a Writer document, click +. In HTML Source mode, the Formatting and Styles list is not available. The first time you switch to HTML Source mode, you are prompted to save the file as HTML, if you have not already done so.
You can include tabular data in the Writer, Impress and Draw module. Insert basic tables directly into your document either with the following menus items or by using the toolbar:
+,
++,
or use the icon.
![]() |
To enter data, select a cell with your mouse pointer and begin typing. To move around cells, use the arrow keys. →| moves to the next cell, skipping over the contents of the cell and Shift+→| moves backwards.
You can use menu or the toolbar to modify the table.
Calc is the LibreOffice spreadsheet and data-plotting module. Spreadsheets consist of a number of sheets, containing cells which can be filled with elements like text, numbers, or formulas. A formula can manipulate data from other cells to generate a value for the cell into which it is inserted. Calc also allows you to define ranges, filter and sort the data, or create charts from the data to present it graphically. By using DataPilots, you can combine, analyze or compare larger amounts of data.
As with the entire LibreOffice suite, Calc can be used across a variety of platforms. It provides a number of exchange formats (including export to PDF documents), and can also read and save files in Microsoft Excel's format.
![]() |
Start LibreOffice and select ++ to create a new spreadsheet. Access the individual sheets by clicking the respective tabs at the bottom of the window.
Enter data in the cells as desired. To adjust appearance, either use the toolbar or the menu—or define styles. Use the menu or the relevant buttons in the toolbar to print and save your document.
Calc comes with a few built-in cell and page styles to improve the appearance of your spreadsheets and reports. Although these built-in styles are adequate for many uses, you will probably find it useful to create styles for your own frequently-used formatting preferences.
Besides LibreOffice Writer and LibreOffice Calc, LibreOffice also includes the modules Impress, Base, Draw, and Math. With these you can create presentations, design databases, draw up graphics and diagrams and create mathematical formulas.
Use LibreOffice Impress to create presentations for screen display or printing, such as slide shows or transparencies. If you have used other presentation software, you can move comfortably to Impress, which works very similarly to other presentation software.
Impress can open and save Microsoft Powerpoint presentations, which means you can exchange presentations with Powerpoint users, as long as you save your presentations in Powerpoint format.
LibreOffice allows you to use 3D transitions for your slides. Access the available transitions by selecting +.
You can either create a brand new presentation (without any preformatted slides) or use an existing template or presentation for your new document. Impress uses styles and templates the same way other LibreOffice modules do. A wizard leads you through the options available for creating new presentations.
![]() |
LibreOffice includes a database module (Base). Use Base to design a database to store many different kinds of information, from a simple address book or recipe file to a sophisticated document management system.
Tables, forms, queries, and reports can be created manually or using convenient wizards. For example, the Table Wizard contains a number of common fields for business and personal use. A wizard guides you through the steps to create a new database.
LibreOffice Base comes with several predefined database fields to help you create a database. A wizard guides you through the steps to create a new database. The following steps are specific to creating an address book using predefined fields, but it should be easy to use the predefined fields for any of the built-in database options. The process for creating a database can be broken into several subprocesses:
Procedure 4.3. Creating a Database
Click ++.
Select Create a new database .
Click to make your database information available to other LibreOffice modules, select both check boxes in the bottom half of the dialog, then click .
Browse to the directory where you want to save the database, specify a name for the database, then click .
Procedure 4.4. Setting Up the Database Table
In the , click .
The list changes to show the predefined tables for personal use. If you had clicked , the list would contain predefined business tables.
In the list, click . The available fields for the predefined address book appear in the menu.
In the menu, click the fields you want to use in your address book.
You can select one item at a time, or you can shift-click multiple items to select them.
Click the single arrow icon to move the selected items to the menu.
To move all available fields to the menu, click the double right- arrow.
Use the arrow keys to adjust the order of the selected fields.
The fields appear in the table and forms in the order in which they are listed.
![]() |
Use LibreOffice Draw to create graphics and diagrams. You can save your drawings in today’s most common formats and import them into any application that lets you import graphics, including the other LibreOffice modules. You can also create Flash versions of your drawings.
LibreOffice allows you to import Scalable Vector Graphics (*.svg) and WordPerfect Graphics (*.wpg). Select + and use the drop-down list to view which file formats can be opened.
Procedure 4.5. Creating a Graphic
Click Alt+F2 and enter oodraw to open LibreOffice Draw.
Use the toolbar at the bottom of the window to create a graphic.
Save the graphic.
To embed an existing Draw graphic into an LibreOffice document, select ++. Select and click to navigate to the Draw file to insert. If you insert a file as OLE object, you can easily edit the object later by double-clicking it.
Procedure 4.6. Opening Draw From Other LibreOffice Modules
One particularly useful feature of Draw is the ability to open it from other LibreOffice modules so you can create a drawing that is automatically imported into your document.
From an LibreOffice module (for example, from Writer), click ++++. This opens Draw.
Create your drawing.
Click in your document, outside the Draw frame.
The drawing is automatically inserted into your document.
It is usually difficult to include complex mathematical formulas in your documents. The LibreOffice Math equation editor lets you create formulas using operators, functions, and formatting assistants. You can then save those formulas as objects that can be imported into other documents. Math functions can be inserted into other LibreOffice documents like any other graphic object.
Using Math, you can enter your equation in three different ways:
Type markup in the equation editor,
Right-click on the equation editor and select the symbol from the context menu,
or
Select a symbol from the .
![]() | |
Math is not a calculator. The functions it creates are graphical objects. Even if they are imported into Calc, these functions cannot be evaluated. | |
LibreOffice also contains extensive online help. In addition, a large community of users and developers support it. For more details, see the following links:
A list of all new features available with LibreOffice.
Official LibreOffice support page, provides manuals and other documentation
Taming LibreOffice: Books, news, tips and tricks.
Contents
Contents
Abstract
Use YaST's software management tool to search for software components you want to add or remove. YaST resolves all dependencies for you. To install packages not shipped with the installation media, add additional software repositories to your setup and let YaST manage them. Keep your system up-to-date by managing software updates with the update applet.
Change the software collection of your system with YaST Software Manager. This YaST module is available in three toolkit flavors: Qt (for KDE desktops), GTK+ (for GNOME desktops), and ncurses (providing a pseudo-graphical user interface in text mode). This chapter describes Qt and GTK+ flavors—for details on the ncurses YaST, see Chapter 12, YaST in Text Mode.
![]() | Changing the Toolkit Flavor |
|---|---|
By default, YaST is started with the toolkit matching your desktop
(GTK+ under GNOME, Qt under KDE). To alter this default setting
system-wide, change the variable
If you do not want to change the system-wide settings, you can
nevertheless start YaST in the desired flavor from command line by
using the | |
![]() | Confirmation and Review of Changes |
|---|---|
When installing, updating or removing packages, any changes in the Software Manager are not applied immediately but only after confirming them with or respectively. YaST maintains a list with all actions, allowing you to review and modify your changes before applying them to the system. | |
A local or remote directory containing packages, plus additional information about these packages (package meta-data).
A short name for a repository used by various zypper commands. The alias can be chosen by the user when adding a repository and must be unique.
Represents a whole product, for example openSUSE®.
A pattern is an installable group of packages dedicated to a certain
purpose. For example, the Laptop pattern
contains all packages that are needed in a mobile computing
environment. Patterns define package dependencies (such as required or
recommended packages) and come with a preselection of packages marked
for installation. This ensures that the most important packages needed
for a certain purpose are available on your system after installation
of the pattern. However, not necessarily all packages in a pattern are
preselected for installation and you can manually select or deselect
packages within a pattern according to your needs and wishes.
A package is a compressed file in rpm format that
contains the files for a particular program.
A patch consists of one or more packages and may be applied by means of deltarpms. It may also introduce dependencies to packages that are not installed yet.
An generic term for product, pattern, package or patch. The most commonly used type of resolvable is a package or a patch.
A deltarpm consists only of the binary diff between two defined versions of a package, and therefore has the smallest download size. Before being installed, the full RPM package is rebuilt on the local machine.
Certain packages are dependent on other packages, such as shared
libraries. In other terms, a package may require
other packages—if the required packages are not available, the
package cannot be installed. In addition to dependencies (package
requirements) that must be fulfilled, some packages
recommend other packages. These recommended
packages are only installed if they are actually available, otherwise
they are just ignored and the package recommending them is installed
nevertheless.
The YaST Qt interface is started by default when using the desktops KDE, icewm, and others. It is also used when invoking YaST from a remote terminal. Start the software manager from the YaST Control Center by choosing +.
![]() |
The YaST software manager can install packages or patterns from all currently enabled repositories. It offers different views and filters to make it easier to find the software you are searching for. The view is the default view of the window. To change view, click and select one of the following entries from the drop-down list. The selected view opens in a new tab.
Lists all patterns available for installation on your system.
Lists all packages sorted by groups such as , , or .
Lists all packages sorted by functionality with groups and subgroups. For example ++.
Filter to list all packages needed to add a new system language.
Filter to list packages by repository. In order to select more than one repository, hold the Ctrl key while clicking on repository names. The “pseudo repository” lists all packages currently installed.
Lets you search for a package according to certain criteria. Enter a search term and press Enter. Refine your search by specifying where to and by changing the . For example, if you do not know the package name but only the name of the application that you are searching for, try including the package in the search process.
If you have already selected packages for installation, update or removal, this view shows the changes that will be applied to your system as soon as you click . To filter for packages with a certain status in this view, activate or deactivate the respective check boxes. Hit Shift+F1 for details on the status flags.
![]() | Finding Packages not Belonging to an Active Repository |
|---|---|
To list all packages that do not belong to an active repository, choose ++ and then choose +. This is useful, for example, if you have deleted a repository and would like to make sure no packages from that repository remain installed. | |
Certain packages are dependent on other packages, such as shared libraries. On the other hand, some packages cannot coexist with others on the system. If possible, YaST automatically resolves these dependencies or conflicts. If your choice results in a dependency conflict that cannot be automatically solved, you need to solve it manually as described in Section 5.2.4, “Checking Software Dependencies”.
![]() | Removal of Packages |
|---|---|
When removing any packages, by default YaST only removes the selected packages. If you want YaST to also remove any other packages that become unneeded after removal of the specified package, select +. | |
Search for packages as described in Section 5.2.1, “Views for Searching Packages or Patterns”.
The packages found are listed in the right pane. To install a package or remove it, right-click it and choose or . If the relevant option is not available, check the package status indicated by the symbol in front of the package name—hit Shift+F1 for help.
![]() | Applying an Action to All Packages Listed |
|---|---|
To apply an action to all packages listed in the right pane, choose an action from +. | |
To install a pattern, right-click the pattern name and choose .
It is not possible to remove a pattern per se. Instead, select the packages of a pattern you want to remove and mark them for removal.
In order to select more packages, repeat the steps mentioned above.
Before applying your changes, you can review or modify them by clicking +. By default, all packages that will change status, are listed.
In order to revert the status for a package, right-click the package and select one of the following entries: if the package was scheduled to be deleted or updated, or if it was scheduled for installation. To abandon all changes and close the Software Manager, click and
When you are finished, click to apply your changes.
In case YaST found dependencies on other packages, a list of packages that have additionally been chosen for installation, update or removal is presented. Click to accept them.
After all selected packages are installed, updated or removed, the YaST Software Manager automatically terminates.
![]() | Installing Source Packages |
|---|---|
Installing source packages with YaST Software Manager is not possible at the moment. Use the command line tool zypper for this purpose. For more information, see Section 9.1.2.1, “Installing Source Packages”. | |
Instead of updating individual packages, you can also update all installed packages or all packages from a certain repository. When mass updating packages, the following aspects are generally considered:
priorities of the repositories that provide the package,
architecture of the package (for example, x86_64, i686, i586),
version number of the package,
package vendor.
Which of the aspects has the highest importance for choosing the update candidates depends on the respective update option you choose.
To update all installed packages to the latest version, choose ++ from the main menu.
All repositories are checked for possible update candidates, using the following policy: YaST first tries to restrict the search to packages with the same architecture and vendor like the installed one. If the search is positive, the “best” update candidate from those is selected according to the process below. However, if no comparable package of the same vendor can be found, the search is expanded to all packages with the same architecture. If still no comparable package can be found, all packages are considered and the “best” update candidate is selected according to the following criteria:
Repository priority: Prefer the package from the repository with the highest priority.
If more than one package results from this selection, choose the one with the “best” architecture (best choice: matching the architecture of the installed one; otherwise: x86_64 > i686 > i586).
If the resulting package has a higher version number than the installed one, the installed package will be updated and replaced with the selected update candidate.
This option tries to avoid changes in architecture and vendor for the installed packages, but under certain circumstances, they are tolerated.
![]() | Update Unconditionally |
|---|---|
If you choose ++ instead, basically the same criteria apply but candidate package found is installed unconditionally. Thus, choosing this option might actually lead to downgrading some packages. | |
To make sure that the packages for a mass update derive from a certain repository:
Choose the repository from which to update as described in Section 5.2.1, “Views for Searching Packages or Patterns” .
On the right hand side of the window, click . This explicitly allows YaST to change the package vendor when replacing the packages.
As soon as you proceed with , all installed packages will be replaced by packages deriving from this repository, if available. This may lead to changes in vendor and architecture and even to downgrading some packages.
To refrain from this, click . Note that you can only cancel this until you press the button.
Before applying your changes, you can review or modify them by clicking +. By default, all packages that will change status, are listed.
If all options are set according to your wishes, confirm your changes with to start the mass update.
Most packages are dependent on other packages. If a package, for example, uses a shared library, it is dependent on the package providing this library. On the other hand some packages cannot coexist with each other, causing a conflict (for example, you can only install one mail transfer agent: sendmail or postfix). When installing or removing software, the Software Manager makes sure no dependencies or conflicts remain unsolved to ensure system integrity.
In case there exists only one solution to resolve a dependency or a conflict, it is resolved automatically. Multiple solutions always cause a conflict which needs to be resolved manually. If solving a conflict involves a vendor or architecture change, it also needs to be solved manually. When clicking to apply any changes in the Software Manager, you get an overview of all actions triggered by the automatic resolver which you need to confirm.
By default, dependencies are automatically checked. A check is performed every time you change a package status (for example, by marking a package for installation or removal). This is generally useful, but can become exhausting when manually resolving a dependency conflict. To disable this function, uncheck +. Manually perform a dependency check with +. A consistency check is always performed when you confirm your selection with .
To review a package's dependencies, right-click it and choose . A map showing the dependencies opens. Packages that are already installed are displayed in a green frame.
![]() | Manually Solving Package Conflicts |
|---|---|
Unless you are very experienced, follow the suggestions YaST makes when handling package conflicts, otherwise you may not be able to resolve them. Keep in mind that every change you make, potentially triggers other conflicts, so you can easily end up with a steadily increasing number of conflicts. In case this happens, the Software Manager, all your changes and start again. | |
The YaST GTK+ interface is started by default when using the desktops GNOME and XFCE. Start the software manager from the YaST Control Center by clicking +.
![]() |
The easiest way to find a package is to use the search field in the upper right corner of the software manager. Enter a search term and press Enter. By default it will search package names and summaries. Press the search item to change this filter and search the file lists, for example.
The software manager also offers different views and filters for displaying package lists. These are available from the pull-down menu in the upper left corner:
The default view lists all packages sorted by groups such as , , , or .
Lists all packages sorted by functionality with groups and subgroups. For example ++.
Filter to list packages by repository. In order to select more than one repository, hold the Ctrl key while clicking on repository names. The “pseudo repository” lists all packages currently installed.
To add, edit, or remove available repositories, click .
Lists all patterns available for installation on your system.
Filter to list all packages needed to add a new system language.
The box in the lower right corner of the dialog also allows to filter for packages that are , or . If you select the entry, all available packages from the configured repositories are displayed, independent of their status.
Certain packages are dependent on other packages, such as shared libraries. On the other hand, some packages cannot coexist with others on the system. If possible, YaST automatically resolves these dependencies or conflicts. If your choice results in a dependency conflict that cannot be automatically solved, you need to solve it manually as described in Section 5.2.4, “Checking Software Dependencies”.
Search for packages as described in Section 5.3.1, “Views for Searching Packages or Patterns”.
The packages found are listed in the right pane. To further filter the search results according to package status (, , , , select one of the entries in the box at the lower left corner of the dialog. For details about a package, click the package in the list. Information like available versions, authors and changelog of the package are displayed in the lower right corner of the window.
To mark a package for installation, re-installation, removal, or upgrade, right-click the package and choose the appropriate action from the menu.
![]() | Applying an Action to All Packages Listed |
|---|---|
To apply an action to all packages listed in the right pane, right-click a package, choose , right-click again and choose an action. | |
To install a pattern, right-click the pattern name and choose .
It is not possible to remove a pattern per se. Instead, select the packages of a pattern you want to remove and mark them for removal.
In order to select more packages, repeat the steps mentioned above.
Before applying your changes, you can review or modify them by clicking at the bottom of the dialog. By default, all packages that will change status are listed.
To revert changes for a package, click the icon with the yellow arrow. To finish the review, click .
When you are finished with the selection of packages to install or remove, your changes.
In case YaST found dependencies on other packages, a list of packages that have additionally been chosen for installation, update or removal is presented. Click to accept them.
After all selected packages are installed, updated or removed, the YaST Software Manager automatically terminates.
![]() | Installing Source Packages |
|---|---|
Installing source packages with YaST Software Manager is not possible at the moment. Use the command line tool zypper for this purpose. For more information, see Section 9.1.2.1, “Installing Source Packages”. | |
Instead of updating individual packages, you can also update all installed packages or all packages from a certain repository. When mass updating packages, the following aspects are generally considered:
priorities of the repositories that provide the package,
architecture of the package (for example, x86_64, i686, i586),
version number of the package,
package vendor.
Which of the aspects has the highest importance for choosing the update candidates depends on the respective update option you choose.
To view the list of packages that can be updated (packages with higher versions are available), select in the bottom left box.
To update all packages listed there, click .
To install only upgradable packages for which an official patch has been issued, click . Those packages are marked by a patch tag next to their version number. Choosing this option is equivalent to doing an online update with YaST as described in Chapter 6, YaST Online Update.
If no patches have been issued since last applying patches, the button is disabled.
To make sure that the packages for a mass update derive from a certain repository:
Choose the repository from which to update as described in Section 5.3.1, “Views for Searching Packages or Patterns” .
On the right hand side of the window, click . This explicitly allows YaST to change the package vendor when replacing the packages.
All installed packages will be replaced by packages deriving from this repository, if available. This may lead to changes in vendor and architecture and even to downgrading some packages.
Before applying the changes, you can review or modify them by clicking at the bottom of the dialog. By default, all packages that will change status are listed.
To refrain from switching the system packages to the versions in this repository, click the button next to the respective option.
If all options are set according to your wishes, confirm your changes with to start the mass update.
Most packages are dependent on other packages. If a package, for example, uses a shared library, it will be dependent on the package providing this library. On the other hand, some packages cannot coexist with each other, causing a conflict (for example, you can only install one mail transfer agent: sendmail or postfix). When installing or removing software, the Software Manager makes sure no dependencies or conflicts remain unresolved to ensure system integrity.
In case there exists only one solution to resolve a dependency or a conflict, it is resolved automatically. Multiple solutions always cause a conflict which needs to be resolved manually. If solving a conflict involves a vendor or architecture change, it also needs to be solved manually. When clicking to apply any changes in the Software Manager, you get an overview of all actions triggered by the automatic resolver which you need to confirm.
By default, dependencies are automatically checked. A check is performed every time you change a package status (for example, by marking a package for installation or removal). This is generally useful, but can become exhausting when manually resolving a dependency conflict. To disable this function, uncheck +. Manually perform a dependency check with +. A consistency check is always performed when you confirm your selection with .
![]() | Manually Solving Package Conflicts |
|---|---|
Unless you are very experienced, follow the suggestions YaST makes when handling package conflicts, otherwise you may not be able to resolve them. Keep in mind that every change you make, potentially triggers other conflicts, so you can easily end up with a steadily increasing number of conflicts. In case this happens, click and the software manger. Relaunch it to start again. | |
If you want to install third-party software, add additional software repositories to your system. By default, the product repositories such as openSUSE-DVD 12.1 and a matching update repository are automatically configured during the installation. Depending on the initially selected product, a separate language add-on repository with translations, dictionaries, etc. might also be configured.
To manage repositories, start YaST and select +. The dialog opens. Here, you can also manage subscriptions to so-called by changing the at the right corner of the dialog to . A Service in this context is a (RIS) that can offer one or more software repositories. Such a Service can be changed dynamically by its administrator or vendor.
Each repository provides files describing content of the repository (package names, versions, etc.). These repository description files are downloaded to a local cache that is used by YaST. To ensure their integrity, software repositories can be signed with the GPG Key of the repository maintainer. Whenever you add a new repository, YaST offers the ability to import its key.
![]() | Trusting External Software Sources |
|---|---|
Before adding external software repositories to your list of repositories, make sure this repository can be trusted. openSUSE is not responsible for any potential problems arising from software installed from third-party software repositories. | |
You can either add repositories from a local harddisk, from a removable medium (like a CD, DVD or a USB mass storage) or from a network.
To add repositories from the dialog in YaST proceed as follows:
Click .
From the list of available specify the type matching your repository:
For network sources, it is usually sufficient to use the default option, .
To add a repository from a removable medium or a local harddisk, choose the relevant option and insert the medium or connect the USB device to the machine, respectively.
You can choose to now. If the option is unchecked, YaST will automatically download the files later, if needed. Click to proceed.
When adding a repository from the network, enter the data you are prompted for. Continue with .
Depending on the repository you have added, you might be asked if you want to import the GPG key with which it is signed or asked to agree to a license.
After confirming these messages, YaST will download and parse the metadata and add the repository to the list of .
If needed, adjust the repository as described in Section 5.4.2, “Managing Repository Properties” or confirm your changes with to close the configuration dialog.
Now you can install software from this repository as described in Section 5.2, “Using the KDE Interface (Qt)” or in Section 5.3, “Using the GNOME Interface (GTK+)”.
YaST also offers a list of predefined popular repositories available under . Among others, it includes driver repositories for nVidia and ATI graphics cards, and popular projects from the openSUSE® Build Service, such as the Mozilla repository (containing packages with the most recent versions of Firefox and Thunderbird).
Procedure 5.1. Configuring Community Repositories
Start YaST and select +.
Click .
Choose and proceed with .
From the preconfigured list of repositories choose the ones you want to add by ticking the respective check boxes. The Mozilla repository, for example, is listed as .
Confirm with .
Accept to the GnuPG key. You need to import a key for each repository you have chosen.
The new software repositories are now listed in the overview. Click to leave the software repositories configuration.
The overview of the lets you change the following repository properties:
The repository status can either be or . You can only install packages from repositories that are enabled. To turn a repository off temporarily click . You can also double-click on a repository name to toggle its status. If you want to remove a repository completely, click .
When refreshing a repository, its content description (package names, versions, etc.) is downloaded to a local cache that is used by YaST. It is sufficient to do this once for static repositories such as CDs or DVDs, whereas repositories whose content changes often should be refreshed frequently. The easiest way to keep a repository's cache up-to-date is to choose . To do a manual refresh click and select one of the options.
Packages from remote repositories are downloaded before being
installed. By default, they are deleted upon a successful
installation. Activating
prevents the deletion of downloaded packages. The download location is
configured in /etc/zypp/zypp.conf, by default it
is /var/cache/zypp/packages.
The of a repository is a value between
1 and 200, with
1 being the highest priority and
200 the lowest priority. Any new repositories that
are added with YaST get a priority of 99 by
default. If you do not care about a priority value for a certain
repository, you can also set the value to 0 to
apply the default priority to that repository (99).
If a package is available in more than one repository, then the
repository with the highest priority takes precedence. This is useful
if you want to avoid downloading packages unnecessarily from the
Internet by giving a local repository (for example, a DVD) a higher
priority.
![]() | Priority vs. Version |
|---|---|
The repository with the highest priority takes precedence in any case. Therefore, make sure that the update repository always has the highest priority (20 by default), otherwise you might install an outdated version that will not be updated until the next online update. If you add repositories providing new versions for programs shipped with openSUSE (for example a repository with the latest KDE or GNOME version), make sure they have a higher priority than the standard repositories, otherwise packages from these repositories will not be installed by default. | |
To change a repository name or its URL, select it from the list with a single-click and then click .
To ensure their integrity, software repositories can be signed with the GPG Key of the repository maintainer. Whenever you add a new repository, YaST offers to import its key. Verify it as you would do with any other GPG key and make sure it does not change. If you detect a key change, something might be wrong with the repository. Disable the repository as an installation source until you know the cause of the key change.
To manage all imported keys, click in the dialog. Select an entry with the mouse to show the key properties at the bottom of the window. , or keys with a click on the respective buttons.
openSUSE offers a continuous stream of software security patches for your product. The update applet informs you about the availability of patches and lets you easily install them with just a few clicks.
The Software Updater icon resides in the system tray of your panel depicting a gearwheel with a green arrow. To start Software Updater manually, choose ++ from the main menu. Alternatively, Alt+F2 and enter kpk_update.
![]() | Icon Visibility |
|---|---|
The Software Updater icon is only visible in the system tray, if patches are available. Hover over the icon to see the number of patches available. | |
Whenever software updates are available, the applet icon appears in the panel. Left-click the Software Updater icon to launch the software window.
Select a patch for installation by ticking its checkbox. Get detailed information on a patch by clicking on its title. To select all available patches for installation, tick the checkbox in the table header.
Click to start the patch installation.
In case you have started the patch installation for the first time,
you will be asked to enter the root password twice in order to
proceed. If you also check
you will never be asked again to provide the password.
The window showing an installation summary opens. Click to finish the installation.
The YaST Online Update offers advanced features to customize the patch installation. Please refer to Chapter 6, YaST Online Update for more information.
By default Software Updater checks for updates every 24 hours, notifies you when patches are available and does not automatically install patches. These settings can be changed with the . To open the choose ++ from the main menu. Alternatively, press Alt+F2 and enter kpk_settings. The settings for Software Updater are available in the section.
![]() | Patch Origin |
|---|---|
The also allows you to configure the repositories () to be used. This setting not only applies to Software Updater but also to the KDE Software Management module (). Make sure the repository is always selected—otherwise you will not receive patches. | |
The update applet resides in the notification area of the panel. Its icon changes depending on the availability and relevance of patches and the status of the update. To invoke the applet manually, choose +++.
![]() | Icon visibility |
|---|---|
By default, the update applet icon is only visible in the notification area, if patches are available. | |
The update applet is busy (for example checking for updates or installing software).
Security patches are available.
Important patches are available.
Trivial patches are available.
An error has occurred.
Procedure 5.2. Installing Patches
Whenever new patches are available, a notification message will appear and the Update Applet icon will be visible in the notification area. Either click in the notification message or click the icon to open the window.
All security and important patches are preselected. It is strongly recommended to install these patches. Trivial patches can be manually selected by ticking the respective check boxes. Get detailed information on a patch by clicking on its title.
Click to start the patch installation.
The window showing an installation summary opens. Click to proceed.
Enter the root password in the authentication screen and proceed
with .
The YaST Online Update offers advanced features to customize the patch installation. Please refer to Chapter 6, YaST Online Update for more information.
To configure the update applet, right-click the update icon in the panel and choose . The configuration dialog lets you modify the following settings:
Choose how often a check for updates is performed: , , , or .
Configure whether patches are installed automatically or not (default). Automatic installation can be chosen for either security patches only or for all patches.
Choose how often a check for major upgrades is performed: , , or .
This configuration option is only available on mobile computers. Turned off by default.
More options are configurable using gconf-editor: +.
openSUSE offers a continuous stream of software security updates for your product. By default, the update applet is used to keep your system up-to-date. Refer to Section 5.5, “Keeping the System Up-to-date” for further information on the update applet. This chapter covers the alternative tool for updating software packages: YaST Online Update.
The current patches for openSUSE® are available from an update software repository, which is automatically configured during the installation. Alternatively, you can manually add an update repository from a source you trust. To add or remove repositories, start the Repository Manager with + in YaST. Learn more about the Repository Manager in Section 5.4, “Managing Software Repositories and Services”.
openSUSE provides updates with different relevance levels:
Fix severe security hazards and should definitely be installed.
Fix issues that could compromise your computer.
Fix non-security relevant issues or provide enhancements.
The YaST dialog is available in two toolkit flavors: GTK (for GNOME) and Qt (for KDE). Both interfaces differ in look and feel but basically provide the same functions. The following sections provide a brief description of each. To open the dialog, start YaST and select +. Alternatively, start it from the command line with yast2 online_update.
The window consists of four sections.
The section on the left lists the available
patches for openSUSE. The patches are sorted by security relevance:
security, recommended, and
optional. You can change the view of the
section by selecting one of the following
options from :
Non-installed patches that apply to packages installed on your system.
Patches that either apply to packages not installed on your system, or patches that have requirements which have already have been fulfilled (because the relevant packages have already been updated from another source).
All patches available for openSUSE.
Each list entry in the section consists of a
symbol and the patch name. For an overview of the possible symbols and
their meaning, press Shift+F1. Actions required by
Security and Recommended patches
are automatically preset. These actions are
, and
.
If you install an up-to-date package from a repository other than the update repository, the requirements of a patch for this package may be fulfilled with this installation. In this case a check mark is displayed in front of the patch summary. The patch will be visible in the list until you mark it for installation. This will in fact not install the patch (because the package already is up-to-date), but mark the patch as having been installed.
Select an entry in the section to view a short at the bottom left corner of the dialog. The upper right section lists the packages included in the selected patch (a patch can consist of several packages). Click an entry in the upper right section to view details about the respective package that is included in the patch.
The window consists of four main sections.
The upper right section lists the available (or already installed)
patches for openSUSE. To filter patches according to their security
relevance, click the corresponding entry in
the upper right section of the window: Security,
Recommended, Optional or
Any priority.
If all available patches are already installed, the in the upper right section will show no entries. The box in the bottom left-hand section shows the number of both available and already installed patches and lets you toggle the view to either or patches.
Select an entry in the section to view a patch description and further details at the bottom right corner of the dialog. As a patch can consist of several packages, click the entry in the lower right section to see which packages are included in the respective patch.
Click on a patch entry to open a row with detailed information about the patch in the bottom of the window. Here you can see a detailed patch description as well as the versions available. You can also choose to optional patches—security and recommended patches are already preselected for installation.
The YaST Online Update dialog allows you to either install all available patches at one go or to manually select the patches that you want to apply to your system. You may also revert patches that have been applied to the system.
By default, all new patches (except the optional ones)
that are currently available for your system are already marked for
installation. They will be applied automatically once you click
or .
Procedure 6.1. Applying Patches with YaST Online Update
Start YaST and select +.
To automatically apply all new patches (except the
optional ones) that are currently available for your
system, proceed with or
to start the installation of the preselected
patches.
To first modify the selection of patches that you want to apply:
Use the respective filters and views the GTK and Qt interfaces provide. For details, refer to Section 6.1.1, “KDE Interface (Qt)” and Section 6.1.2, “GNOME Interface (GTK)”.
Select or deselect patches according to your needs and wishes by activating or deactivating the respective checkbox (GNOME) or by right-clicking the patch and choosing the respective action from the context menu (KDE).
![]() | Always Apply Security Updates |
|---|---|
However, do not deselect any | |
Most patches include updates for several packages. If you want to change actions for single packages, right-click a package in the package view and choose an action (KDE).
To confirm your selection and to apply the selected patches, proceed with or .
After the installation is complete, click to leave the YaST . Your system is now up-to-date.
![]() | Disabling deltarpms |
|---|---|
By default updates are downloaded as deltarpms. Since rebuilding rpm packages from deltarpms is a memory and CPU time consuming task, certain setups or hardware configurations might require you to disable the usage of deltarpms for performance sake.
To disable the use of deltarpms edit the file
| |
YaST also offers the possibility to set up an automatic update with
daily, weekly or monthly schedule. To use the respective module, you need
to install the
yast2-online-update-configuration
package first.
Procedure 6.2. Configuring the Automatic Online Update
After installation, start YaST and select +.
Alternatively, start the module with yast2 online_update_configuration from the command line.
Activate .
Choose whether to update , , or .
Some patches, such as kernel updates or packages requiring license agreements, require user interaction, which would cause the automatic update procedure to stop.
To automatically accept any license agreements, activate .
Select if you also want to in case you want the update procedure to proceed fully automatically.
![]() | Skipping Patches |
|---|---|
If you select to skip any packages that require interaction, run a manual from time to time in order to install those patches, too. Otherwise you might miss important patches. | |
Confirm your configuration with .
Abstract
By default, it is only possible to install packages from configured and enabled repositories. Apart from the official repositories that are configured during the installation, numerous other repositories exist. The openSUSE® Build Service hosts several hundred ones and a lot of third party repositories exist, too—see http://en.opensuse.org/Additional_package_repositories.
openSUSE offers two easy ways to install from these repositories
without the need to first subscribe to them. The 1-Click
Install method allows you to install packages directly from a
Web browser, while the YaST Package Search lets you query almost all
known repositories for openSUSE. You can directly install any
package found by the package search module.
![]() | Trusting External Software Sources |
|---|---|
Before installing from any external software repository, make sure it can be trusted. openSUSE is not responsible for any potential problems arising from software installed from third-party software repositories. | |
Installation using 1-Click Install is available from a
lot of repositories available on Web interfaces. A very popular interface
is the openSUSE Build Service software search.
Procedure 7.1. Installing Packages from the openSUSE Build Service via 1-Click Install
Start the openSUSE Build Service search interface at http://software.opensuse.org/search.
Select your system version from the drop-down menu, for example
openSUSE 12.1.
Enter the name of the package you want to install, for example the
OpenStreetMap editor josm.
To refine the search, adjust the according to your wishes.
Click .
From the results list select the preferred item by clicking its button.
In the Web browser's download dialog, select to open the file with the .
The 1-click installer opens the dialog. It shows the repositories providing the
packages you want to install per 1-Click Install.
They are activated per default. To proceed with the installation, keep
the repository selection. By default, you remain subscribed to these
repositories after the installation has finished and you will receive
updates from them in the future.
If you want to use the new repositories only once instead, uncheck . Click to proceed.
Now select the software packages that should be installed. Normally there is no need to change the default selection. Click to proceed.
The screen summarizes the choices you made. Click to restart the configuration steps from above. Click and to proceed with the installation.
Enter the root password to start the installation. In case a new
repository has been added you also need to confirm the import of the
repository's GnuPG key. During the installation several progress pop-ups
appear that do not need any interaction. After reading the
“Installation was successful” message, click
.
![]() | Disabling 1-Click Install Feature |
|---|---|
If you want to disable the 1-Click install feature, uninstall the
rpm -e yast2-metapackage-handler | |
Provided you are connected to the internet, you can also search and
install packages from almost all known repositories for openSUSE
directly via YaST's Package Search. This module is a YaST frontend for
the Webpin package search available at
http://packages.opensuse-community.org/. The YaST
module is not available by default—you need to install the package
yast2-packager-webpin first.
Procedure 7.2. Installing Packages Using the YaST Package Search
Start the Package Search from the YaST Control Center via +.
Search for a software package by entering it's name into the field and clicking .
The search result is listed on the tab. Click on a package name to see the repository URL, the package version number and the architecture in the pane.
![]() | Double Check the Package Information |
|---|---|
Make sure to double check whether the software is hosted on a repository you trust before you install it. Also check if the architecture complies with your system (x86_64 packages can only be installed on 64bit systems). | |
Mark a package for installation by activating its checkbox. You can mark several packages at once. You can even start a new search for other packages without losing your current selection, which is always available on the . Once you have finished the package selection, proceed with .
The dialog shows the repositories providing the packages you want to install. They are activated per default. To proceed with the installation, keep the repository selection. By default, you remain subscribed to these repositories after the installation has finished, so you will receive updates from them in the future.
If instead you want to use the new repositories only once, uncheck . Click to proceed.
Now select the software packages that should be installed. Normally there is no need to change the default selection. Click to proceed.
The screen summarizes the choices you made. Click to restart the configuration steps from above. Click and to proceed with the installation.
Confirm the next dialog. In case a new repository is used, you will also need to confirm the import of the repository's GnuPG key. During the installation several progress pop-ups appear that do not need any interaction. After reading the “Installation was successful” message, click .
Contents
Abstract
Add-on products are system extensions. You can install a third party add-on product or a special system extension of openSUSE® (for example, a CD with support for additional languages or a CD with binary drivers). To install a new add-on, start YaST and select + . You can select various types of product media, like CD, FTP, USB mass storage devices (such as USB flash drives or disks) or a local directory. You can work also directly with ISO files. To add an add-on as ISO file media, select then enter the . The is arbitrary.
To install a new add-on, proceed as follows:
In YaST select + to see an overview of already installed add-on products.
To install a new add-on product, click .
From the list of available specify the type matching your repository.
To add a repository from a removable medium, choose the relevant option and insert the medium or connect the USB device to the machine, respectively.
You can choose to now. If the option is unchecked, YaST will automatically download the files later, if needed. Click to proceed.
When adding a repository from the network, enter the data you are prompted for. Continue with .
Depending on the repository you have added, you may be asked if you want to import the GPG key with which it is signed or asked to agree to a license.
After confirming these messages, YaST will download and parse the metadata and add the repository to the list of .
If needed, adjust the repository as described in Section 5.4.2, “Managing Repository Properties” or confirm your changes with to close the configuration dialog.
After having successfully added the repository for the add-on media, the software manager starts and you can install packages. Refer to Chapter 5, Installing or Removing Software for details.
Some hardware needs binary-only drivers to function properly. If you have such hardware, refer to the release notes for more information about availability of binary drivers for your system. To read the release notes, open YaST and select +.
Abstract
This chapter describes Zypper and RPM, two command line tools for
managing software. For a definition of the terminology used in this
context (for example, repository,
patch, or update) refer to
Section 5.1, “Definition of Terms”.
Zypper is a command line package manager for installing, updating and removing packages as well as for managing repositories. It is especially useful for accomplishing remote software management tasks or managing software from shell scripts.
The general syntax of Zypper is:
zypper[global-options]command[command-options][arguments]...
The components enclosed in brackets are not required. The simplest way to execute Zypper is to type its name, followed by a command. For example, to apply all needed patches to the system type:
zypper patch
Additionally, you can choose from one or more global options by typing
them just before the command. For example,
--non-interactive means running the command without
asking anything (automatically applying the default answers):
zypper --non-interactive patch
To use the options specific to a particular command, type them right
after the command. For example,
--auto-agree-with-licenses means applying all needed
patches to the system without asking to confirm any licenses (they will
automatically be accepted):
zypper patch --auto-agree-with-licenses
Some commands require one or more arguments. When using the install command, for example, you need to specify which package(s) to install:
zypper install mplayer
Some options also require an argument. The following command will list all known patterns:
zypper search -t pattern
You can combine all of the above. For example, the following command will
install the mplayer and
amarok packages from the
factory repository while being verbose:
zypper -v install --from factory mplayer amarok
The --from option makes sure to keep all repositories
enabled (for solving any dependencies) while requesting the package from
the specified repository.
Most Zypper commands have a dry-run option that does a
simulation of the given command. It can be used for test purposes.
zypper remove --dry-run MozillaFirefox
To install or remove packages use the following commands:
zypper installpackage_namezypper removepackage_name
Zypper knows various ways to address packages for the install and remove commands:
zypper install MozillaFirefox
or
zypper install MozillaFirefox-3.5.3
zypper install mozilla:MozillaFirefox
Where mozilla is the alias of the repository from
which to install.
The following command will install all packages that have names starting with “Moz”. Use with care, especially when removing packages.
zypper install 'Moz*'
For example, if you would like to install a perl module without knowing the name of the package, capabilities come in handy:
zypper install 'perl(Time::ParseDate)'
Together with a capability you can specify an architecture (such as
i586 or x86_64) and/or a
version. The version must be preceded by an operator:
< (lesser than), <=
(lesser than or equal), = (equal),
>= (greater than or equal),
> (greater than).
zypper install 'firefox.x86_64' zypper install 'firefox>=3.5.3' zypper install 'firefox.x86_64>=3.5.3'
You can also specify a local or remote path to a package:
zypper install /tmp/install/MozillaFirefox.rpm zypper install http://download.opensuse.org/repositories/mozilla/SUSE_Factory/x86_64/MozillaFirefox-3.5.3-1.3.x86_64.rpm
To install and remove packages simultaneously use the
+/- modifiers. To install
emacs and remove vim
simultaneously, use:
zypper install emacs -vim
To remove emacs and install
vim simultaneously, use:
zypper remove emacs +vim
To prevent the package name starting with the - being
interpreted as a command option, always use it as the second argument. If
this is not possible, precede it with --:
zypper install -emacs +vim # Wrong zypper install vim -emacs # Correct zypper install -- -emacs +vim # same as above zypper remove emacs +vim # same as above
If (together with a certain package) you automatically want to remove any
packages that become unneeded after removing the specified package, use
the --clean-deps option:
rm package_name --clean-deps
By default, Zypper asks for a confirmation before installing or removing
a selected package, or when a problem occurs. You can override this
behavior using the --non-interactive option. This option
must be given before the actual command (install,
remove, and patch) as in the
following:
zypper--non-interactiveinstallpackage_name
This option allows the use of Zypper in scripts and cron jobs.
![]() | Do not Remove Mandatory System Packages |
|---|---|
Do not remove packages such as | |
If you want to install the corresponding source package of a package, use:
zypper source-install package_name
That command will also install the build dependencies of the specified
package. If you do not want this, add the switch -D.
To install only the build dependencies use -d.
zypper source-install -Dpackage_name# source package only zypper source-install -dpackage_name# build dependencies only
Of course, this will only work if you have the repository with the source packages enabled in your repository list (it is added by default, but not enabled). See Section 9.1.4, “Managing Repositories with Zypper” for details on repository management.
A list of all source packages available in your repositories can be obtained with:
zypper search -t srcpackage
To verify whether all dependencies are still fulfilled and to repair missing dependencies, use:
zypper verify
In addition to dependencies that must be fulfilled, some packages “recommend” other packages. These recommended packages are only installed if actually available and installable. In case recommended packages were made available after the recommending package has been installed (by adding additional packages or hardware), use the following command:
zypper install-new-recommends
This command is very useful after plugging in a webcam or WLAN device. It will install drivers for the device and related software, if available. Drivers and related software are only installable if certain hardware dependencies are fulfilled.
There are three different ways to update software using Zypper: by installing patches, by installing a new version of a package or by updating the entire distribution. The latter is achieved with the zypper dist-upgrade command which is discussed in Section 16.1, “Upgrading the System”.
To install all officially released patches applying to your system, just run:
zypper patch
In this case, all patches available in your repositories are checked for relevance and installed, if necessary. The above command is all you must enter in order to apply them when needed.
Zypper knows three different commands to query for the availability of patches:
Lists the number of needed patches (patches, that apply to your system but are not yet installed)
~ # zypper patch-check Loading repository data... Reading installed packages... 5 patches needed (1 security patch)
Lists all needed patches (patches, that apply to your system but are not yet installed)
~ # zypper list-patches Loading repository data... Reading installed packages... Repository | Name | Version | Category | Status ------------------------------------+-----------+---------+----------+------- Updates for openSUSE 11.3 11.3-1.82 | lxsession | 2776 | security | needed
Lists all patches available for openSUSE, regardless of whether they are already installed or apply to your installation.
It is also possible to list and install patches relevant to specific issues. To list specific patches, use the zypper list-patches command with the following options:
--bugzilla[=number]
Lists all needed patches for Bugzilla issues. Optionally, you can specify a bug number if you only want to list patches for this specific bug.
--cve[=number]
Lists all needed patches for CVE (Common Vulnerabilities and Exposures) issues, or only patches matching a certain CVE number, if specified.
To install a patch for a specific Bugzilla or CVE issue, use the following commands:
zypper patch --bugzilla=numberor
zypper patch --cve=number
For example, to install a security patch with the CVE number
CVE-2010-2713, execute:
zypper patch --cve=CVE-2010-2713
If a repository contains only new packages, but does not provide patches, zypper patch does not show any effect. To update all installed packages with newer available versions, use:
zypper update
To update individual packages, specify the package with either the update or install command:
zypper updatepackage_namezypper installpackage_name
A list of all new installable packages can be obtained with the command:
zypper list-updates
Note that this command only packages lists packages that match the following criteria:
has the same vendor like the already installed package,
is provided by repositories with at least the same priority than the already installed package,
is installable (all dependencies are satisfied).
A list of all new available packages (regardless whether installable or not) can be obtained with:
zypper list-updates --all
To find out why a new package cannot be installed, just use the zypper install or zypper update command as described above.
To easily upgrade your installation to a new product version (for example, from openSUSE 11.4 to openSUSE 12.1), first adjust your repositories to match the current openSUSE repositories. For details, refer to Section 9.1.4, “Managing Repositories with Zypper”. Then use the zypper dist-upgrade command with the required repositories. This command ensures that all packages will be installed from the repositories currently enabled. For detailed instructions, refer to Section 16.1.4, “Distribution Upgrade with zypper”.
To restrict the distribution upgrade to packages from a certain
repository while considering also the other repositories for satisfying
dependencies, use the --from option and specify the
repository by either its alias, its number or URI.
![]() | Differences between zypper update and zypper dist-upgrade | ||||
|---|---|---|---|---|---|
Choose zypper update to update packages to newer versions available for your product version while maintaining system integrity. zypper update will honor the following rules:
When executing zypper dist-upgrade, all packages will be installed from the repositories currently enabled. This rule is enforced, so packages might change vendor or architecture or even might get downgraded. All packages that have unfulfilled dependencies after the upgrade will be uninstalled. | |||||
All installation or patch commands of Zypper rely on a list of known repositories. To list all repositories known to the system, use the command:
zypper repos
The result will look similar to the following output:
Example 9.1. Zypper—List of Known Repositories¶
# | Alias | Name | Enabled | Refresh --+-----------------------+-----------------------+---------+-------- 1 | Updates | Updates | Yes | Yes 2 | openSUSE 11.2-0 | openSUSE 11.2-0 | No | No 3 | openSUSE-11.2-Debug | openSUSE-11.2-Debug | No | Yes 4 | openSUSE-11.2-Non-Oss | openSUSE-11.2-Non-Oss | Yes | Yes 5 | openSUSE-11.2-Oss | openSUSE-11.2-Oss | Yes | Yes 6 | openSUSE-11.2-Source | openSUSE-11.2-Source | No | Yes
When specifying repositories in various commands, an alias, URI or repository number from the zypper repos command output can be used. A repository alias is a short version of the repository name for use in repository handling commands. Note that the repository numbers can change after modifying the list of repositories. The alias will never change by itself.
By default, details such as the URI or the priority of the repository are not displayed. Use the following command to list all details:
zypper repos -d
To add a repository, run
zypper addrepoURIalias
URI can either be an Internet repository, a
network resource, a directory or a CD or DVD (see
http://en.opensuse.org/openSUSE:Libzypp_URIs for
details). The alias is a shorthand and unique
identifier of the repository. You can freely choose it, with the only
exception that is has to be unique. Zypper will issue a warning if you
specify an alias that is already in use.
If you want to remove a repository from the list, use the command zypper removerepo together with the alias or number of the repository you want to delete. For example, to remove the repository listed as third entry in Example 9.1, “Zypper—List of Known Repositories”, use the following command:
zypper removerepo 3
Enable or disable repositories with zypper
modifyrepo. You can also alter the repository's properties
(such as refreshing behavior, name or priority) with this command. The
following command will enable the repository named
updates, turn on auto-refresh and set its priority to
20:
zypper modifyrepo -er -p 20 'updates'
Modifying repositories is not limited to a single repository—you can also operate on groups:
-a: all repositories |
-l: local repositories |
-t: remote repositories |
-m : repositories
of a certain type (where TYPE can be one of the
following: http, https, ftp,
cd, dvd, dir, file,
cifs, smb, nfs, hd,
iso) |
To rename a repository alias, use the renamerepo
command. The following example changes the alias from Mozilla
Firefox to just firefox:
zypper renamerepo 'Mozilla Firefox' firefox
Zypper offers various methods to query repositories or packages. To get lists of all products, patterns, packages or patches available, use the following commands:
zypper products zypper patterns zypper packages zypper patches
To query all repositories for certain packages, use
search. It works on package names, or, optionally, on
package summaries and descriptions. Using the wildcards
* and ? with the search term is
allowed. By default, the search is not case-sensitive.
zypper search firefox # simple search for "firefox" zypper search "*fire*" # using wildcards zypper search -d fire # also search in package descriptions and summaries zypper search -u firefox # only display packages not already installed
To search for packages which provide a special capability, use the
command what-provides. For example, if you would like
to know which package provides the perl module
SVN::Core, use the following command:
zypper what-provides 'perl(SVN::Core)'
To query single packages, use info with an exact
package name as an argument. It displays detailed information about a
package. To also show what is required/recommended by the package, use
the options --requires and
--recommends:
zypper info --requires MozillaFirefox
The what-provides
is similar to rpm -q --whatprovides
packagepackage, but rpm is only able to
query the RPM database (that is the database of all installed packages).
Zypper, on the other hand, will tell you about providers of the
capability from any repository, not only those that are installed.
Zypper now comes with a configuration file, allowing you to permanently
change Zypper's behavior (either system-wide or user-specific). For
system-wide changes, edit /etc/zypp/zypper.conf. For
user-specific changes, edit ~/.zypper.conf. If
~/.zypper.conf does not yet exist, you can use
/etc/zypp/zypper.conf as template: copy it to
~/.zypper.conf and adjust it to your liking. Refer
to the comments in the file for help about the available options.
In case you have problems to access packages from configured repositories (for example, zypper cannot find a certain package though you know that it exists in one the repositories), it can help to refresh the repositories with:
zypper refresh
If that does not help, try
zypper refresh -fdb
This forces a complete refresh and rebuild of the database, including a forced download of raw metadata.
If the btrfs file system is used on the root partition and snapper is installed, zypper automatically calls snapper (via script installed by snapper) when committing changes to the file system to create appropriate file system snapshots. These snapshots can be used for reverting any changes made by zypper. For more information about snapper, see man snapper.
Zypper (and YaST) currently only make snapshots of the root filesystem. Other subvolumes cannot be configured. This feature is not supported on the default file system.
For more information on managing software from the command line, enter
zypper help, zypper
help command or refer to the
zypper(8) manpage. For a
complete and detailed command reference, including cheat
sheets with the most important commands, and information on how
to use Zypper in scripts and applications, refer to
http://en.opensuse.org/SDB:Zypper_usage. A list of
software changes for the latest openSUSE version can be found at
.
.
RPM (RPM Package Manager) is used for managing software packages. Its main commands are rpm and rpmbuild. The powerful RPM database can be queried by the users, system administrators and package builders for detailed information about the installed software.
Essentially, rpm has five modes: installing, uninstalling (or updating) software packages, rebuilding the RPM database, querying RPM bases or individual RPM archives, integrity checking of packages and signing packages. rpmbuild can be used to build installable packages from pristine sources.
Installable RPM archives are packed in a special binary format. These
archives consist of the program files to install and certain meta
information used during the installation by rpm to
configure the software package or stored in the RPM database for
documentation purposes. RPM archives normally have the extension
.rpm.
![]() | Software Development Packages |
|---|---|
For a number of packages, the components needed for software development
(libraries, headers, include files, etc.) have been put into separate
packages. These development packages are only needed if you want to
compile software yourself (for example, the most recent GNOME packages).
They can be identified by the name extension | |
RPM packages have a GnuPG signature. To verify the signature of an RPM
package, use the command rpm
--checksig package-1.2.3.rpm to
determine whether the package originates from Novell/SUSE or from
another trustworthy facility. This is especially recommended for update
packages from the Internet.
Normally, the installation of an RPM archive is quite simple:
rpm -i package.rpm. With
this command the package is installed, but only if its dependencies are
fulfilled and if there are no conflicts with other packages. With an
error message, rpm requests those packages that need
to be installed to meet dependency requirements. In the background, the
RPM database ensures that no conflicts arise—a specific file can
only belong to one package. By choosing different options, you can force
rpm to ignore these defaults, but this is only for
experts. Otherwise, you risk compromising the integrity of the system and
possibly jeopardize the ability to update the system.
The options -U or --upgrade and
-F or --freshen can be used to update a
package (for example, rpm -F
package.rpm). This command removes
the files of the old version and immediately installs the new files. The
difference between the two versions is that -U installs
packages that previously did not exist in the system, but
-F merely updates previously installed packages. When
updating, rpm updates configuration files carefully
using the following strategy:
If a configuration file was not changed by the system administrator, rpm installs the new version of the appropriate file. No action by the system administrator is required.
If a configuration file was changed by the system administrator before
the update, rpm saves the changed file with the
extension .rpmorig or
.rpmsave (backup file) and installs the version
from the new package (but only if the originally installed file and the
newer version are different). If this is the case, compare the backup
file (.rpmorig or .rpmsave)
with the newly installed file and make your changes again in the new
file. Afterwards, be sure to delete all .rpmorig
and .rpmsave files to avoid problems with future
updates.
.rpmnew files appear if the configuration file
already exists and if the
noreplace label was specified in the
.spec file.
Following an update, .rpmsave and
.rpmnew files should be removed after comparing
them, so they do not obstruct future updates. The
.rpmorig extension is assigned if the file has not
previously been recognized by the RPM database.
Otherwise, .rpmsave is used. In other words,
.rpmorig results from updating from a foreign format
to RPM. .rpmsave results from updating from an older
RPM to a newer RPM. .rpmnew does not disclose any
information as to whether the system administrator has made any changes
to the configuration file. A list of these files is available in
/var/adm/rpmconfigcheck. Some configuration files
(like /etc/httpd/httpd.conf) are not overwritten to
allow continued operation.
The -U switch is not just an
equivalent to uninstalling with the -e option and
installing with the -i option. Use -U
whenever possible.
To remove a package, enter rpm -e
package. rpm,
which only deletes the package if there are no unresolved dependencies.
It is theoretically impossible to delete Tcl/Tk, for example, as long as
another application requires it. Even in this case, RPM calls for
assistance from the database. If such a deletion is, for whatever reason,
impossible (even if no additional dependencies
exist), it may be helpful to rebuild the RPM database using the option
--rebuilddb.
To guarantee the operational security of a system, update packages must be installed in the system from time to time. Previously, a bug in a package could only be eliminated by replacing the entire package. Large packages with bugs in small files could easily result in this scenario. However the SUSE RPM offers a feature enabling the installation of patches in packages.
The most important considerations are demonstrated using pine as an example:
To check this, first query the installed version of the package. For pine, this can be done with
rpm -q pine pine-4.44-188
Then check if the patch RPM is suitable for this version of pine:
rpm -qp --basedon pine-4.44-224.i586.patch.rpm pine = 4.44-188 pine = 4.44-195 pine = 4.44-207
This patch is suitable for three different versions of pine. The installed version in the example is also listed, so the patch can be installed.
The files affected by a patch can easily be seen in the patch RPM. The
rpm parameter -P allows selection
of special patch features. Display the list of files with the
following command:
rpm -qpPl pine-4.44-224.i586.patch.rpm /etc/pine.conf /etc/pine.conf.fixed /usr/bin/pine
or, if the patch is already installed, with the following command:
rpm -qPl pine /etc/pine.conf /etc/pine.conf.fixed /usr/bin/pine
Patch RPMs are used just like normal RPMs. The only difference is that a suitable RPM must already be installed.
A list of all patches installed in the system can be displayed with
the command rpm -qPa. If only one
patch is installed in a new system (as in this example), the list
appears as follows:
rpm -qPa pine-4.44-224
If, at a later date, you want to know which package version was originally installed, this information is also available in the RPM database. For pine, this information can be displayed with the following command:
rpm -q --basedon pine pine = 4.44-188
More information, including information about the patch feature of RPM, is available in the man pages of rpm and rpmbuild.
![]() | Official Updates for openSUSE |
|---|---|
In order to make the download size of updates as small as possible, official updates for openSUSE are not provided as Patch RPMs, but as Delta RPM packages. For details, see Section 9.2.4, “Delta RPM Packages”. | |
Delta RPM packages contain the difference between an old and a new version of an RPM package. Applying a delta RPM onto an old RPM results in a completely new RPM. It is not necessary to have a copy of the old RPM because a delta RPM can also work with an installed RPM. The delta RPM packages are even smaller in size than patch RPMs, which is an advantage when transferring update packages over the Internet. The drawback is that update operations with delta RPMs involved consume considerably more CPU cycles than plain or patch RPMs.
The prepdeltarpm, writedeltarpm and
applydeltarpm binaries are part of the delta RPM suite
(package deltarpm) and help you create and apply
delta RPM packages. With the following commands, create a delta RPM
called new.delta.rpm. The following command assumes
that old.rpm and new.rpm are
present:
prepdeltarpm -s seq -i info old.rpm > old.cpio prepdeltarpm -f new.rpm > new.cpio xdelta delta -0 old.cpio new.cpio delta writedeltarpm new.rpm delta info new.delta.rpm
Finally, remove the temporary working files
old.cpio, new.cpio, and
delta.
Using applydeltarpm, you can reconstruct the new RPM from the file system if the old package is already installed:
applydeltarpm new.delta.rpm new.rpm
To derive it from the old RPM without accessing the file system, use the
-r option:
applydeltarpm -r old.rpm new.delta.rpm new.rpm
See /usr/share/doc/packages/deltarpm/README for
technical details.
With the -q option rpm initiates
queries, making it possible to inspect an RPM archive (by adding the
option -p) and also to query the RPM database of
installed packages. Several switches are available to specify the type of
information required. See Table 9.1, “The Most Important RPM Query Options”.
Table 9.1. The Most Important RPM Query Options¶
|
|
Package information |
|
|
File list |
|
|
Query the package that contains the file
|
|
|
File list with status information (implies |
|
|
List only documentation files (implies |
|
|
List only configuration files (implies |
|
|
File list with complete details (to be used with
|
|
|
List features of the package that another package can request with
|
|
|
Capabilities the package requires |
|
|
Installation scripts (preinstall, postinstall, uninstall) |
For example, the command rpm -q -i wget displays the information shown in Example 9.2, “rpm -q -i wget”.
Example 9.2. rpm -q -i wget¶
Name : wget Relocations: (not relocatable) Version : 1.11.4 Vendor: openSUSE Release : 1.70 Build Date: Sat 01 Aug 2009 09:49:48 CEST Install Date: Thu 06 Aug 2009 14:53:24 CEST Build Host: build18 Group : Productivity/Networking/Web/Utilities Source RPM: wget-1.11.4-1.70.src.rpm Size : 1525431 License: GPL v3 or later Signature : RSA/8, Sat 01 Aug 2009 09:50:04 CEST, Key ID b88b2fd43dbdc284 Packager : http://bugs.opensuse.org URL : http://www.gnu.org/software/wget/ Summary : A Tool for Mirroring FTP and HTTP Servers Description : Wget enables you to retrieve WWW documents or FTP files from a server. This can be done in script files or via the command line. [...]
The option -f only works if you specify the complete
filename with its full path. Provide as many filenames as desired. For
example, the following command
rpm -q -f /bin/rpm /usr/bin/wget
results in:
rpm-4.8.0-4.3.x86_64 wget-1.11.4-11.18.x86_64
If only part of the filename is known, use a shell script as shown in Example 9.3, “Script to Search for Packages”. Pass the partial filename to the script shown as a parameter when running it.
Example 9.3. Script to Search for Packages¶
#! /bin/sh
for i in $(rpm -q -a -l | grep $1); do
echo "\"$i\" is in package:"
rpm -q -f $i
echo ""
done
The command rpm -q --changelog rpm displays a detailed
list of change information about a specific package (in this case, the
rpmpackage), sorted by date.
With the help of the installed RPM database, verification checks can be
made. Initiate these with -V, -y or
--verify. With this option, rpm shows
all files in a package that have been changed since installation.
rpm uses eight character symbols to give some hints
about the following changes:
Table 9.2. RPM Verify Options¶
|
|
MD5 check sum |
|
|
File size |
|
|
Symbolic link |
|
|
Modification time |
|
|
Major and minor device numbers |
|
|
Owner |
|
|
Group |
|
|
Mode (permissions and file type) |
In the case of configuration files, the letter c is
printed. For example, for changes to /etc/wgetrc
(wget package):
rpm -V wget S.5....T c /etc/wgetrc
The files of the RPM database are placed in
/var/lib/rpm. If the partition
/usr has a size of 1 GB, this database can
occupy nearly 30 MB, especially after a complete update. If the
database is much larger than expected, it is useful to rebuild the
database with the option --rebuilddb. Before doing this,
make a backup of the old database. The cron script
cron.daily makes daily copies of the database (packed
with gzip) and stores them in /var/adm/backup/rpmdb.
The number of copies is controlled by the variable
MAX_RPMDB_BACKUPS (default: 5)
in /etc/sysconfig/backup. The size of a single
backup is approximately 1 MB for 1 GB in
/usr.
All source packages carry a .src.rpm extension
(source RPM).
![]() | Installed Source Packages |
|---|---|
Source packages can be copied from the installation medium to the hard
disk and unpacked with YaST. They are not, however, marked as
installed ( | |
The following directories must be available for rpm
and rpmbuild in /usr/src/packages
(unless you specified custom settings in a file like
/etc/rpmrc):
SOURCES
for the original sources (.tar.bz2 or
.tar.gz files, etc.) and for
distribution-specific adjustments (mostly .diff
or .patch files)
SPECS
for the .spec files, similar to a meta Makefile,
which control the build process
BUILD
all the sources are unpacked, patched and compiled in this directory
RPMS
where the completed binary packages are stored
SRPMS
here are the source RPMs
When you install a source package with YaST, all the necessary
components are installed in /usr/src/packages: the
sources and the adjustments in SOURCES and the
relevant .spec file in SPECS.
![]() | |
Do not experiment with system components
( | |
The following example uses the wget.src.rpm package.
After installing the source package, you should have files similar to
those in the following list:
/usr/src/packages/SOURCES/wget-1.11.4.tar.bz2 /usr/src/packages/SOURCES/wgetrc.patch /usr/src/packages/SPECS/wget.spec
rpmbuild -bX
/usr/src/packages/SPECS/wget.spec starts the compilation.
X is a wild card for various stages of the
build process (see the output of --help or the RPM
documentation for details). The following is merely a brief explanation:
-bp
Prepare sources in /usr/src/packages/BUILD:
unpack and patch.
-bc
Do the same as -bp, but with additional compilation.
-bi
Do the same as -bp, but with additional installation
of the built software. Caution: if the package does not support the
BuildRoot feature, you might overwrite configuration files.
-bb
Do the same as -bi, but with the additional creation
of the binary package. If the compile was successful, the binary
should be in /usr/src/packages/RPMS.
-ba
Do the same as -bb, but with the additional creation
of the source RPM. If the compilation was successful, the binary
should be in /usr/src/packages/SRPMS.
--short-circuit
Skip some steps.
The binary RPM created can now be installed with rpm
-i or, preferably, with rpm
-U. Installation with rpm
makes it appear in the RPM database.
The danger with many packages is that unwanted files are added to the
running system during the build process. To prevent this use
build, which creates a defined environment in
which the package is built. To establish this chroot environment, the
build script must be provided with a complete package
tree. This tree can be made available on the hard disk, via NFS, or from
DVD. Set the position with build --rpms
directory. Unlike
rpm, the build command looks for
the .spec file in the source directory. To build
wget (like in the above example) with the DVD
mounted in the system under /media/dvd, use the
following commands as root:
cd /usr/src/packages/SOURCES/ mv ../SPECS/wget.spec . build --rpms /media/dvd/suse/ wget.spec
Subsequently, a minimum environment is established at
/var/tmp/build-root. The package is built in this
environment. Upon completion, the resulting packages are located in
/var/tmp/build-root/usr/src/packages/RPMS.
The build script offers a number of additional
options. For example, cause the script to prefer your own RPMs, omit the
initialization of the build environment or limit the
rpm command to one of the above-mentioned stages.
Access additional information with build
--help and by reading the
build man page.
Midnight Commander (mc) can display the contents of
RPM archives and copy parts of them. It represents archives as virtual
file systems, offering all usual menu options of Midnight Commander.
Display the HEADER with F3. View
the archive structure with the cursor keys and Enter.
Copy archive components with F5.
A full-featured package manager is available as a YaST module. For details, see Chapter 5, Installing or Removing Software.
Contents
Contents
During installation, you chose a method for user
authentication. This method is either local (via
/etc/passwd) or, if a network connection is
established, via NIS, LDAP, Kerberos or Samba (see
Section “Create New User” (Chapter 1, Installation with YaST, ↑Reference)
. You can
create or modify user accounts and change the authentication method with
YaST at any time.
Every user is assigned a system-wide user ID (UID). Apart from the users which can log in to your machine, there are also a number of system users for internal use only. Each user is assigned to one or more groups. Similar to system users, there are also system groups for internal use.
To administer users or groups, start YaST and click +. Alternatively, start the dialog directly by running yast2 users & from a command line.
Depending on the set of users you choose to view and modify with, the dialog (local users, network users, system users), the main window shows several tabs. These allow you to execute the following tasks:
From the tab create, modify, delete or temporarily disable user accounts as described in Section 10.2, “Managing User Accounts”. Learn about advanced options like enforcing password policies, using encrypted home directories, using fingerprint authentication, or managing disk quotas in Section 10.3, “Additional Options for User Accounts”.
Local users accounts are created according to the settings defined on the tab. Learn how to change the default group assignment, or the default path and access permissions for home directories in Section 10.4, “Changing Default Settings for Local Users”.
Learn how to change the group assignment for individual users in Section 10.5, “Assigning Users to Groups”.
From the tab, you can add, modify or delete existing groups. Refer to Section 10.6, “Managing Groups” for information on how to do this.
When your machine is connected to a network that provides user authentication methods like NIS or LDAP, you can choose between several authentication methods on the tab. For more information, refer to Section 10.7, “Changing the User Authentication Method”.
For user and group management, the dialog provides similar functionality. You can easily switch between the user and group administration view by choosing the appropriate tab at the top of the dialog.
Filter options allow you to define the set of users or groups you want to modify: On the or tab, click to view and edit users or groups according to certain categories, such as or , for instance (if you are part of a network which uses LDAP). With + you can also set up and use a custom filter.
Depending on the filter you choose, not all of the following options and functions will be available from the dialog.
YaST offers to create, modify, delete or temporarily disable user accounts. Do not modify user accounts unless you are an experienced user or administrator.
![]() | Changing User IDs of Existing Users |
|---|---|
File ownership is bound to the user ID, not to the user name. After a user ID change, the files in the user's home directory are automatically adjusted to reflect this change. However, after an ID change, the user no longer owns the files he created elsewhere in the file system unless the file ownership for those files are manually modified. | |
In the following, learn how to set up default user accounts. For some further options, such as auto login, login without password, setting up encrypted home directories or managing quotas for users and groups, refer to Section 10.3, “Additional Options for User Accounts”.
Procedure 10.1. Adding or Modifying User Accounts
Open the YaST dialog and click the tab.
With define the set of users you want to manage. The dialog shows a list of users in the system and the groups the users belong to.
To modify options for an existing user, select an entry and click .
To create a new user account, click .
Enter the appropriate user data on the first tab, such as (which is used for login) and . This data is sufficient to create a new user. If you click now, the system will automatically assign a user ID and set all other values according to the default.
Activate if you want any kind of
system notifications to be delivered to this user's mailbox. This
creates a mail alias for root and the user can read the system
mail without having to first log in as root.
If you want to adjust further details such as the user ID or the path to the user's home directory, do so on the tab.
If you need to relocate the home directory of an existing user, enter the path to the new home directory there and move the contents of the current home directory with . Otherwise, a new home directory is created without any of the existing data.
To force users to regularly change their password or set other password options, switch to and adjust the options. For more details, refer to Section 10.3.2, “Enforcing Password Policies”.
If all options are set according to your wishes, click .
Click + to save all changes without exiting the dialog. Click to close the administration dialog and to save the changes. A newly added user can now log in to the system using the login name and password you created.
![]() | Matching User IDs |
|---|---|
For a new (local) user on a laptop which also needs to integrate into a network environment where this user already has a user ID, it is useful to match the (local) user ID to the ID in the network. This ensures that the file ownership of the files the user creates “offline” is the same as if he had created them directly on the network. | |
Procedure 10.2. Disabling or Deleting User Accounts
Open the YaST dialog and click the tab.
To temporarily disable a user account without deleting it, select the user from the list and click . Activate . The user cannot log into your machine until you enable the account again.
To delete a user account, select the user from the list and click . Choose if you also want to delete the user's home directory or if you want to retain the data.
In addition to the settings for a default user account, openSUSE® offers further options, such as options to enforce password policies, use encrypted home directories or define disk quotas for users and groups.
If you use the KDE or GNOME desktop environment you can configure Auto Login for a certain user as well as Passwordless Login for all users. Auto login causes a user to become automatically logged in to the desktop environment on boot. This functionality can only be activated for one user at a time. Login without password allows all users to log in to the system after they have entered their username in the login manager.
![]() | Security Risk |
|---|---|
Enabling Auto Login or Passwordless Login on a machine that can be accessed by more than one person is a security risk. Without the need to authenticate, any user can gain access to your system and your data. If your system contains confidential data, do not use this functionality. | |
If you want to activate auto login or login without password, access these functions in the YaST with +.
On any system with multiple users, it is a good idea to enforce at least basic password security policies. Users should change their passwords regularly and use strong passwords that cannot easily be exploited. For local users, proceed as follows:
Procedure 10.3. Configuring Password Settings
Open the YaST dialog and select the tab.
Select the user for which to change the password options and click .
Switch to the tab. The user's last password change is displayed on the tab.
To make the user change his password at next login, activate .
To enforce password rotation, set a and a .
To remind the user to change his password before it expires, set a number of .
To restrict the period of time the user can log in after his password has expired, change the value in .
You can also specify a certain expiration date for a password. Enter
the in
YYYY-MM-DD format.
For more information about the options and about the default values, click .
Apply your changes with .
To protect data in home directories against theft and hard disk removal, you can create encrypted home directories for users. These are encrypted with LUKS (Linux Unified Key Setup), which results in an image and an image key being generated for the user. The image key is protected with the user's login password. When the user logs into the system, the encrypted home directory is mounted and the contents are made available to the user.
![]() | Fingerprint Reader Devices and Encrypted Home Directories |
|---|---|
If you want to use a fingerprint reader device, you must not use encrypted home directories. Otherwise logging in will fail, because decrypting during login is not possible in combination with an active fingerprint reader device. | |
With YaST, you can create encrypted home directories for new or existing users. To encrypt or modify encrypted home directories of already existing users, you need to know the user's current login password. By default, all existing user data is copied to the new encrypted home directory, but it is not deleted from the unencrypted directory.
![]() | Security Restrictions |
|---|---|
Encrypting a user's home directory does not provide strong security from other users. If strong security is required, the system should not be physically shared. | |
Find background information about encrypted home directories and which actions to take for stronger security in Section “Using Encrypted Home Directories” (Chapter 10, Encrypting Partitions and Files, ↑Security Guide).
Procedure 10.4. Creating Encrypted Home Directories
Open the YaST dialog and click the tab.
To encrypt the home directory of an existing user, select the user and click .
Otherwise, click to create a new user account and enter the appropriate user data on the first tab.
In the tab, activate . With , specify the size of the encrypted image file to be created for this user.
![]() |
Apply your settings with .
Enter the user's current login password to proceed if YaST prompts for it.
Click + to save all changes without exiting the administration dialog. Click to close the administration dialog and save the changes.
Procedure 10.5. Modifying or Disabling Encrypted Home Directories
Of course, you can also disable the encryption of a home directory or change the size of the image file at any time.
Open the YaST dialog in the view.
Select a user from the list and click .
If you want to disable the encryption, switch to the tab and disable .
If you need to enlarge or reduce the size of the encrypted image file for this user, change the .
Apply your settings with .
Enter the user's current login password to proceed if YaST prompts for it.
Click + to save all changes without exiting the dialog. Click to close the administration dialog and to save the changes.
If your system includes a fingerprint reader you can use biometric authentication in addition to standard authentication via login and password. After registering their fingerprint, users can log into the system either by swiping a finger on the fingerprint reader or by typing in a password.
Fingerprints can be registered with YaST. Find detailed information about configuration and use of fingerprint authentication in Chapter 7, Using the Fingerprint Reader (↑Security Guide). For a list of supported devices, refer to http://www.freedesktop.org/wiki/Software/fprint/libfprint.
To prevent system capacities from being exhausted without notification, system administrators can set up quotas for users or groups. Quotas can be defined for one or more file systems and restrict the amount of disk space that can be used and the number of inodes (index nodes) that can be created there. Inodes are data structures on a file system that store basic information about a regular file, directory, or other file system object. They store all attributes of a file system object (like user and group ownership, read, write, or execute permissions), except file name and contents.
openSUSE allows usage of soft and
hard quotas. Soft quotas usually define a warning
level at which users are informed that they are nearing their limit,
whereas hard quotas define the limit at which write requests are denied.
Additionally, grace intervals can be defined that allow users or groups
to temporarily violate their quotas by certain amounts.
Procedure 10.6. Enabling Quota Support for a Partition
In order to configure quotas for certain users and groups, you need to enable quota support for the respective partition in the YaST Expert Partitioner first.
In YaST, select + and click to proceed.
In the , select the partition for which to enable quotas and click .
Click and activate . If the quota package
is not already installed, it will be installed once you confirm the
respective message with .
Confirm your changes and leave the .
Procedure 10.7. Setting Up Quotas for Users or Groups
Now you can define soft or hard quotas for specific users or groups and set time periods as grace intervals.
In the YaST , select the user or the group you want to set the quotas for and click .
On the tab, select the entry and click to open the dialog.
From , select the partition to which the quota should apply.
![]() |
Below , restrict the amount of disk space. Enter the number of 1 KB blocks the user or group may have on this partition. Specify a and a value.
Additionally, you can restrict the number of inodes the user or group may have on the partition. Below , enter a and .
You can only define grace intervals if the user or group has already exceeded the soft limit specified for size or inodes. Otherwise, the time-related input fields are not activated. Specify the time period for which the user or group is allowed to exceed the limits set above.
Confirm your settings with .
Click + to save all changes without exiting the dialog. Click to close the administration dialog and to save the changes.
openSUSE also ships command line tools like
repquota or warnquota with which
system administrators can control the disk usage or send e-mail
notifications to users exceeding their quota. With
quota_nld, administrators can also forward kernel
messages about exceeded quotas to D-BUS. For more information, refer to
the repquota, the
warnquota and the quota_nld
man page.
When creating new local users, several default settings are used by YaST. These include, for example, the primary group and the secondary groups the user belongs to, or the access permissions of the user's home directory. You can change these default settings to meet your requirements:
Open the YaST dialog and select the tab.
To change the primary group the new users should automatically belong to, select another group from .
To modify the secondary groups for new users, add or change groups in . The group names must be separated by commas.
If you do not want to use
/home/ as
default path for new users' home directories, modify the .
username
To change the default permission modes for newly created home directories, adjust the umask value in . For more information about umask, refer to Chapter 9, Access Control Lists in Linux (↑Security Guide) and to the umask man page.
For information about the individual options, click .
Apply your changes with .
Local users are assigned to several groups according to the default settings which you can access from the dialog on the tab. In the following, learn how to modify an individual user's group assignment. If you need to change the default group assignments for new users, refer to Section 10.4, “Changing Default Settings for Local Users”.
Procedure 10.8. Changing a User's Group Assignment
Open the YaST dialog and click the tab. It shows a list of users and of the groups the users belong to.
Click and switch to the tab.
To change the primary group the user belongs to, click and select the group from the list.
To assign the user additional secondary groups, activate the corresponding check boxes in the list.
Click to apply your changes.
Click + to save all changes without exiting the dialog. Click to close the administration dialog and save the changes.
With YaST you can also easily add, modify or delete groups.
Procedure 10.9. Creating and Modifying Groups
Open the YaST dialog and click the tab.
With define the set of groups you want to manage. The dialog shows a list of groups in the system.
To create a new group, click .
To modify an existing group, select the group and click
In the following dialog, enter or change the data. The list on the right shows an overview of all available users and system users which can be members of the group.
![]() |
To add existing users to a new group select them from the list of possible by checking the corresponding box. To remove them from the group uncheck the box.
Click to apply your changes.
Click + to save all changes without exiting the dialog.
In order to delete a group, it must not contain any group members. To delete a group, select it from the list and click . Click + to save all changes without exiting the dialog. Click to close the administration dialog and to save the changes.
When your machine is connected to a network, you can change the authentication method you set during installation. The following options are available:
Users are administered centrally on a NIS server for all systems in the network. For details, see Chapter 3, Using NIS (↑Security Guide).
Users are administered centrally on an LDAP server for all systems in the network. For details about LDAP, see Chapter 4, LDAP—A Directory Service (↑Security Guide).
You can manage LDAP users with the YaST user module. All other LDAP settings, including the default settings for LDAP users, have to be defined with the YaST LDAP client module as described in Section “Configuring an LDAP Client with YaST” (Chapter 4, LDAP—A Directory Service, ↑Security Guide) .
With Kerberos, a user registers once and then is trusted in the entire network for the rest of the session.
SMB authentication is often used in mixed Linux and Windows networks. For details, see Chapter 15, Samba (↑Reference) and Chapter 5, Active Directory Support (↑Security Guide).
To change the authentication method, proceed as follows:
Open the dialog in YaST.
Click the tab to show an overview of the available authentication methods and the current settings.
To change the authentication method, click and select the authentication method you want to modify. This takes you directly to the client configuration modules in YaST. For information about the configuration of the appropriate client, refer to the following sections:
NIS: Section “Configuring NIS Clients” (Chapter 3, Using NIS, ↑Security Guide)
LDAP: Section “Configuring an LDAP Client with YaST” (Chapter 4, LDAP—A Directory Service, ↑Security Guide)
After accepting the configuration, return to the overview.
Click to close the administration dialog.
Working in different countries or having to work in a multilingual
environment requires your computer to be set up to support this.
openSUSE® can handle different locales in
parallel. A locale is a set of parameters that defines the language and
country settings reflected in the user interface.
The main system language was selected during installation and keyboard and time zone settings were adjusted. However, you can install additional languages on your system and determine which of the installed languages should be the default.
For those tasks, use the YaST language module as described in Section 11.1, “Changing the System Language”. Install secondary languages to get optional localizations if you need to start applications or desktops in languages other than the primary one.
Apart from that, the YaST timezone module allows you to adjust your country and timezone settings accordingly. It also lets you synchronize your system clock against a time server. For details, refer to Section 11.2, “Changing the Country and Time Settings”.
Depending on how you use your desktop and whether you want to switch the entire system to another language or just the desktop environment itself, there are several ways to achieve this:
Proceed as described in Section 11.1.1, “Modifying System Languages with YaST” and Section 11.1.2, “Switching the Default System Language” to install additional localized packages with YaST and to set the default language. Changes are effective after relogin. To ensure that the entire system reflects the change, reboot the system or close and restart all running services, applications, and programs.
Provided you have previously installed the desired language packages for your desktop environment with YaST as described below, you can switch the language of your desktop using the desktop's control center. After the X server has been restarted, your entire desktop reflects your new choice of language. Applications not belonging to your desktop framework are not affected by this change and may still appear in the language that was set in YaST.
You can also run a single application in another language (that has already been installed with YaST). To do so, start it from the command line by specifying the language code as described in Section 11.1.3, “Switching Languages for Individual Applications”.
YaST knows two different language categories:
The primary language set in YaST applies to the entire system, including YaST and the desktop environment. This language is used whenever available unless you manually specify another language.
Install secondary languages to make your system multilingual. Languages installed as secondary languages can be selected manually for a specific situation. For example, use a secondary language to start an application in a certain language in order to do word processing in this language.
Before installing additional languages, determine which of them should be the default system language (primary language) after you have installed them.
To access the YaST language module, start YaST and click
+. Alternatively, start the
dialog directly by running yast2 language & as
user root from a command line.
![]() |
Procedure 11.1. Installing Additional Languages¶
When installing additional languages, YaST also allows you to set
different locale settings for the user root, see
Step 4. The option
determines how the
locale variables (LC_*) in the file
/etc/sysconfig/language are set for root.
You can either set them to the same locale as for normal users, keep it
unaffected by any language changes or only set the variable
RC_LC_CTYPE to the same values as for the normal users.
This variable sets the localization for language-specific function
calls.
To add additional languages in the YaST language module, select the you wish to install.
To make a language the default language, set it as .
Additionally, adapt the keyboard to the new primary language and adjust the time zone, if appropriate.
![]() | |
For advanced keyboard or time zone settings, select + or + in YaST to start the respective dialogs. For more information, refer to Section 11.2, “Changing the Country and Time Settings”. | |
To change language settings specific to the user root, click
.
Set to the desired value. For more information, click .
Decide if you want to for
root or not.
If your locale was not included in the list of primary languages available, try specifying it with . However, some of these localizations may be incomplete.
Confirm your changes in the dialogs with . If you have selected secondary languages, YaST installs the localized software packages for the additional languages.
The system is now multilingual. However, to start an application in a language other than the primary one, you need to set the desired language explicitly as explained in Section 11.1.3, “Switching Languages for Individual Applications”.
To globally switch the default system language, start the YaST language module.
Select the desired new system language as .
![]() | Deleting Former System Languages |
|---|---|
If you switch to a different primary language, the localized software packages for the former primary language will be removed from the system. If you want to switch the default system language but want to keep the former primary language as additional language, add it as by enabling the respective checkbox. | |
Adjust the keyboard and time zone options as desired.
Confirm your changes with .
After YaST has applied the changes, restart any X sessions (for example, by logging out and logging in again) to make YaST and the desktop applications reflect your new language settings.
After you have installed the respective language with YaST, you can run a single application in another language.
Start the application from the command line by using the following command:
LANG=languageapplication
For example, to start f-spot in German, run
LANG=de_DE f-spot. For other languages, use
the appropriate language code. Get a list of all language codes
available with the
locale -av command.
Start the application from the command line by using the following command:
KDE_LANG=languageapplication
For example, to start digiKam in German, run KDE_LANG=de digikam. For other languages, use the appropriate language code.
Using the YaST date and time module, adjust your system date, clock and
time zone information to the area you are working in. To access the
YaST module, start YaST and click +.
Alternatively, start the dialog
directly by running yast2 timezone & as user
root from a command line.
![]() |
First, select a general region, such as . Choose an appropriate country that matches the one you are working in, for example, .
Depending on which operating systems run on your workstation, adjust the hardware clock settings accordingly:
If you run another operating system on your machine, such as Microsoft Windows*, it is likely your system does not use UTC, but local time. In this case, uncheck .
If you only run Linux on your machine, set the hardware clock to UTC and have the switch from standard time to daylight saving time performed automatically.
You can change the date and time manually or opt for synchronizing your machine against an NTP server, either permanently or just for adjusting your hardware clock.
Procedure 11.2. Manually Adjusting Time and Date
In the YaST timezone module, click to set date and time.
Select and enter date and time values.
Confirm your changes with .
Procedure 11.3. Setting Date and Time With NTP Server
Click to set date and time.
Select .
Enter the address of an NTP server, if not already populated.
![]() |
Click , to get your system time set correctly.
If you want to make use of NTP permanently, enable .
With the button, you can open the advanced NTP configuration. For details, see Section “Configuring an NTP Client with YaST” (Chapter 13, Time Synchronization with NTP, ↑Reference).
Confirm your changes with .
Contents
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.
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.
When you start YaST in text mode, the YaST Control Center appears (see Figure 12.1). 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 and .
When you start the YaST Control Center, the category is selected automatically. Use ↓ and ↑ to change the category. To select a module from the category, activate the right frame with → and then use ↓ and ↑ to select the module. Keep the arrow keys pressed to scroll through the list of available modules. The selected module is highlighted. Press Enter to start the active module.
Various buttons or selection fields in the module contain a highlighted letter (yellow by default). Use Alt-highlighted_letter to select a button directly instead of navigating there with Tab. Exit the YaST Control Center by pressing Alt-Q or by selecting and pressing Enter.
The following description of the control elements in the YaST modules assumes that all function keys and Alt key combinations work and are not assigned to different global functions. Read Section 12.2, “Restriction of Key Combinations” for information about possible exceptions.
Use Tab to navigate among the buttons and frames containing selection lists. To navigate in reverse order, use Alt-Tab or Shift-Tab combinations.
Use the arrow keys (↑ and ↓) to navigate among the individual elements in an active frame containing a selection list. If individual entries within a frame exceed its width, use Shift-→ or Shift-← to scroll horizontally to the right and left. Alternatively, use Ctrl-E or Ctrl-A. This combination can also be used if using → or ← results in changing the active frame or the current selection list, as in the Control Center.
To select buttons with empty square brackets (check boxes) or empty parentheses (radio buttons), press Space or Enter. Alternatively, radio buttons and check boxes can be selected directly with Alt-highlighted_letter. In this case, you do not need to confirm with Enter. If you navigate to an item with Tab, press Enter to execute the selected action or activate the respective menu item.
The F keys (F1 through F12) 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 F10 for , , , and . Press F1 to access the YaST help.
Some YaST modules use a navigation tree in the left part of the window to select configuration dialogs. Use the arrow keys (↑ and ↓) to navigate in the tree. Use Space to open or close tree items. In ncurses mode, Enter must be pressed after a selection in the navigation tree in order to show the selected dialog. This is an intentional behavior to save time consuming redraws when browsing through the navigation tree.
If your window manager uses global Alt combinations, the Alt combinations in YaST might not work. Keys like Alt or Shift can also be occupied by the settings of the terminal.
Alt shortcuts can be executed with Esc instead of Alt. For example, Esc H replaces Alt-H. (First press Esc, then press H.)
If the Alt and Shift combinations are occupied by the window manager or the terminal, use the combinations Ctrl-F (forward) and Ctrl-B (backward) instead.
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 Alt key combinations and function keys should always be fully available on a pure text console.
Besides the text mode interface, YaST provides a pure command line interface. To get a list of YaST command line options, enter:
yast -h
To save time, the individual YaST modules can be started directly. To start a module, enter:
yast <module_name>
View a list of all module names available on your system with yast -l or yast --list. Start the network module, for example, with yast lan.
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
-i to install the package:
yast -i <package_name>
or
yast --install <package_name>
package_name can be a single short package
name, for example gvim, which
is installed with dependency checking, or the full path to an rpm
package, which is installed without dependency checking.
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 Section 9.1, “Using Zypper”.
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:
yast <module_name> help
If a module does not provide command line support, the module is started in text mode and the following message appears:
This YaST module does not support the command line interface.
Abstract
YaST allows you to configure hardware items at installation time as well as on an already-installed system. Configure audio hardware, printers or scanner support or learn which hardware components are connected to your computer by using the YaST Hardware Information module.
![]() | Graphics card, monitor, mouse and keyboard settings |
|---|---|
Graphics card, monitor, mouse and keyboard can be configured with either KDE or GNOME tools. | |
Use the YaST hardware information module if you want to know more about your hardware or if you need to find out details like vendor and model of a certain piece of hardware to be able to properly configure it.
Start YaST and click +. Hardware probing starts immediately and it will take some time until you see the hardware information tree in a separate window.
In the hardware information tree recursively click on the entries to expand the information about a specific device.
Click to save the output to a file.
Click to leave the hardware information overview.
YaST detects most sound cards automatically and configures them with the appropriate values. If you want to change the default settings, or need to set up a sound card that could not be configured automatically, use the YaST sound module. There, you can also set up additional sound cards or switch their order.
To start the sound module, start YaST and click +.
Alternatively, start the dialog
directly by running yast2 sound & as user
root from a command line.
![]() |
The dialog shows all sound cards that could be detected.
Procedure 13.1. Configuring Sound Cards¶
If you have added a new sound card or YaST could not automatically configure an existing sound card, follow the steps below. For configuring a new sound card, you need to know your sound card vendor and model. If in doubt, refer to your sound card documentation for the required information. For a reference list of sound cards supported by ALSA with their corresponding sound modules, see http://www.alsa-project.org/main/index.php/Matrix:Main.
During configuration, you can choose between the following setup options:
You are not required to go through any of the further configuration steps—the sound card is configured automatically. You can set the volume or any options you want to change later.
Allows you to adjust the output volume and play a test sound during the configuration.
For experts only. Allows you to customize all parameters of the sound card.
![]() | Advanced Configuration |
|---|---|
Only use this option if you know exactly what your are doing. Otherwise leave the parameters untouched and use the normal or the automatic setup options. | |
Start the YaST sound module.
To configure a detected, but sound card, select the respective entry from the list and click .
To configure a new sound card, click . Select your sound card vendor and model and click .
Choose one of the setup options and click .
If you have chosen , you can now your sound configuration and make adjustments to the volume. You should start at about ten percent volume to avoid damage to your hearing or the speakers.
If all options are set according to your wishes, click .
The dialog shows the newly configured or modified sound card.
To remove a sound card configuration that you no longer need, select the respective entry and click .
Click to save the changes and leave the YaST sound module.
Procedure 13.2. Modifying Sound Card Configurations
To change the configuration of an individual sound card (for experts only!), select the sound card entry in the dialog and click .
This takes you to the where you can fine-tune a number of parameters. For more information, click .
To adjust the volume of an already configured sound card or to test the sound card, select the sound card entry in the dialog and click . Select the respective menu item.
![]() | YaST Mixer |
|---|---|
The YaST mixer settings provide only basic options. They are intended for troubleshooting (for example, if the test sound is not audible). Access the YaST mixer settings from +. For everyday use and fine-tuning of sound options, use the mixer applet provided by your desktop or the alsasound command line tool. | |
For playback of MIDI files, select +.
When a supported sound card is detected (like a Creative
Soundblaster Live, Audigy or
AWE sound card), you can also install SoundFonts for
playback of MIDI files:
Insert the original driver CD-ROM into your CD or DVD drive.
Select + to copy SF2 SoundFonts™ to
your hard disk. The SoundFonts are saved in the directory
/usr/share/sfbank/creative/.
If you have configured more than one sound card in your system you can
adjust the order of your sound cards. To set a sound card as primary
device, select the sound card in the and click +. The sound
device with index 0 is the default device and thus
used by the system and the applications.
Per default, openSUSE uses the PulseAudio sound system. It is an abstraction layer that helps to mix multiple audio streams, bypassing any restrictions the hardware may have. To enable or disable the PulseAudio sound system, click +. If enabled, PulseAudio daemon is used to play sounds. Disable in case you want to use something else system-wide.
The volume and configuration of all sound cards are saved when you click
and leave the YaST sound module. The mixer
settings are saved to the file /etc/asound.state. The
ALSA configuration data is appended to the end of the file
/etc/modprobe.d/sound and written to
/etc/sysconfig/sound.
You can configure a USB or SCSI scanner with YaST. The
sane-backends package contains
hardware drivers and other essentials needed to use a scanner. Scanners
connected to a parallel port cannot be configured with YaST. If you own
a HP All-In-One device, see
Section 13.3.1, “Configuring an HP All-In-One Device”, instructions on how to
configure a network scanner are available at
Section 13.3.3, “Scanning over the Network”.
Procedure 13.3. Configuring a USB or SCSI Scanner¶
Connect your USB or SCSI scanner to your computer and turn it on.
Start YaST and select +. YaST builds the scanner database and tries to detect your scanner model automatically.
If a USB or SCSI scanner is not properly detected, try +.
To activate the scanner select it from the list of detected scanners and click .
Choose your model form the list and click and .
Use + to make sure you have chosen the correct driver.
Leave the configuration screen with .
An HP All-In-One device can be configured with YaST even if it is connected to the parallel port or is made available via the network. If you own a USB HP All-In-One device, start configuring as described in Procedure 13.3, “Configuring a USB or SCSI Scanner”. If it is detected properly and the succeeds, it is ready to use.
If your USB device is not properly detected, or your HP All-In-One device is connected to the parallel port or the network, run the HP Device Manager:
Start YaST and select +. YaST loads the scanner database.
Start the HP Device Manager with + and follow the on-screen instructions. After having finished the HP Device Manager, the YaST scanner module automatically restarts the auto detection.
Test it by choosing +.
Leave the configuration screen with .
openSUSE allows the sharing of a scanner over the network. To do so, configure your scanner as follows:
Configure the scanner as described in Section 13.3, “Setting Up a Scanner”.
Choose +.
Enter the hostnames of the clients (separated by a comma) that should be allowed to use the scanner under + and leave the configuration dialog with .
To use a scanner that is shared over the network, proceed as follows:
Start YaST and select +.
Open the network scanner configuration menu by +.
Enter the hostname of the machine the scanner is connected to under +
Leave with . The network scanner is now listed in the Scanner Configuration window and is ready to use.
Contents
openSUSE® supports printing with many types of printers, including remote network printers. Printers can be configured manually or with YaST. For configuration instructions, refer to Section 14.4, “Setting Up a Printer”. Both graphical and command line utilities are available for starting and managing print jobs. If your printer does not work as expected, refer to Section 14.8, “Troubleshooting”.
CUPS (Common Unix Printing System) is the standard print system in openSUSE.
Printers can be distinguished by interface, such as USB or network, and printer language. When buying a printer, make sure that the printer has an interface (like USB or parallel port) that is available on your hardware and a suitable printer language. Printers can be categorized on the basis of the following three classes of printer languages:
PostScript is the printer language in which most print jobs in Linux and Unix are generated and processed by the internal print system. If PostScript documents can be processed directly by the printer and do not need to be converted in additional stages in the print system, the number of potential error sources is reduced.
Although these printer languages are quite old, they are still undergoing expansion to address new features in printers. In the case of known printer languages, the print system can convert PostScript jobs to the respective printer language with the help of Ghostscript. This processing stage is referred to as interpreting. The best-known languages are PCL (which is mostly used by HP printers and their clones) and ESC/P (which is used by Epson printers). These printer languages are usually supported by Linux and produce an adequate print result. Linux may not be able to address some special printer functions. Except for HP developing HPLIP (HP Linux Imaging and Printing), there are currently no printer manufacturers who develop Linux drivers and make them available to Linux distributors under an open source license.
These printers do not support any of the common printer languages. They use their own undocumented printer languages, which are subject to change when a new edition of a model is released. Usually only Windows drivers are available for these printers. See Section 14.8.1, “Printers without Standard Printer Language Support” for more information.
Before you buy a new printer, refer to the following sources to check how well the printer you intend to buy is supported:
The OpenPrinting home page with the printer database. The database shows the latest Linux support status. However, a Linux distribution can only integrate the drivers available at production time. Accordingly, a printer currently rated as “perfectly supported” may not have had this status when the latest openSUSE version was released. Thus, the databases may not necessarily indicate the correct status, but only provide an approximation.
The Ghostscript Web page.
/usr/share/doc/packages/ghostscript-library/catalog.devices
List of included drivers.
The user creates a print job. The print job consists of the data to print plus information for the spooler, such as the name of the printer or the name of the printer queue, and optionally, information for the filter, such as printer-specific options.
At least one dedicated printer queue exists for every printer. The spooler holds the print job in the queue until the desired printer is ready to receive data. When the printer is ready, the spooler sends the data through the filter and back-end to the printer.
The filter converts the data generated by the application that is printing (usually PostScript or PDF, but also ASCII, JPEG, etc.) into printer-specific data (PostScript, PCL, ESC/P, etc.). The features of the printer are described in the PPD files. A PPD file contains printer-specific options with the parameters needed to enable them on the printer. The filter system makes sure that options selected by the user are enabled.
If you use a PostScript printer, the filter system converts the data into printer-specific PostScript. This does not require a printer driver. If you use a non-PostScript printer, the filter system converts the data into printer-specific data. This requires a printer driver suitable for your printer. The back-end receives the printer-specific data from the filter then passes it to the printer.
There are various possibilities for connecting a printer to the system. The configuration of the CUPS print system does not distinguish between a local printer and a printer connected to the system over the network. For more information about the printer connection, read the article CUPS in a Nutshell in the Support Database at http://en.opensuse.org/SDB:CUPS_in_a_Nutshell.
![]() | Changing Cable Connections in a Running System |
|---|---|
When connecting the printer to the machine, do not forget that only USB devices can be plugged in or unplugged during operation. To avoid damaging your system or printer, shut down the system before changing any connections that are not USB. | |
PPD (PostScript printer description) is the computer language that describes the properties, like resolution, and options, such as the availability of a duplex unit. These descriptions are required for using various printer options in CUPS. Without a PPD file, the print data would be forwarded to the printer in a “raw” state, which is usually not desired. During the installation of openSUSE, many PPD files are preinstalled.
To configure a PostScript printer, the best approach is to get a suitable
PPD file. Many PPD files are available in the package
manufacturer-PPDs, which is automatically
installed within the scope of the standard installation. See
Section 14.7.2, “PPD Files in Various Packages” and
Section 14.8.2, “No Suitable PPD File Available for a PostScript Printer”.
New PPD files can be stored in the directory
/usr/share/cups/model/ or added to the print system
with YaST as described in
Section 14.4.1.1, “Adding Drivers with YaST”. Subsequently, the
PPD file can be selected during the printer setup.
Be careful if a printer manufacturer wants you to install entire software packages. First, this kind of installation may result in the loss of the support provided by openSUSE and second, print commands may work differently and the system may no longer be able to address devices of other manufacturers. For this reason, the installation of manufacturer software is not recommended.
YaST can be used to configure a local printer that is directly connected to your machine (normally with USB or parallel port) and to set up printing with network printers. It is also possible to share printers over the network. Further information about printing (general information, technical details, and troubleshooting) is available in Chapter 14, Printer Operation.
In YaST, click + to start the printer module. By default it opens in the view, displaying a list of all printers that are available and configured. This is especially useful when having access to a lot of printers via the network. From here you can also and configure local printers.
Usually a local USB printer is automatically detected. There are two possible reasons why a USB printer is not automatically detected:
The USB printer is switched off.
The communication between printer and computer is not possible. Check the cable and the plugs to make sure that the printer is properly connected. If this is the case, the problem may not be printer-related, but rather a USB related problem.
Configuring a printer is basically a three-step process. First specify the connection type, then choose a driver, and name the printing queue for this setup.
For many printer models, several drivers are available. When configuring
the printer, YaST defaults to the one marked
recommended as a general rule. Normally it is not
necessary to change the driver—the recommended
one should produce the best results. However, if you want a color printer
to print only in black and white, it is most convenient to use a driver
that does not support color printing, for example. If you experience
performance problems with a PostScript printer when printing graphics, it
may help to switch from a PostScript driver to a PCL driver (provided
your printer understands PCL).
If no driver for your printer is listed, you can try to select a generic driver with an appropriate standard language from the list. Refer to your printer's documentation to find out which language (the set of commands controlling the printer) your printer understands. If this does not work, refer to Section 14.4.1.1, “Adding Drivers with YaST” for another possible solution.
A printer is never used directly, but always through a print queue. This ensures that simultaneous jobs can be queued and processed one after the other. Each printer queue is assigned to a specific driver, and a printer can have multiple queues. This makes it possible to set up a second queue on a color printer that prints black and white only, for example. Refer to Section 14.1, “The Workflow of the Printing System” for more information about print queues.
Procedure 14.1. Adding a New Local Printer¶
Start the YaST printer module with +
Click in the screen
If your printer is already listed under Specify the
Connection, proceed with the next step. Otherwise, try to
or start the .
Enter the vendor name and the model name into the input box under
Find and Assign a Driver and click .
Choose the driver marked as recommended that best matches your printer. If no suitable drivers is displayed
check your search term
broaden your search by clicking
add a driver as described in Section 14.4.1.1, “Adding Drivers with YaST”
Specify the Default paper size
Enter a unique name for the printer queue in the field.
The printer is now configured with the default settings and ready to use. Click to return to the view. The newly configured printer is now visible in the printers list.
If no suitable driver is available in the dialog when adding a new printer, no PPD (PostScript Printer Description) file for your model is available. For more information about PPD files, refer to Section 14.3, “Installing the Software”.
Get PPD files directly from your printer vendor or from the driver CD of a PostScript printer. For details, see Section 14.8.2, “No Suitable PPD File Available for a PostScript Printer”. Conversely, you can also find PPD files at http://www.linuxfoundation.org/en/OpenPrinting/, the “OpenPrinting.org printer database”. When downloading PPD files from OpenPrinting.org, keep in mind that it always shows the latest Linux support status, which is not necessarily met by openSUSE.
Procedure 14.2. Adding a PPD file
Start the YaST printer module with +
Click in the screen
Click in the Find and
Assign a Driver section
Enter the full path to the PPD file into the input box under
Make a Printer Description File Available or choose
the file from a dialog box by clicking on
Click to return to the Add New Printer
Configuration screen.
In order to directly use this PPD file, proceed as described in Procedure 14.1, “Adding a New Local Printer”. Otherwise, click .
By editing an existing configuration for a local printer you can not only change basic settings as connection type and driver, but also adjust the default settings for paper size, resolution, media source, etc. You can change the identifier of the printer by altering the printer descriptions.
Procedure 14.3. Editing a Local Printer
Start the YaST printer module with +
In the screen, choose a local printer from the list and click .
Change the connection type or the driver as described in Procedure 14.1, “Adding a New Local Printer”. This should only be necessary in case you have problems with the current configuration.
Make this printer the default by checking .
Adjust the default settings by clicking . To change a setting, expand the list of
options by clicking the relative + sign. Change the
default by clicking on an option. Apply your changes by clicking
Network printers are not detected automatically. They must be configured manually using the YaST printer module. Depending on your network setup, you can print to a print server (CUPS, LPD, SMB, or IPX) or directly to a network printer (preferably via TCP). Access the configuration view for network printing by choosing from the left pane in the YaST printer module.
In a Linux environment CUPS is usually used to print via the network. The simplest setup is to only print via a single CUPS server which can directly be accessed by all clients. Printing via more than one CUPS server requires a running local CUPS daemon that communicates with the remote CUPS servers.
Procedure 14.4. Printing via a Single CUPS server
Start the YaST printer module with +
Launch the screen from the left pane.
Check and specify the name or IP address of the server.
Click to make sure you have chosen the correct name or IP address.
Click OK to return to the screen. All printers available via the CUPS server are now listed.
Procedure 14.5. Printing via multiple CUPS servers
Start the YaST printer module with +
Launch the screen from the left pane.
Check
Specify which servers to use under General
Settings. You may accept connections from all networks
available, from the local network, or from specific hosts. If you
choose the latter option, you need to specify the hostnames or IP
addresses, as well.
Confirm by clicking and then when asked to start a local CUPS server. After the server has started you will return to the screen. Click to see the printers detected by now. Click this button again, in case more printer are to be available.
If your network offers print services via print servers other than CUPS, start the YaST printer module with + and launch the screen from the left pane. Start the and choose the appropriate type. Ask your network administrator for details on configuring a network printer in your environment.
Printers managed by a local CUPS daemon can be shared over the network and so turn your machine into a CUPS server. Usually you share a printer by enabling CUPS' so-called “browsing mode”. If browsing is enabled, the local printer queues are made available on the network for listening to remote CUPS daemons. It is also possible to set up a dedicated CUPS server that manages all printing queues and can directly be accessed by remote clients. In this case it is not necessary to enable browsing.
Procedure 14.6. Sharing Printers
Start the YaST printer module with +
Launch the screen from the left pane.
Select . For more detailed configuration, additional options are available:
Check and enable browsing mode by also checking .
the network interface to be used by the CUPS server. If you want to share your printers via specified network interfaces, add those in the input box below.
In case you like to restrict access to your CUPS server to certain networks or IP addresses, specify these via the two input boxes.
Click to restart the CUPS server and return to the screen.
Regarding CUPS and firewall settings, see http://en.opensuse.org/SDB:CUPS_and_SANE_Firewall_settings.
A network printer can support various protocols, some of them even concurrently. Although most of the supported protocols are standardized, some manufacturers modify the standard. Manufacturers then provide drivers for only a few operating systems. Unfortunately, Linux drivers are rarely provided. The current situation is such that you cannot act on the assumption that every protocol works smoothly in Linux. Therefore, you may have to experiment with various options to achieve a functional configuration.
CUPS supports the socket,
LPD, IPP and
smb protocols.
Socket refers to a connection in which the plain
print data is sent directly to a TCP socket. Some of the socket port
numbers that are commonly used are 9100 or
35. The device URI (uniform resource identifier)
syntax is:
socket://IP.of.the.printer:port,
for example: socket://192.168.2.202:9100/.
The LPD protocol is described in RFC 1179. Under this protocol,
some job-related data, such as the ID of the printer queue, is sent
before the actual print data is sent. Therefore, a printer queue must
be specified when configuring the LPD protocol. The implementations of
diverse printer manufacturers are flexible enough to accept any name
as the printer queue. If necessary, the printer manual should indicate
what name to use. LPT, LPT1, LP1 or similar names are often used. The
port number for an LPD service is 515. An example
device URI is lpd://192.168.2.202/LPT1.
IPP is a relatively new protocol (1999) based on the HTTP protocol.
With IPP, more job-related data is transmitted than with the other
protocols. CUPS uses IPP for internal data transmission. The name of
the print queue is necessary to configure IPP correctly. The port
number for IPP is 631. Example device URIs are
ipp://192.168.2.202/ps and
ipp://192.168.2.202/printers/ps.
CUPS also supports printing on printers connected to Windows shares.
The protocol used for this purpose is SMB. SMB uses the port numbers
137, 138 and 139.
Example device URIs are
smb://user:password@workgroup/smb.example.com/printer,
smb://user:password@smb.example.com/printer, and
smb://smb.example.com/printer.
The protocol supported by the printer must be determined before
configuration. If the manufacturer does not provide the needed
information, the command nmap (which comes with the
nmap package) can be used to ascertain the
protocol. nmap checks a host for open ports. For
example:
nmap -p 35,137-139,515,631,9100-10000 printerIPCUPS can be configured with command line tools like lpinfo, lpadmin and lpoptions. You need a device URI consisting of a back-end, such as parallel, and parameters. To determine valid device URIs on your system use the command lpinfo -v | grep ":/":
# lpinfo -v | grep ":/" direct usb://ACME/FunPrinter%20XL direct parallel:/dev/lp0
With lpadmin the CUPS server administrator can add, remove or manage print queues. To add a print queue, use the following syntax:
lpadmin -pqueue-vdevice-URI-PPPD-file-E
Then the device (-v) is available as
queue (-p), using the
specified PPD file (-P). This means that you must know
the PPD file and the device URI to configure the printer manually.
Do not use -E as the first option. For all CUPS
commands, -E as the first argument sets use of an
encrypted connection. To enable the printer, -E must be
used as shown in the following example:
lpadmin -p ps -v parallel:/dev/lp0 -P \ /usr/share/cups/model/Postscript.ppd.gz -E
The following example configures a network printer:
lpadmin -p ps -v socket://192.168.2.202:9100/ -P \ /usr/share/cups/model/Postscript-level1.ppd.gz -E
For more options of lpadmin, see the man page of
lpadmin(8).
During printer setup, certain options are set as default. These options can be modified for every print job (depending on the print tool used). Changing these default options with YaST is also possible. Using command line tools, set default options as follows:
First, list all options:
lpoptions -p queue -lExample:
Resolution/Output Resolution: 150dpi *300dpi 600dpi
The activated default option is identified by a preceding asterisk
(*).
Change the option with lpadmin:
lpadmin -p queue -o Resolution=600dpiCheck the new setting:
lpoptions -p queue -l
Resolution/Output Resolution: 150dpi 300dpi *600dpi
When a normal user runs lpoptions, the settings are
written to ~/.cups/lpoptions. However,
root settings are written
to /etc/cups/lpoptions.
To print from the command line, enter lp -d
queuename
filename, substituting the
corresponding names for queuename and
filename.
Some applications rely on the lp command for printing.
In this case, enter the correct command in the application's print
dialog, usually without specifying filename,
for example, lp -d
queuename.
A number of CUPS features have been adapted for openSUSE. Some of the most important changes are covered here.
After having performed a default installation of openSUSE,
SuSEFirewall2 is active and the network interfaces are configured to be
in the External Zone which blocks incoming traffic.
More information about the SuSEFirewall2 configuration is available in
Section “SuSEfirewall2” (Chapter 13, Masquerading and Firewalls, ↑Security Guide) and at
http://en.opensuse.org/SDB:CUPS_and_SANE_Firewall_settings.
Normally, a CUPS client runs on a regular workstation located in a
trusted network environment behind a firewall. In this case it is
recommended to configure the network interface to be in the
Internal Zone, so the workstation is reachable from
within the network.
If the CUPS server is part of a trusted network environment protected
by a firewall, the network interface should be configured to be in the
Internal Zone of the firewall. It is not recommended
to set up a CUPS server in an untrusted network environment unless you
take care that it is protected by special firewall rules and secure
settings in the CUPS configuration.
The YaST printer configuration sets up the queues for CUPS using the
PPD files installed in /usr/share/cups/model. To
find the suitable PPD files for the printer model, YaST compares the
vendor and model determined during hardware detection with the vendors
and models in all PPD files. For this purpose, the YaST printer
configuration generates a database from the vendor and model information
extracted from the PPD files.
The configuration using only PPD files and no other information sources
has the advantage that the PPD files in
/usr/share/cups/model can be modified freely. For
example, if you only have PostScript printers, normally you do not need
the Foomatic PPD files in the cups-drivers
package or the Gutenprint PPD files in the
gutenprint package. Instead, the PPD files for
your PostScript printers can be copied directly to
/usr/share/cups/model (if they do not already exist
in the manufacturer-PPDs package) to achieve an
optimum configuration for your printers.
cups Package¶
The generic PPD files in the cups package have
been complemented with adapted Foomatic PPD files for PostScript level
1 and level 2 printers:
/usr/share/cups/model/Postscript-level1.ppd.gz
/usr/share/cups/model/Postscript-level2.ppd.gz
cups-drivers Package¶
Normally, the Foomatic printer filter
foomatic-rip is used together with Ghostscript
for non-PostScript printers. Suitable Foomatic PPD files have the
entries *NickName: ... Foomatic/Ghostscript
driver and *cupsFilter: ...
foomatic-rip. These PPD files are located in the
cups-drivers package.
YaST generally prefers a manufacturer-PPD
file. However, when no suitable
manufacturer-PPD file exists, a Foomatic PPD
file with the entry *NickName: ... Foomatic ...
(recommended) is selected.
gutenprint Package¶
Instead of foomatic-rip, the CUPS filter
rastertogutenprint from Gutenprint (formerly
known as GIMP-Print) can be used for many non-PostScript printers. This
filter and suitable Gutenprint PPD files are available in the
gutenprint package. The Gutenprint PPD files
are located in /usr/share/cups/model/gutenprint/
and have the entries *NickName: ...
CUPS+Gutenprint and *cupsFilter: ...
rastertogutenprint.
manufacturer-PPDs Package¶
The manufacturer-PPDs package contains PPD
files from printer manufacturers that are released under a sufficiently
liberal license. PostScript printers should be configured with the
suitable PPD file of the printer manufacturer, because this file
enables the use of all functions of the PostScript printer. YaST
prefers a PPD file from the manufacturer-PPDs.
YaST cannot use a PPD file from the
manufacturer-PPDs package if the model name
does not match. This may happen if the
manufacturer-PPDs package contains only one
PPD file for similar models, like Funprinter 12xx series. In this case,
select the respective PPD file manually in YaST.
The following sections cover some of the most frequently encountered printer hardware and software problems and ways to solve or circumvent these problems. Among the topics covered are GDI printers, PPD files and port configuration. Common network printer problems, defective printouts, and queue handling are also addressed.
These printers do not support any common printer language and can only be addressed with special proprietary control sequences. Therefore they can only work with the operating system versions for which the manufacturer delivers a driver. GDI is a programming interface developed by Microsoft* for graphics devices. Usually the manufacturer delivers drivers only for Windows, and since the Windows driver uses the GDI interface these printers are also called GDI printers. The actual problem is not the programming interface, but the fact that these printers can only be addressed with the proprietary printer language of the respective printer model.
Some GDI printers can be switched to operate either in GDI mode or in one of the standard printer languages. See the manual of the printer whether this is possible. Some models require special Windows software to do the switch (note that the Windows printer driver may always switch the printer back into GDI mode when printing from Windows). For other GDI printers there are extension modules for a standard printer language available.
Some manufacturers provide proprietary drivers for their printers. The disadvantage of proprietary printer drivers is that there is no guarantee that these work with the installed print system or that they are suitable for the various hardware platforms. In contrast, printers that support a standard printer language do not depend on a special print system version or a special hardware platform.
Instead of spending time trying to make a proprietary Linux driver work, it may be more cost-effective to purchase a printer which supports a standard printer language (preferably PostScript). This would solve the driver problem once and for all, eliminating the need to install and configure special driver software and obtain driver updates that may be required due to new developments in the print system.
If the manufacturer-PPDs package does not
contain a suitable PPD file for a PostScript printer, it should be
possible to use the PPD file from the driver CD of the printer
manufacturer or download a suitable PPD file from the Web page of the
printer manufacturer.
If the PPD file is provided as a zip archive (.zip) or a self-extracting
zip archive (.exe), unpack it with
unzip. First, review the license terms of the PPD
file. Then use the cupstestppd utility to check if
the PPD file complies with “Adobe PostScript Printer Description
File Format Specification, version 4.3.” If the utility returns
“FAIL,” the errors in the PPD files are serious and are
likely to cause major problems. The problem spots reported by
cupstestppd should be eliminated. If necessary, ask
the printer manufacturer for a suitable PPD file.
The safest approach is to connect the printer directly to the first parallel port and to select the following parallel port settings in the BIOS:
I/O address: 378 (hexadecimal)
Interrupt: irrelevant
Mode: Normal, SPP, or
Output Only
DMA: disabled
If the printer cannot be addressed on the parallel port despite these
settings, enter the I/O address explicitly in accordance with the
setting in the BIOS in the form 0x378 in
/etc/modprobe.conf. If there are two parallel ports
that are set to the I/O addresses 378 and
278 (hexadecimal), enter these in the form
0x378,0x278.
If interrupt 7 is free, it can be activated with the
entry shown in Example 14.1, “/etc/modprobe.conf: Interrupt Mode for the First Parallel Port”.
Before activating the interrupt mode, check the file
/proc/interrupts to see which interrupts are
already in use. Only the interrupts currently being used are displayed.
This may change depending on which hardware components are active. The
interrupt for the parallel port must not be used by any other device. If
you are not sure, use the polling mode with irq=none.
Example 14.1. /etc/modprobe.conf: Interrupt Mode for the First Parallel Port¶
alias parport_lowlevel parport_pc options parport_pc io=0x378 irq=7
Connect the printer directly to the computer. For test purposes, configure the printer as a local printer. If this works, the problems are related to the network.
The TCP/IP network and name resolution must be functional.
Use the following command to test if a TCP connection can be
established to lpd (port 515)
on host:
netcat -z host 515 && echo ok || echo failedIf the connection to lpd cannot be established, lpd may not be active or there may be basic network problems.
As the user root, use the
following command to query a (possibly very long) status report for
queue on remote
host, provided the respective
lpd is active and the host accepts queries:
echo -e "\004queue" \
| netcat -w 2 -p 722 host 515
If lpd does not respond, it may not be active or
there may be basic network problems. If lpd
responds, the response should show why printing is not possible on
the queue on host. If you
receive a response like that shown in Example 14.2, “Error Message from lpd”,
the problem is caused by the remote lpd.
Example 14.2. Error Message from lpd¶
lpd: your host does not have line printer access lpd: queue does not exist printer: spooling disabled printer: printing disabled
A CUPS network server can broadcast its queues by default every 30
seconds on UDP port 631. Accordingly, the
following command can be used to test whether there is a broadcasting
CUPS network server in the network. Make sure to stop your local CUPS
daemon before executing the command.
netcat -u -l -p 631 & PID=$! ; sleep 40 ; kill $PID
If a broadcasting CUPS network server exists, the output appears as shown in Example 14.3, “Broadcast from the CUPS Network Server”.
The following command can be used to test if a TCP connection can be
established to cupsd (port 631)
on host:
netcat -z host 631 && echo ok || echo failed
If the connection to cupsd cannot be established,
cupsd may not be active or there may be basic
network problems. lpstat -h host
-l -t returns a (possibly very long) status report for all
queues on host, provided the respective
cupsd is active and the host accepts queries.
The next command can be used to test if the
queue on host
accepts a print job consisting of a single carriage-return character.
Nothing should be printed. Possibly, a blank page may be ejected.
echo -en "\r" \
| lp -d queue -h hostSpoolers running in a print server box sometimes cause problems when they have to deal with multiple print jobs. Since this is caused by the spooler in the print server box, there no way to resolve this issue. As a work-around, circumvent the spooler in the print server box by addressing the printer connected to the print server box directly with the TCP socket. See Section 14.5, “Network Printers”.
In this way, the print server box is reduced to a converter between
the various forms of data transfer (TCP/IP network and local printer
connection). To use this method, you need to know the TCP port on the
print server box. If the printer is connected to the print server box
and turned on, this TCP port can usually be determined with the
nmap utility from the
nmap package some time after the print
server box is powered up. For example, nmap
IP-address may deliver the
following output for a print server box:
Port State Service 23/tcp open telnet 80/tcp open http 515/tcp open printer 631/tcp open cups 9100/tcp open jetdirect
This output indicates that the printer connected to the print server
box can be addressed via TCP socket on port 9100.
By default, nmap only checks a number of commonly
known ports listed in
/usr/share/nmap/nmap-services. To check all
possible ports, use the command nmap
-p from_port-to_port IP-address.
This may take some time. For further information, refer to the man
page of nmap.
Enter a command like
echo -en "\rHello\r\f" | netcat -w 1 IP-address port cat file | netcat -w 1 IP-address port
to send character strings or files directly to the respective port to test if the printer can be addressed on this port.
For the print system, the print job is completed when the CUPS back-end completes the data transfer to the recipient (printer). If further processing on the recipient fails (for example, if the printer is not able to print the printer-specific data) the print system does not notice this. If the printer is not able to print the printer-specific data, select a PPD file that is more suitable for the printer.
If the data transfer to the recipient fails entirely after several
attempts, the CUPS back-end, such as USB or
socket, reports an error to the print system (to
cupsd). The back-end determines how many unsuccessful
attempts are appropriate until the data transfer is reported as
impossible. As further attempts would be in vain,
cupsd disables printing for the respective queue.
After eliminating the cause of the problem, the system administrator
must reenable printing with the command cupsenable.
If a CUPS network server broadcasts its queues to the client hosts via browsing and a suitable local cupsd is active on the client hosts, the client cupsd accepts print jobs from applications and forwards them to the cupsd on the server. When cupsd on the server accepts a print job, it is assigned a new job number. Therefore, the job number on the client host is different from the job number on the server. As a print job is usually forwarded immediately, it cannot be deleted with the job number on the client host This is because the client cupsd regards the print job as completed as soon as it has been forwarded to the server cupsd.
When it becomes desirable to delete the print job on the server, use a command such as lpstat -h cups.example.com -o to determine the job number on the server, provided the server has not already completed the print job (that is, sent it completely to the printer). Using this job number, the print job on the server can be deleted:
cancel -h cups.example.com queue-jobnumberIf you switch the printer off or shut down the computer during the printing process, print jobs remain in the queue. Printing resumes when the computer (or the printer) is switched back on. Defective print jobs must be removed from the queue with cancel.
If a print job is defective or an error occurs in the communication between the host and the printer, the printer prints numerous sheets of paper with unintelligible characters, because it is unable to process the data correctly. To rectify this situation, follow these steps:
To stop printing, remove all paper from ink jet printers or open the paper trays of laser printers. High-quality printers have a button for canceling the current printout.
The print job may still be in the queue, because jobs are only removed
after they are sent completely to the printer. Use lpstat
-o or lpstat -h cups.example.com -o to check
which queue is currently printing. Delete the print job with
cancel
queue-jobnumber
or cancel -h cups.example.com
queue-jobnumber.
Some data may still be transferred to the printer even though the print job has been deleted from the queue. Check if a CUPS back-end process is still running for the respective queue and terminate it. For example, for a printer connected to the parallel port, the command fuser -k /dev/lp0 can be used to terminate all processes that are still accessing the printer (more precisely: the parallel port).
Reset the printer completely by switching it off for some time. Then insert the paper and turn on the printer.
Use the following generic procedure to locate problems in the CUPS print system:
Set LogLevel debug in
/etc/cups/cupsd.conf.
Stop cupsd.
Remove /var/log/cups/error_log* to avoid having
to search through very large log files.
Start cupsd.
Repeat the action that led to the problem.
Check the messages in /var/log/cups/error_log* to
identify the cause of the problem.
Solutions to many specific problems are presented in the SUSE Support
Database
(http://en.opensuse.org/Portal:Support_database). Locate
the relevant articles with a text search for
SDB:CUPS.
Contents
The installation of additional fonts in openSUSE® is very easy.
Simply copy the fonts to any directory located in the X11 font path
. To the enable use of the fonts, the installation directory should be a
subdirectory of the directories configured in
/etc/fonts/fonts.conf
or included into this file with
/etc/fonts/suse-font-dirs.conf.
The following is an excerpt from
/etc/fonts/fonts.conf. This file is the standard
configuration file that should be appropriate for most configurations. It
also defines the included directory
/etc/fonts/conf.d. In this directory, all files or
symbolic links starting with a two digit number are loaded by fontconfig.
For a more detailed explanation of this functionality, have a look at
/etc/fonts/conf.d/README.
<!-- Font directory list --> <dir>/usr/share/fonts</dir> <dir>/usr/X11R6/lib/X11/fonts</dir> <dir>/opt/kde3/share/fonts</dir> <dir>/usr/local/share/fonts</dir> <dir>~/.fonts</dir>
/etc/fonts/suse-font-dirs.conf is automatically
generated to pull in fonts that ship with (mostly third party)
applications like OpenOffice.org, Java or Adobe Acrobat Reader. A typical
entry would look like the following:
<dir>/usr/lib/Adobe/Reader9/Resource/Font</dir> <dir>/usr/lib/Adobe/Reader9/Resource/Font/PFM</dir>
To install additional fonts systemwide, manually copy the font files to a
suitable directory (as root),
such as /usr/share/fonts/truetype. Alternatively,
the task can be performed with the KDE font installer in the KDE Personal
Settings. The result is the same.
Instead of copying the actual fonts, you can also create symbolic links.
For example, you may want to do this if you have licensed fonts on a
mounted Windows partition and want to use them. Subsequently, run
SuSEconfig --module fonts.
SuSEconfig --module fonts executes
the script /usr/sbin/fonts-config, which handles the
font configuration. For more information on this script, refer to its
manual page (man fonts-config).
The procedure is the same for bitmap fonts, TrueType and OpenType fonts,
and Type 1 (PostScript) fonts. All these font types can be installed
into any directory known to fonts-config.
Abstract
You can upgrade an existing system without completely reinstalling it. There are two types of renewing the system or parts of it: updating individual software packages and upgrading the entire system. Updating individual packages is covered in Chapter 5, Installing or Removing Software and Chapter 6, YaST Online Update. Two ways to upgrade the system are discussed in the following sections— see Section 16.1.3, “Upgrading with YaST” and Section 16.1.4, “Distribution Upgrade with zypper”.
Software tends to “grow” from version to version. Therefore, take a look at the available partition space with df before updating. If you suspect you are running short of disk space, secure your data before you update and repartition your system. There is no general rule regarding how much space each partition should have. Space requirements depend on your particular partitioning profile, the software selected, and the version numbers of the system.
Before upgrading, copy the old configuration files to a separate medium
(such as removable hard disk or USB flash drive) to secure the data.
This primarily applies to files stored in /etc as
well as some of the directories and files in /var.
You may also want to write the user data in /home
(the HOME directories) to a backup medium. Back up this
data as root. Only
root has read permission
for all local files.
Before starting your update, make note of the root partition. The
command df / lists the device name of the root
partition. In Example 16.1, “List with df -h”, the root partition
to write down is /dev/sda3 (mounted as
/).
Example 16.1. List with df -h¶
Filesystem Size Used Avail Use% Mounted on /dev/sda3 74G 22G 53G 29% / udev 252M 124K 252M 1% /dev /dev/sda5 116G 5.8G 111G 5% /home /dev/sda1 39G 1.6G 37G 4% /windows/C /dev/sda2 4.6G 2.6G 2.1G 57% /windows/D
If you upgrade a default system from the previous version to this version, YaST works out the necessary changes and performs them. Depending on your customizations, some steps (or the entire upgrade procedure) may fail and you must resort to copying back your backup data. Check the following issues before starting the system update.
Before upgrading the system, make sure that
/etc/passwd and /etc/group do
not contain any syntax errors. For this purpose, start the verification
utilities pwck and grpck as
root to eliminate any
reported errors.
Before updating PostgreSQL
(postgres), dump the
databases. See the manual page of pg_dump. This is
only necessary if you actually used PostgreSQL prior to your update.
Following the preparation procedure outlined in Section 16.1.1, “Preparations”, you can now upgrade your system:
Boot the system as for the installation, described in Section “System Start-Up for Installation” (Chapter 1, Installation with YaST, ↑Reference). In YaST, choose a language and select in the dialog. Do not select . Also add repositories to make sure to get all available software updated whenever possible. Find more information about installation repositories in Section “Add-On Products” (Chapter 1, Installation with YaST, ↑Reference).
YaST determines if there are multiple root partitions. If there is
only one, continue with the next step. If there are several, select
the right partition and confirm with
(/dev/sda3 was selected in the example in
Section 16.1.1, “Preparations”). YaST reads the old
fstab on this partition to analyze and mount the
file systems listed there.
![]() | Persistent Device Names |
|---|---|
All entries in | |
Check the previously used repositories, if there are any. Enable all the repositories you still want to use and from where you want to update third-party software. Click the for every list item, if appropriate.
If you added repositories during the upgrade procedure as recommended above, you now can activate those you are actually interested in.
In the dialog, adjust the settings according to your requirements. Normally, you can leave the default settings untouched. If you intend to enhance your system, however, check the packages and patterns offered in the and submenus, or add support for additional languages.
You also have the possibility to make backups of various system components. Selecting backups slows down the upgrade process. Use this option if you do not have a recent system backup.
Confirm the upgrade by clicking .
Once the basic upgrade installation is finished, YaST reboots the system. Finally, YaST updates the remaining software, if any and displays the release notes, if wanted.
With the zypper command line utility you can upgrade to the next version of the distribution. Most importantly, you can initiate the system upgrade process from within the running system.
This feature is attractive for advanced users who want to run remote upgrades or upgrades on many similarly configured systems. Inexperienced users will prefer the upgrade with YaST using a boot medium as described in Section 16.1.3, “Upgrading with YaST”.
To avoid unexpected errors during the upgrade process using zypper, minimize risky constellations.
Upgrade from the previous version (e.g., 11.3) to this version (11.4)—do not skip any minor version inbetween (this means, do not upgrade from 11.2 or earlier to 11.4 in one go). Make sure all available 11.3 online updates are successfully applied.
Close as many applications and unneeded services as possible and log out all regular users.
Disable third party or openSUSE Build Server repositories before starting the upgrade, or lower the priority of these repositories to make sure packages from the default system repositories will get preference. Enable them again after the upgrade and edit their version string to match the version number of the distribution of the upgraded now running system.
For more information, see http://en.opensuse.org/SDB:System_upgrade.
![]() | Check Your System Backup |
|---|---|
Before actually starting the upgrade procedure, check that your system backup is up-to-date and restorable. This is especially important because you must enter many of the following steps manually. | |
Run the online update to make sure the software management stack is up-to-date. For more information, see Chapter 6, YaST Online Update.
Configure the repositories you want to use as an update source. Getting this right is essential. Either use YaST (see Section 5.4, “Managing Software Repositories and Services”) or zypper (see Section 9.1, “Using Zypper”). The name of the repositories as used in the following steps could vary a little bit depending on your customizations.
To view your current repositories enter:
zypper lr -u
![]() | zypper command names |
|---|---|
zypper supports long and short command names. For example, you can abbreviate zypper install as zypper in. In the following text, the short variant is used. | |
Increase the version number of the system repositories from 11.3 to 11.4; add the new 11.4 repositories with commands such as:
server=http://download.opensuse.org new_ver=11.4 zypper ar $server/distribution/$new_ver/repo/oss/ openSUSE-$new_ver-Oss zypper ar $server/update/$new_ver/ openSUSE-$new_ver-Update
And remove the old repositories:
old_ver=11.3 zypper rr openSUSE-$old_ver-Oss zypper rr openSUSE-$old_ver-Update
Disable third party repositories or other openSUSE Build Server repositories, because
zypper dup is guaranteed to work with the default
repositories only (replace repo-alias with
the name of the repository you want to disable):
zypper mr -d repo-aliasAlternatively, you can lower the priority of these repositories.
![]() | Handling of Unresolved Dependencies |
|---|---|
zypper dup will remove all packages having unresolved dependencies, but it keeps packages of disabled repositories as long as their dependencies are satisfied. | |
zypper dup ensures that all installed packages come from one of the available repositories. It does not consider the version, architecture, or vendor of the installed packages; thus it emulates a fresh installation. Packages that are no longer available in the repositories are considered orphaned. Such packages get uninstalled if their dependencies can not be satisfied. If they can be satisfied, such packages stay installed.
Once done, check your repository configuration with:
zypper lr -d
Refresh local metadata and repository contents with zypper ref.
Pull in zypper and the package management stack from the 11.4 repository with zypper up zypper.
Run the actual distribution upgrade with zypper dup. You are asked to confirm the license.
Perform basic system configuration with SuSEconfig.
Reboot the system with shutdown -r now.
Regardless of your overall updated environment, you can always update individual packages. From this point on, however, it is your responsibility to ensure that your system remains consistent.
Use the YaST software management tool to update packages as described in Chapter 5, Installing or Removing Software. Select components from the YaST package selection list according to your needs. If a newer version of a package exists, the version numbers of the installed and the available versions are listed in blue color in the column. If you select a package essential for the overall operation of the system, YaST issues a warning. Such packages should be updated only in the update mode. For example, many packages contain shared libraries. Updating these programs and applications in the running system may lead to system instability.
Problems and special issues of the various versions are published online as they are identified. See the links listed below. Important updates of individual packages can be accessed using the YaST Online Update. For more information, see Chapter 6, YaST Online Update.
Refer to the Product highlights
(http://en.opensuse.org/Product_highlights and the
Bugs article in the openSUSE wiki at
http://en.opensuse.org/openSUSE:Most_annoying_bugs for
information about recent changes and issues.
Contents
Contents
When working with Linux these days, you can communicate with the system almost without ever requiring a command line interpreter (the shell). After booting your Linux system, you are usually directed to a graphical user interface that guides you through the login process and the following interactions with the operating system. The graphical user interface in Linux (the X Window System or X11) is initially configured during installation. Both KDE and GNOME desktop (and other window managers you can install) use it for interaction with the user.
Nevertheless, it is useful to have some basic knowledge of working with a shell because you might encounter situations where the graphical user interface is not available. For example, if some problem with the X Window System occurs. If you are not familiar with a shell, you might feel a bit uncomfortable at first when entering commands, but the more you get used to it, the more you will realize that the command line is often the quickest and easiest way to perform some daily tasks.
For UNIX or Linux several shells are available which differ slightly in behavior and in the commands they accept. The default shell in openSUSE® is Bash (GNU Bourne-Again Shell).
The following sections will guide you through your first steps with the Bash shell and will show you how to complete some basic tasks via the command line. If you are interested in learning more or rather feel like a shell “power user” already, refer to Chapter 18, Bash and Bash Scripts.
Basically, there are two different ways to start a shell from the graphical user interface which usually shows after you have booted your computer:
you can leave the graphical user interface or
you can start a terminal window within the graphical user interface.
While the first option is always available, you can only make use of the second option when you are already logged in to a desktop such as KDE or GNOME. Whichever way you choose, there is always a way back and you can switch back and forth between the shell and the graphical user interface.
If you want to give it a try, press Ctrl+Alt+F2 to leave the graphical user interface. The graphical user interface disappears and you are taken to a shell which prompts you to log in. Type your username and press Enter. Then type your password and press Enter. The prompt now changes and shows some useful information as in the following example:
![]()
![]()
tux@linux:~>
Your login. | |
The hostname of your computer. | |
Path to the current directory. Directly after login, the current
directory usually is your home directory, indicated by the
|
When you are logged in at a remote computer the information provided by the prompt always shows you which system you are currently working on.
When the cursor is located behind this prompt, you can pass
commands directly to your computer system. For example, you can now enter
ls -l to list the contents of the
current directory in a detailed format. If this is enough for your first
encounter with the shell and you want to go back to the graphical user
interface, you should log out from your shell session first. To do so,
type exit and press Enter.
Then press Alt+F7 to switch back to the graphical user interface. You will find
your desktop and the applications running on it unchanged.
When you are already logged in to the GNOME or the KDE desktop and want to start a terminal window within the desktop, press Alt+F2 and enter konsole (for KDE) or gnome-terminal (for GNOME). This opens a terminal window on your desktop. As you are already logged in to your desktop, the prompt shows information about your system as described above. You can now enter commands and execute tasks just like in any shell which runs parallel to your desktop. To switch to another application on the desktop just click on the corresponding application window or select it from the taskbar of your panel. To close the terminal window press Alt+F4.
As soon as the prompt appears on the shell it is ready to receive and execute commands. A command can consist of several elements. The first element is the actual command, followed by parameters or options. You can type a command and edit it by using the following keys: ←, →, Home, End, <— (Backspace), Del, and Space. You can correct typing errors or add options. The command is not executed until you press Enter.
![]() | No News Is Good News |
|---|---|
The shell is not verbose: in contrast to some graphical user interfaces, it usually does not provide confirmation messages when commands have been executed. Messages only appear in case of problems or errors —or if you explicitly ask for them by executing a command with a certain option. Also keep this in mind for commands to delete objects. Before entering a command like rm (without any option) for removing a file, you should know if you really want to get rid of the object: it will be deleted irretrievably, without confirmation. | |
In Section 17.5.1, “Permissions for User, Group and Others” you already got to know one of the most basic commands: ls, which used to list the contents of a directory. This command can be used with or without options. Entering the plain ls command shows the contents of the current directory:
tux@knox:~> ls bin Desktop Documents public_html tux.txt tux@knox:~>
Files in Linux may have a file extension or a suffix, such as
.txt, but do not need to have one. This makes it
difficult to differentiate between files and folders in this output of
the ls. By default, the colors in the Bash shell give
you a hint: directories are usually shown in blue, files in black.
A better way to get more details about the contents of a
directory is using the ls command with a string of
options. Options modify the way a command works so that you can get it
to carry out specific tasks. Options are separated from the command with
a blank and are usually prefixed with a hyphen. The ls
-l command shows the contents of the same
directory in full detail (long listing format):
tux@knox:~> ls -l drwxr-xr-x 1 tux users 48 2006-06-23 16:08 bin drwx---r-- 1 tux users 53279 2006-06-21 13:16 Desktop drwx------ 1 tux users 280 2006-06-23 16:08 Documents drwxr-xr-x 1 tux users 70733 2006-06-21 09:35 public_html -rw-r--r-- 1 tux users 47896 2006-06-21 09:46 tux.txt tux@knox:~>
This output shows the following information about each object:
drwxr-xr-x1
tux
users
48
2006-06-23 16:08
bin
![]()
Type of object and access permissions. For further information, refer to Section 17.5.1, “Permissions for User, Group and Others”. | |
Number of hard links to this file. | |
Owner of the file or directory. For further information, refer to Section 17.5.1, “Permissions for User, Group and Others”. | |
Group assigned to the file or directory. For further information, refer to Section 17.5.1, “Permissions for User, Group and Others”. | |
File size in bytes. | |
Date and time of the last change. | |
Name of the object. |
Usually, you can combine several options by prefixing only the first
option with a hyphen and then write the others consecutively without a
blank. For example, if you want to see all files in a directory in long
listing format, you can combine the two options -l and
-a (show all files) for the ls
command. Executing ls -la shows also
hidden files in the directory, indicated by a dot in front (for example,
.hiddenfile).
The list of contents you get with ls is sorted
alphabetically by filenames. But like in a graphical file manager, you
can also sort the output of ls -l
according to various criteria such as date, file extension or file size:
For date and time, use ls -lt
(displays newest first).
For extensions, use ls -lx
(displays files with no extension first).
For file size, use ls -lS
(displays largest first).
To revert the order of sorting, add -r as an option to
your ls command. For example, ls
-lr gives you the contents list sorted in
reverse alphabetical order, ls -ltr
shows the oldest files first. There are lots of other useful options for
ls. In the following section you will learn how to
investigate them.
Nobody is expected to know all options of all commands by heart. If you remember the command name but are not sure about the options or the syntax of the command, choose one of the following possibilities:
--help option
If you only want to look up the options of a certain command, try
entering the command followed by a space and --help.
This --help option exists for many commands. For
example, ls --help displays all
the options for the ls command.
To learn more about the various commands, you can also use the manual pages. Manual pages also give a short description of what the command does. They can be accessed with man followed by the name of the command, for example, man ls.
The man pages are displayed directly in the shell. To navigate them, move up and down with Page ↑ and Page ↓. Move between the beginning and the end of a document with Home and End. End this viewing mode by pressing Q. Learn more about the man command itself with man man.
Info pages usually provide even more information about commands. To view the info page for a certain command, enter info followed by the name of the command (for example, info ls). You can browse an info page with a viewer directly in the shell and display the different sections, called “nodes.” Use Space to move forward and <— to move backwards. Within a node, you can also browse with Page ↑ and Page ↓ but only Space and <— will take you also to the previous or subsequent node. Like for the man pages, press Q to end the viewing mode.
Note that man pages and info pages do not exist for all commands. Sometimes both are available (usually for key commands), sometimes only a man page or an info page exists, and sometimes neither of them are available.
After having entered several commands, your shell will begin to fill up with all sorts of commands and the corresponding outputs. In the following table, find some useful shortcut keys for navigating and editing in the shell.
|
Shortcut Key |
Function |
|---|---|
|
Ctrl+L |
Clears the screen and moves the current line to the top of the page. |
|
Ctrl+C |
Aborts the command which is currently being executed. |
|
Shift+Page ↑ |
Scrolls upwards. |
|
Shift+Page ↓ |
Scrolls downwards. |
|
Ctrl+U |
Deletes from cursor position to start of line. |
|
Ctrl+K |
Deletes from cursor position to the end of line. |
|
Ctrl+D |
Closes the shell session. |
|
↑, ↓ |
Browses in the history of executed commands. |
To address a certain file or directory, you must specify the path leading to that directory or file. As you may know from MS DOS or Mac OS already, there are two ways to specify a path:
Enter the entire path from the root directory to the relevant file or directory.
Enter a path to the relevant file or directory by using the current directory as a starting point. This implies to give the levels you have to move up or down in the file system tree to reach the target directory of file, starting from the current directory.
Paths contain filenames, directories or both, separated by slashes. Absolute paths always start with a slash. Relative paths do not have a slash at the beginning, but can have one or two dots.
When entering commands, you can choose either way to specify a path, depending on your preferences or the amount of typing, both will lead to the same result. To change directories, use the cd command and specify the path to the directory.
![]() | Handling Blanks in Filenames or Directory Names |
|---|---|
If a filename or the name of a directory contains a space, either escape
the space using a back slash ( | |
When specifying paths, the following “shortcuts” can save you a lot of typing:
The tilde symbol (~) is a shortcut for home
directories. For example, to list the contents of your home directory,
use ls ~. To list the contents of
another user's home directory, enter ls
~ (or
course, this will only work if you have permission to view the
contents, see Section 17.5, “File Access Permissions”). For example,
entering ls ~tux would list the contents of the home
directory of a user named
username tux. You can use the
tilde symbol as shortcut for home directories also if you are working
in a network environment where your home directory may not be called
/home but can be mapped to any directory in the
file system.
From anywhere in the file system, you can reach your home directory by
entering cd ~ or by simply entering
cd without any options.
When using relative paths, refer to the current directory with a dot
(.). This is mainly useful for commands such as
cp or mv by which you can copy or
move files and directories.
The next higher level in the tree is represented by two dots
(..). In order to switch to the parent directory of
your current directory, enter cd .., to go up two
levels from the current directory enter cd ../..
etc.
To apply your knowledge, find some examples below. They address basic tasks you may want to execute with files or folders using Bash.
Suppose you want to copy a file located somewhere in your home directory
to a subdirectory of /tmp that you need to create
first.
Procedure 17.1. Creating and Changing Directories
From your home directory create a subdirectory in
/tmp:
Enter
mkdir /tmp/test
mkdir stands for “make directory”.
This command creates a new directory named test
in the /tmp directory. In this case, you are
using an absolute path to create the test
directory.
To check what happened, now enter
ls -l /tmp
The new directory test should appear in the list
of contents of the /tmp directory.
Switch to the newly created directory with
cd /tmp/test
Procedure 17.2. Creating and Copying Files
Now create a new file in a subdirectory of your home directory and copy
it to /tmp/test. Use a relative path for this
task.
![]() | Overwriting of Existing Files |
|---|---|
Before copying, moving or renaming a file, check if your target
directory already contains a file with the same name. If yes, consider
changing one of the filenames or use cp or
mv with options like | |
To list the contents of your home directory, enter
ls -l ~
It should contain a subdirectory called Documents
by default. If not, create this subdirectory with the
mkdir command you already know:
mkdir ~/Documents
To create a new, empty file named myfile.txt in
the Documents directory, enter
touch ~/Documents/myfile.txt
Usually, the touch command updates the modification and access date for an existing file. If you use touch with a filename which does not exist in your target directory, it creates a new file.
Enter
ls -l ~/Documents
The new file should appear in the list of contents.
To copy the newly created file, enter
cp ~/Documents/myfile.txt .
Do not forget the dot at the end.
This command tells Bash to go to your home directory and to copy
myfile.txt from the
Documents subdirectory to the current directory,
/tmp/test, without changing the name of the file.
Check the result by entering
ls -l
The file myfile.txt should appear in the list of
contents for /tmp/test.
Procedure 17.3. Renaming and Removing Files or Directories
Now suppose you want to rename myfile.txt into
tuxfile.txt. Finally you decide to remove the
renamed file and the test subdirectory.
To rename the file, enter
mv myfile.txt tuxfile.txt
To check what happened, enter
ls -l
Instead of myfile.txt,
tuxfile.txt should appear in the list of
contents.
mv stands for move and is used
with two options: the first option specifies the source, the second
option specifies the target of the operation. You can use
mv either
to rename a file or a directory,
to move a file or directory to a new location or
to do both in one step.
Coming to the conclusion that you do not need the file any longer, you can delete it by entering
rm tuxfile.txt
Bash deletes the file without any confirmation.
Move up one level with cd .. and check with
ls -l test
if the test directory is empty now.
If yes, you can remove the test directory by
entering
rmdir test
root, also called the superuser, has privileges which authorize him
to access all parts of the system and to execute administrative tasks. He
or she has the unrestricted capacity to make changes to the system and
has unlimited access to all files. Therefore performing some
administrative tasks or running certain programs such as YaST requires
root permissions.
In order to temporarily become root in a shell, proceed as
follows:
Enter su. You are prompted for the root
password.
Enter the password. If you mistyped the root password, the shell
displays a message. In this case, you have to re-enter
su before retyping the password. If your password
is correct, a hash symbol # appears at the end of
the prompt, signaling that you are acting as root now.
Execute your task. For example, transfer ownership of a file to a new
user which only root is allowed to do:
chown wilber kde_quick.xml
After having completed your tasks as root, switch back to your
normal user account. To do so, enter
exit
The hash symbol disappears and you are acting as “normal” user again.
Alternatively, you can also use sudo (superuser
“do”) to execute some tasks which normally are for
roots only. With sudo, administrators can grant certain users
root privileges for some commands. Depending on the system
configuration, users can then run root commands by entering their
normal password only. Due to a timestamp function, users are only
granted a “ticket” for a restricted period of time after
having entered their password. The ticket usually expires after a few
minutes. In openSUSE, sudo requires the root password by default
(if not configured otherwise by your system administrator).
For users, sudo is convenient as it prevents you from switching accounts
twice (to root and back again). To change the ownership of a file
using sudo, only one command is necessary instead of three:
sudo chown wilber kde_quick.xml
After you have entered the password which you are prompted for, the
command is executed. If you enter a second root command shortly
after that, you are not prompted for the password again, because your
ticket is still valid. After a certain amount of time, the ticket
automatically expires and the password is required again. This also
prevents unauthorized persons from gaining root privileges in case
a user forgets to switch back to his normal user account again and
leaves a root shell open.
In Linux, objects such as files or folders or processes generally belong to the user who created or initiated them. There are some exceptions to this rule. For more information about the exceptions, refer to Chapter 9, Access Control Lists in Linux (↑Security Guide). The group which is associated with a file or a folder depends on the primary group the user belongs to when creating the object.
When you create a new file or directory, initial access permissions for
this object are set according to a predefined scheme. As an owner of a
file or directory, you can change the access permissions for this object.
For example, you can protect files holding sensitive data against read
access by other users and you can authorize the members of your group or
other users to write, read, or execute several of your files where
appropriate. As root, you can also change the ownership of files or
folders.
Three permission sets are defined for each file object on a Linux system. These sets include the read, write, and execute permissions for each of three types of users—the owner, the group, and other users.
The following example shows the output of an ls
-l command in a shell. This command lists the
contents of a directory and shows the details for each file and folder in
that directory.
Example 17.1. Access Permissions For Files and Folders¶
-rw-r----- 1 tux users 0 2006-06-23 16:08 checklist.txt -rw-r--r-- 1 tux users 53279 2006-06-21 13:16 gnome_quick.xml -rw-rw---- 1 tux users 0 2006-06-23 16:08 index.htm -rw-r--r-- 1 tux users 70733 2006-06-21 09:35 kde-start.xml -rw-r--r-- 1 tux users 47896 2006-06-21 09:46 kde_quick.xml drwxr-xr-x 2 tux users 48 2006-06-23 16:09 local -rwxr--r-- 1 tux users 624398 2006-06-23 15:43 tux.sh
As shown in the third column, all objects belong to user
tux. They are
assigned to the group
users which is the
primary group the user tux belongs to.
To retrieve the access permissions the first column of the list must be
examined more closely. Let's have a look at the file
kde-start.xml:
|
Type |
User Permissions |
Group Permissions |
Permissions for Others |
|
|
|
|
|
The first column of the list consists of one leading character followed
by nine characters grouped in three blocks. The leading character
indicates the file type of the object: in this case, the hyphen
(–) shows that
kde-start.xml is a file. If you find the character
d instead, this shows that the object is a directory,
like local in
Example 17.1, “Access Permissions For Files and Folders”.
The next three blocks show the access permissions for the owner, the
group and other users (from left to right). Each block follows the same
pattern: the first position shows read permissions
(r), the next position shows write permissions
(w), the last one shows execute permission
(x). A lack of either permission is indicated by
-. In our example, the owner of
kde-start.xml has read and write access to the file
but cannot execute it. The users group can read
the file but cannot write or execute it. The same holds true for the
other users as shown in the third block of characters.
Access permissions have a slightly different impact depending on the type of object they apply to: file or directory. The following table shows the details:
Table 17.1. Access Permissions For Files And Directories¶
|
Access Permission |
File |
Folder |
|---|---|---|
|
Read (r) |
Users can open and read the file. |
Users can view the contents of the directory. Without this
permission, users cannot list the contents of this directory with
ls |
|
Write (w) |
Users can change the file: They can add or drop data and can even delete the contents of the file. However, this does not include the permission to remove the file completely from the directory as long as they do not have write permissions for the directory where the file is located. |
Users can create, rename or delete files in the directory. |
|
Execute (x) |
Users can execute the file. This permission is only relevant for files like programs or shell scripts, not for text files. If the operating system can execute the file directly, users do not need read permission to execute the file. However, if the file must me interpreted like a shell script or a perl program, additional read permission is needed. |
Users can change into the directory and execute files there. If they do not have read access to that directory they cannot list the files but can access them nevertheless if they know of their existence. |
Note that access to a certain file is always dependent on the correct combination of access permissions for the file itself and the directory it is located in.
In Linux, objects such as files or folder or processes generally belong to the user who created or initiated them. The group which is associated with a file or a folder depends on the primary group the user belongs to when creating the object. When you create a new file or directory, initial access permissions for this object are set according to a predefined scheme. For further details refer to Section 17.5, “File Access Permissions”.
As the owner of a file or directory (and, of course, as
root), you can change the
access permissions to this object.
To change object attributes like access permissions of a file or folder, use the chmod command followed by the following parameters:
the users for which to change the permissions,
the type of access permission you want to remove, set or add and
the files or folders for which you want to change permissions separated by spaces.
The users for which you can change file access permissions fall into the
following categories: the owner of the file (user, u),
the group that own the file (group, g) and the other
users (others, o). You can add, remove or set one or
more of the following permissions: read, write or execute.
As root, you can also change the ownership of a file: with the
command chown (change owner) you can transfer ownership to a new user.
The following example shows the output of an ls
-l command in a shell.
Example 17.2. Access Permissions For Files and Folders¶
-rw-r----- 1 tux users 0 2006-06-23 16:08 checklist.txt -rw-r--r-- 1 tux users 53279 2006-06-21 13:16 gnome_quick.xml -rw-rw---- 1 tux users 0 2006-06-23 16:08 index.htm -rw-r--r-- 1 tux users 70733 2006-06-21 09:35 kde-start.xml -rw-r--r-- 1 tux users 47896 2006-06-21 09:46 kde_quick.xml drwxr-xr-x 2 tux users 48 2006-06-23 16:09 local -r-xr-xr-x 1 tux users 624398 2006-06-23 15:43 tux.jpg
In the example above, user tux owns
the file kde-start.xml and has read and write
access to the file but cannot execute it. The
users group can read the file but cannot write
or execute it. The same holds true for the other users as shown by the
third block of characters.
Procedure 17.4. Changing Access Permissions
Suppose you are tux and want to
modify the access permissions to your files:
If you want to grant the users group also
write access to kde-start.xml, enter
chmod g+w kde-start.xml
To grant the users group and other users
write access to kde-start.xml, enter
chmod go+w kde-start.xml
To remove write access for all users, enter
chmod -w kde-start.xml
If you do not specify any kind of users, the changes apply to all
users— the owner of the file, the owning group and the others.
Now even the owner tux does not
have write access to the file without first reestablishing write
permissions.
To prohibit the usersgroup and others to
change into the directory local, enter
chmod go-x local
To grant others write permissions for two files, for
kde_quick.xml and
gnome_quick.xml, enter
chmod o+w kde_quick.xml gnome_quick.xml
Procedure 17.5. Changing Ownership
Suppose you are tux and want to
transfer the ownership of the file kde_quick.xml
to an other user, named wilber. In
this case, proceed as follows:
Enter the username and password for root.
Enter
chown wilber kde_quick.xml
Check what happened with
ls -l kde_quick.xml
You should get the following output:
-rw-r--r-- 1 wilber users 47896 2006-06-21 09:46 kde_quick.xml
If the ownership is set according to your wishes, switch back to your normal user account.
As you probably noticed in the examples above, entering commands in Bash can include a lot of typing. In the following, get to know some features of the Bash that can make your work a lot easier and save a lot of typing.
By default, Bash “remembers” commands you have entered. This feature is called history. You can browse through commands that have been entered before, select one you want to repeat and then execute it again. To do so, press ↑ repeatedly until the desired command appears at the prompt. To move forward through the list of previously entered commands, press ↓. For easier repetition of a certain command from Bash history, just type the first letter of the command you want to repeat and press Page ↑.
You can now edit the selected command (for example, change the name of a file or a path), before you execute the command by pressing Enter. To edit the command line, just move the cursor to the desired position using the arrow keys and start typing.
You can also search for a certain command in the history. Press Ctrl+R to start an incremental search function. showing the following prompt:
(reverse-i-search)`':
Just type one or several letters from the command you are searching for. Each character you enter narrows down the search. The corresponding search result is shown on the right side of the colon whereas your input appears on the left of the colon. To accept a search result, press Esc. The prompt now changes to its normal appearance and shows the command you chose. You can now edit the command or directly execute it by pressing Enter.
Completing a filename or directory name to its full length after typing its first letters is another helpful feature of Bash. To do so, type the first letters then press →| (Tabulator). If the filename or path can be uniquely identified, it is completed at once and the cursor moves to the end of the filename. You can then enter the next option of the command, if necessary. If the filename or path cannot be uniquely identified (because there are several filenames starting with the same letters), the filename or path is only completed up to the point where it becomes ambiguous again. You can then obtain a list of them by pressing →| a second time. After this, you can enter the next letters of the file or path then try completion again by pressing →|. When completing filenames and paths with the help of →|, you can simultaneously check whether the file or path you want to enter really exists (and you can be sure of getting the spelling right).
You can replace one or more characters in a filename with a wild card for pathname expansion. Wild cards are characters that can stand for other characters. There are three different types of these in Bash:
|
Wild Card |
Function |
|
|
Matches exactly one arbitrary character |
|
|
Matches any number of characters |
|
|
Matches one of the characters from the group specified inside the
square brackets, which is represented here by the string
|
The following examples illustrate how to make use of these convenient features of Bash.
Procedure 17.6. Using History and Completion
If you already did the example Section 17.3.1, “Examples for Working with Files and Directories” your shell buffer should be filled with commands which you can retrieve using the history function.
Press ↑ repeatedly until cd ~ appears.
Press Enter to execute the command and to switch to your home directory.
By default, your home directory contains two subdirectories starting
with the same letter, Documents and
Desktop.
Enter cd D and press →|.
Nothing happens since Bash cannot identify to which one of the subdirectories you want to change.
Press →| again to see the list of possible choices:
tux@knox:~> cd D Desktop/ Documents/ tux@knox:~> cd D
The prompt still shows your initial input. Type the next character of the subdirectory you want to go to and press →| again.
Bash now completes the path.
You can now execute the command with Enter.
Procedure 17.7. Using Wildcards
Now suppose that your home directory contains a number of files with
various file extensions. It also holds several versions of one file
which you saved under different filenames
myfile1.txt, myfile2.txt etc.
You want to search for certain files according to their properties.
First, create some test files in your home directory:
Use the touch command to create several (empty)
files with different file extensions, for example
.pdf, .xml and
.jpg.
You can do this consecutively (do not forget to use the Bash history function) or with only one touch command: simply add several filenames separated by a space.
Create at least two files that have the same file extension, for
example .html.
To create several “versions” of one file, enter
touch myfile{1..5}.txtThis command creates five consecutively numbered files:
myfile1.txt,…,myfile5.txt
List the contents of your home directory. It should look similar to this:
-rw-r--r-- 1 tux users 0 2006-07-14 13:34 foo.xml
-rw-r--r-- 1 tux users 0 2006-07-14 13:47 home.html
-rw-r--r-- 1 tux users 0 2006-07-14 13:47 index.html
-rw-r--r-- 1 tux users 0 2006-07-14 13:47 toc.html
-rw-r--r-- 1 tux users 0 2006-07-14 13:34 manual.pdf
-rw-r--r-- 1 tux users 0 2006-07-14 13:49 myfile1.txt
-rw-r--r-- 1 tux users 0 2006-07-14 13:49 myfile2.txt
-rw-r--r-- 1 tux users 0 2006-07-14 13:49 myfile3.txt
-rw-r--r-- 1 tux users 0 2006-07-14 13:49 myfile4.txt
-rw-r--r-- 1 tux users 0 2006-07-14 13:49 myfile5.txt
-rw-r--r-- 1 tux users 0 2006-07-14 13:32 tux.png
With the help of wild cards, select certain subsets of the files according to various criteria:
To list all files with the .html extension,
enter
ls -l *.html
To list all “versions” of
myfile.txt, enter
ls -l myfile?.txt
Note that you can only use the ? wild card here
because the numbering of the files is single-digit. As soon as you
have a file named myfile10.txt you must to use
the * wild card to view all versions of
myfile.txt (or add another question mark, so
your string looks like myfile??.txt).
To remove, for example, version 1-3 and version 5 of
myfile.txt, enter
rm myfile[1-3,5].txt
Check the result with
ls -l
Of all myfile.txt versions only
myfile4.txt should be left.
You can also combine several wild cards in one command. In the example
above, rm myfile[1-3,5].* would lead to the same
result as rm myfile[1-3,5].txt because there are only
files with the extension .txt available.
![]() | Using Wildcards in rm Commands |
|---|---|
Wildcards in a rm command can be very useful but also dangerous: you might delete more files from your directory than intended. To see which files would be affected by the rm, run your wildcard string with ls instead of rm first. | |
In order to edit files from the command line, you will need to know the vi editor. vi is a default editor which can be found on nearly every UNIX/Linux system. It can run several operating modes in which the keys you press have different functions. This does not make it very easy for beginners, but you should know at least the most basic operations with vi. There may be situations where no other editor than vi is available.
Basically, vi makes use of three operating modes:
In this mode, vi accepts certain key combinations as commands. Simple tasks such as searching words or deleting a line can be executed.
In this mode, you can write normal text.
In this mode, also known as colon mode (as you have to enter a colon to switch to this mode), vi can execute also more complex tasks such as searching and replacing text.
In the following (very simple) example, you will learn how to open and edit a file with vi, how to save your changes and quit vi.
![]() | Display of Keys |
|---|---|
In the following, find several commands that you can enter in vi by just pressing keys. These appear in uppercase as on a keyboard. If you need to enter a key in uppercase, this is stated explicitly by showing a key combination including the Shift key. | |
To create and open a new file with vi, enter
vi textfile.txt
By default, vi opens in command mode in which you cannot enter text.
Press I to switch to insert mode. The bottom line changes and indicates that you now can insert text.
Write some sentences. If you want to insert a new line, first press Esc to switch back to command mode. Press O to insert a new line and to switch to insert mode again.
In the insert mode, you can edit the text with the arrow keys and with Del.
To leave vi, press Esc to switch to command mode again. Then press : which takes you to the extended mode. The bottom line now shows a colon.
To leave vi and save your changes, type wq
(w for write;
q for quit) and press
Enter. If you want to save the file under
a different name, type w
filename and press
Enter.
To leave vi without saving, type q! instead and press Enter.
Bash offers you several commands to search for files and to search for the contents of files:
This utility is only available if you have installed the
findutils-locate
package. With this command you can find out in which directory a
specified file is located. If desired, use wild cards to specify
filenames. The program is very quick, because it uses a database
specifically created for the purpose (rather than searching through
the entire file system). This very fact, however, also results in a
major drawback: locate is unable to find any files created after the
latest update of its database. The database can be generated by
root running
updatedb.
With find, search for a file in a given directory.
The first argument specifies the directory in which to start the
search. The option -name must be followed by a search
string, which may also include wild cards. Unlike
locate, which uses a database,
find scans the actual directory.
The grep command finds a specific search string in
the specified text files. If the search string is found, the command
displays the line in which searchstring was found,
along with the filename. If desired, use wild cards to specify
filenames.
The KDE and GNOME desktops store user-specific application data in
hidden directories, for example .kde and
.gnome.
To locate these directories on your computer, enter
locate .kde
if you have installed KDE desktop or
locate .gnome
if you have installed GNOME desktop.
You will see that locate displays all file names in
the database that contain the string .kde or
.gnome anywhere. To learn how to modify this
behavior refer to the man page of locate.
To search your home directory for all occurrences of filenames that
contain the file extension .txt, use
find ~ -name '*.txt' -print
To search a directory (in this case, your home directory) for all
occurrences of files which contain, for example, the word
music, enter
grep music ~/*
Note that grep is case-sensitive— unless you use it with the
-i option. With the command above you will not find
any files containing Music.
If you want to use a search string which consists of more than one word, enclose the string in double quotation marks, for example:
grep "music is great" ~/*
When searching for the contents of a file with grep,
the output gives you the line in which the
searchstring was found along with the filename. Often
this contextual information is still not enough information to decide
whether you want to open and edit this file. Bash offers you several
commands to have a quick look at the contents of a text file directly in
the shell, without opening an editor.
With head you can view the first lines of a text file. If you do not specify the command any further, head shows the first 10 lines of a text file.
The tail command is the counterpart of head. If you use tail without any further options it displays the last 10 lines of a text file. This can be very useful to view log files of your system, where the most recent messages or log entries are usually found at the end of the file.
With less, display the whole contents of a text file. To move up and down half a page use Page ↑ and Page ↓. Use Space to scroll down one page. Home takes you to the beginning, and End to the end of the document. To end the viewing mode, press Q.
Instead of less, you can also use the older program
more. It has basically the same
function—however, it is less convenient because it does not
allow you to scroll backwards. Use Space to move
forward. When you reach the end of the document, the viewer closes
automatically.
The cat command displays the contents of a file, printing the entire contents to the screen without interruption. As cat does not allow you to scroll it is not very useful as viewer but it is rather often used in combination with other commands.
Sometimes it would be useful if you could write the output of a command to a file for further editing or if you could combine several commands, using the output of one command as the input for the next one. The shell offers this function by means of redirection or pipes.
Normally, the standard output in the shell is your screen (or an open shell window) and the standard input is the keyboard. With the help of certain symbols you can redirect the input or the output to another object, such as a file or another command.
With > you can forward the output of a command
to a file (output redirection), with < you can
use a file as input for a command (input redirection).
By means of a pipe symbol | you can also redirect
the output: with a pipe, you can combine several commands, using the
output of one command as input for the next command. In contrast to
the other redirection symbols > and <, the use of the pipe is
not constrained to files.
To write the output of a command like ls to a file, enter
ls -l > filelist.txt
This creates a file named filelist.txt that
contains the list of contents of your current directory as generated
by the ls command.
However, if a file named filelist.txt already
exists, this command overwrites the existing file. To prevent this,
use >> instead of >. Entering
ls -l >> filelist.txt
simply appends the output of the ls command to an
already existing file named filelist.txt. If the
file does not exist, it is created.
Redirections also works the other way round. Instead of using the standard input from the keyboard for a command, you can use a file as input:
sort < filelist.txt
This will force the sort command to get its input
from the contents of filelist.txt. The result is
shown on the screen. Of course, you can also write the result into
another file, using a combination of redirections:
sort < filelist.txt > sorted_filelist.txt
If a command generates a lengthy output, like ls
-l may do, it may be useful to pipe the
output to a viewer like less to be able to scroll
through the pages. To do so, enter
ls -l | less
The list of contents of the current directory is shown in
less.
The pipe is also often used in combination with the
grep command in order to search for a certain
string in the output of another command. For example, if you want to
view a list of files in a directory which are owned by the user
tux, enter
ls -l | grep tux
As you have seen in Section 17.7, “Editing Texts”, programs can be
started from the shell. Applications with a graphical user interface need
the X Window System and can only be started from a terminal window within
a graphical user interface. For example, if you want to open a file named
vacation.pdf in your home directory from a terminal
window in KDE or GNOME, simply run
okular ~/vacation.pdf (or
evince ~/vacation.pdf) to start a PDF viewer
displaying your file.
When looking at the terminal window again you will realize that the
command line is blocked as long as the PDF viewer is open, meaning that
your prompt is not available. To change this, press Ctrl+Z to suspend
the process and enter bg to send the process to the background.
Now you can still have a look at vacation.pdf while
your prompt is available for further commands. An easier way to achieve
this is by sending a process to the background directly when starting it.
To do so, add an ampersand at the end of the command:
okular ~/vacation.pdf &
If you have started several background processes (also named jobs) from the same shell, the jobs command gives you an overview of the jobs. It also shows the job number in brackets and their status:
tux@linux:~> jobs [1] Running okular book.opensuse.startup-xep.pdf & [2]- Running okular book.opensuse.reference-xep.pdf & [3]+ Stopped man jobs
To bring a job to the foreground again, enter fg job_number.
Whereas job only shows the background processes started from a specific shell, the ps command (run without options) shows a list of all your processes—those you started. Find an example output below:
tux@linux:~> ps PID TTY TIME CMD 15500 pts/1 00:00:00 bash 28214 pts/1 00:00:00 okular 30187 pts/1 00:00:00 kwrite 30280 pts/1 00:00:00 ps
In case a program cannot be terminated in the normal way, use the kill command to stop the process (or processes) belonging to that program. To do so, specify the process ID (PID) shown by the output of ps. For example, to shut down the KWrite editor in the example above, enter
kill 30187
This sends a TERM signal that instructs the program to shut itself down.
Alternatively, if the program or process you want to terminate is a
background job and is shown by the jobs command, you
can also use the kill command in combination with the
job number to terminate this process. When identifying the job with the
job number, you must prefix the number with a percent character
(%):
kill %job_numberIf kill does not help—as is sometimes the case for “runaway” programs—try
kill -9 PIDThis sends a KILL signal instead of a TERM signal, bringing the specified process to an end in most cases.
This section is intended to introduce the most basic set of commands for handling jobs and processes. Find an overview for system administrators in Section “Processes” (Chapter 2, System Monitoring Utilities, ↑System Analysis and Tuning Guide).
This section gives insight into the most important commands. There are many more commands than listed in this chapter. Along with the individual commands, parameters are listed and, where appropriate, a typical sample application is introduced. To learn more about the various commands, use the manual pages, accessed with man followed by the name of the command, for example, man ls.
Man pages are displayed directly in the shell. To navigate them, move up and down with Page ↑ and Page ↓. Move between the beginning and the end of a document with Home and End. End this viewing mode by pressing Q. Learn more about the man command itself with man man.
In the following overview, the individual command elements are written in
different typefaces. The actual command and its mandatory options are
always printed as command option. Specifications or
parameters that are not required are placed in [square
brackets].
Adjust the settings to your needs. It makes no sense to write ls
file if no file named file actually exists.
You can usually combine several parameters, for example, by writing
ls -la instead of ls -l -a.
The following section lists the most important commands for file management. It covers everything from general file administration to the manipulation of file system ACLs.
[options] [files]
If you run ls without any additional parameters, the program lists the contents of the current directory in short form.
-l
Detailed list
-a
Displays hidden files
[options] source target
Copies source to target.
Waits for confirmation, if necessary, before an existing
target is overwritten
Copies recursively (includes subdirectories)
[options] source target
Copies source to target
then deletes the original source.
Creates a backup copy of the source before
moving
Waits for confirmation, if necessary, before an existing
targetfile is overwritten
[options] files
Removes the specified files from the file system. Directories are not
removed by rm unless the option
-r is used.
-r
Deletes any existing subdirectories
-i
Waits for confirmation before deleting each file
[options] source target
Creates an internal link from source to
target. Normally, such a link points directly to
source on the same file system. However, if
ln is executed with the -s
option, it creates a symbolic link that only points to the directory
in which source is located, enabling linking
across file systems.
Creates a symbolic link
[options] [directory]
Changes the current directory. cd without any parameters changes to the user's home directory.
[options] directory
Creates a new directory.
[options] directory
Deletes the specified directory if it is already empty.
[options] username[:[group]] files
Transfers ownership of a file to the user with the specified username.
-R
Changes files and directories in all subdirectories
[options] groupname files
Transfers the group ownership of a given file to
the group with the specified group name. The file owner can change
group ownership only if a member of both the current and the new
group.
[options] mode files
Changes the access permissions.
The mode parameter has three parts:
group, access, and
access type. group accepts the
following characters:
User
Group
Others
For access, grant access with +
and deny it with -.
The access type is controlled by the following
options:
Read
Write
Execute—executing files or changing to the directory
Setuid bit—the application or program is started as if it were started by the owner of the file
As an alternative, a numeric code can be used. The four digits of this code are composed of the sum of the values 4, 2, and 1—the decimal result of a binary mask. The first digit sets the set user ID (SUID) (4), the set group ID (2), and the sticky (1) bits. The second digit defines the permissions of the owner of the file. The third digit defines the permissions of the group members and the last digit sets the permissions for all other users. The read permission is set with 4, the write permission with 2, and the permission for executing a file is set with 1. The owner of a file would usually receive a 6 or a 7 for executable files.
[parameters] files
This program compresses the contents of files using complex
mathematical algorithms. Files compressed in this way are given the
extension .gz and need to be uncompressed before
they can be used. To compress several files or even entire
directories, use the tar command.
Decompresses the packed gzip files so they return to their original size and can be processed normally (like the command gunzip)
options archive files
tar puts one or more files into an archive. Compression is optional. tar is a quite complex command with a number of options available. The most frequently used options are:
-f
Writes the output to a file and not to the screen as is usually the case
-c
Creates a new tar archive
-r
Adds files to an existing archive
-t
Outputs the contents of an archive
-u
Adds files, but only if they are newer than the files already contained in the archive
-x
Unpacks files from an archive (extraction)
-z
Packs the resulting archive with gzip
-j
Compresses the resulting archive with bzip2
-v
Lists files processed
The archive files created by tar end with
.tar. If the tar archive was also compressed
using gzip, the ending is
.tgz or .tar.gz. If it was
compressed using bzip2, the ending is
.tar.bz2.
patterns
This command is only available if you have installed the
findutils-locate package.
The locate command can find in which directory a
specified file is located. If desired, use wild cards to specify filenames. The program is very fast, because
it uses a database specifically created for the purpose (rather than
searching through the entire file system). This very fact, however,
also results in a major drawback: locate is unable to find any files
created after the latest update of its database. The database can be
generated by root with
updatedb.
[options]
This command performs an update of the database used by
locate. To include files in all existing
directories, run the program as
root. It also makes sense
to place it in the background by appending an ampersand
(&), so you can immediately continue
working on the same command line (updatedb &).
This command usually runs as a daily cron job (see
cron.daily).
[options]
With find, search for a file in a given directory. The first argument specifies the directory in which to start the search. The option -name must be followed by a search string, which may also include wild cards. Unlike locate, which uses a database, find scans the actual directory.
[options] files
The cat command displays the contents of a file, printing the entire contents to the screen without interruption.
Numbers the output on the left margin
[options] files
This command can be used to browse the contents of the specified file. Scroll half a screen page up or down with PgUp and PgDn or a full screen page down with Space. Jump to the beginning or end of a file using Home and End. Press Q to exit the program.
[options] searchstring files
The grep command finds a specific search string in the specified
files. If the search string is found, the command displays the line
in which searchstring was found along with the
filename.
-i
Ignores case
-H
Only displays the names of the relevant files, but not the text lines
-n
Additionally displays the numbers of the lines in which it found a hit
-l
Only lists the files in which searchstring does
not occur
[options] file1 file2
The diff command compares the contents of any two files. The output produced by the program lists all lines that do not match. This is frequently used by programmers who need only to send their program alterations and not the entire source code.
-q
Only reports whether the two files differ
-u
Produces a “unified” diff, which makes the output more readable
[options] [device] mountpoint
This command can be used to mount any data media, such as hard disks, CD-ROM drives, and other drives, to a directory of the Linux file system.
-r
Mount read-only
-t filesystem
Specify the file system, commonly ext2 for
Linux hard disks, msdos for MS-DOS media,
vfat for the Windows file system, and
iso9660 for CDs
For hard disks not defined in the file
/etc/fstab, the device type must also be
specified. In this case, only
root can mount it. If the
file system needs to also be mounted by other users, enter the option
user in the appropriate line in the
/etc/fstab file (separated by commas) and save
this change. Further information is available in the
mount(1) man page.
[options] mountpoint
This command unmounts a mounted drive from the file system. To
prevent data loss, run this command before taking a removable data
medium from its drive. Normally, only
root is allowed to run the
commands mount and umount. To
enable other users to run these commands, edit the
/etc/fstab file to specify the option
user for the relevant drive.
The following section lists a few of the most important commands needed for retrieving system information and controlling processes and the network.
[options] [directory]
The df (disk free) command, when used without any options, displays information about the total disk space, the disk space currently in use, and the free space on all the mounted drives. If a directory is specified, the information is limited to the drive on which that directory is located.
-h
Shows the number of occupied blocks in gigabytes, megabytes, or kilobytes—in human-readable format
-T
Type of file system (ext2, nfs, etc.)
[options] [path]
This command, when executed without any parameters, shows the total disk space occupied by files and subdirectories in the current directory.
-a
Displays the size of each individual file
-h
Output in human-readable form
-s
Displays only the calculated total size
[options]
The command free displays information about RAM and swap space usage, showing the total and the used amount in both categories. See Section “The free Command” (Chapter 7, Special System Features, ↑Reference) for more information.
-b
Output in bytes
-k
Output in kilobytes
-m
Output in megabytes
[options]
This simple program displays the current system time. If run as
root, it can also be used
to change the system time. Details about the program are available in
the date(1) man page.
[options]
top provides a quick overview of the currently running processes. Press H to access a page that briefly explains the main options for customizing the program.
[options] [process_ID]
If run without any options, this command displays a table of all your own programs or processes—those you started. The options for this command are not preceded by hyphen.
Displays a detailed list of all processes, independent of the owner
[options] process_ID
Unfortunately, sometimes a program cannot be terminated in the normal way. In most cases, you should still be able to stop such a runaway program by executing the kill command, specifying the respective process ID (see top and ps). kill sends a TERM signal that instructs the program to shut itself down. If this does not help, the following parameter can be used:
Sends a KILL signal instead of a TERM signal, bringing the specified process to an end in almost all cases
[options] processname
This command is similar to kill, but uses the process name (instead of the process ID) as an argument, killing all processes with that name.
[options] hostname_or_IP address
The ping command is the standard tool for testing the basic functionality of TCP/IP networks. It sends a small data packet to the destination host, requesting an immediate reply. If this works, ping displays a message to that effect, which indicates that the network link is basically functioning.
-cnumber
Determines the total number of packages to send and ends after they have been dispatched (by default, there is no limitation set)
-f
flood ping: sends as many data packages as
possible; a popular means, reserved for
root, to test networks
-ivalue
Specifies the interval between two data packages in seconds (default: one second)
[options] hostname [server]
The domain name system resolves domain names to IP addresses. With this tool, send queries to name servers (DNS servers).
[options] [user@]hostname [command]
SSH is actually an Internet protocol that enables you to work on remote hosts across a network. SSH is also the name of a Linux program that uses this protocol to enable operations on remote computers.
[options] [username]
Users may change their own passwords at any time using this command.
The administrator root can
use the command to change the password of any user on the system.
[options] [username]
The su command makes it possible to log in under a
different username from a running session. Specify a username and the
corresponding password. The password is not required from
root, because
root is authorized to
assume the identity of any user. When using the command without
specifying a username, you are prompted for the
root password and change to
the superuser (root). Use
su - to start a login shell for a different user.
[options]
To avoid loss of data, you should always use this program to shut down your system.
[options]
Does the same as halt except the system performs an immediate reboot.
This command cleans up the visible area of the console. It has no options.
There are many more commands than listed in this chapter. For information about other commands or more detailed information, the O'Reilly publication Linux in a Nutshell is recommended.
Contents
Abstract
These days many people use computers with a graphical user interface (GUI) like KDE or GNOME. Although they offer lots of features, their use is limited when it comes to the execution of automatical tasks. Shells are a good addition to GUIs and this chapter gives you an overview of some aspects of shells, in this case Bash.
Traditionally, the shell is Bash (Bourne again Shell). When this chapter speaks about “the shell” it means Bash. There are actually more available shells than Bash (ash, csh, ksh, zsh, …), each employing different features and characteristics. If you need further information about other shells, search for shell in YaST.
A shell can be invoked as an:
interactive login shell. This is used when logging in to a machine,
invoking Bash with the --login option or when logging
in to a remote machine with SSH.
“ordinary” interactive shell. This is normally the case when starting xterm, konsole, gnome-terminal or similar tools.
non-interactive shell. This is used when invoking a shell script at the commandline.
Depending on which type of shell you use, different configuration files are being read. The following tables show the login and non-login shell configuration files.
Table 18.1. Bash Configuration Files for Login Shells¶
|
File |
Description |
|---|---|
|
|
Do not modify this file, otherwise your modifications can be destroyed during your next update! |
|
|
Use this file if you extend |
|
|
Contains system-wide configuration files for specific programs |
|
|
Insert user specific configuration for login shells here |
Table 18.2. Bash Configuration Files for Non-Login Shells¶
|
|
Do not modify this file, otherwise your modifications can be destroyed during your next update! |
|
|
Use this file to insert your system-wide modifications for Bash only |
|
|
Insert user specific configuration here |
Additionally, Bash uses some more files:
Table 18.3. Special Files for Bash
|
File |
Description |
|---|---|
|
|
Contains a list of all commands you have been typing |
|
|
Executed when logging out |
The following table provides a short overview of the most important higher-level directories that you find on a Linux system. Find more detailed information about the directories and important subdirectories in the following list.
Table 18.4. Overview of a Standard Directory Tree
|
Directory |
Contents |
|---|---|
|
Root directory—the starting point of the directory tree. | |
|
Essential binary files, such as commands that are needed by both the system administrator and normal users. Usually also contains the shells, such as Bash. | |
|
Static files of the boot loader. | |
|
Files needed to access host-specific devices. | |
|
Host-specific system configuration files. | |
|
Holds the home directories of all users who have accounts on the
system. However, | |
|
Essential shared libraries and kernel modules. | |
|
Mount points for removable media. | |
|
Mount point for temporarily mounting a file system. | |
|
Add-on application software packages. | |
|
Home directory for the superuser | |
|
Essential system binaries. | |
|
Data for services provided by the system. | |
|
Temporary files. | |
|
Secondary hierarchy with read-only data. | |
|
Variable data such as log files. | |
|
Only available if you have both Microsoft Windows* and Linux installed on your system. Contains the Windows data. |
The following list provides more detailed information and gives some examples of which files and subdirectories can be found in the directories:
/bin
Contains the basic shell commands that may be used both by root
and by other users. These commands include ls,
mkdir, cp, mv,
rm and rmdir.
/bin also contains Bash, the default shell in
openSUSE.
/boot
Contains data required for booting, such as the boot loader, the kernel, and other data that is used before the kernel begins executing user-mode programs.
/dev
Holds device files that represent hardware components.
/etc
Contains local configuration files that control the operation of
programs like the X Window System. The /etc/init.d
subdirectory contains scripts that are executed during the boot
process.
/home/username
Holds the private data of every user who has an account on the system.
The files located here can only be modified by their owner or by the
system administrator. By default, your e-mail directory and personal
desktop configuration are located here in the form of hidden files and
directories. KDE users find the personal configuration data for their
desktop in .kde4 and GNOME users find it in
.gconf.
![]() | Home Directory in a Network Environment |
|---|---|
If you are working in a network environment, your home directory may
be mapped to a directory in the file system other than
| |
/lib
Contains the essential shared libraries needed to boot the system and to run the commands in the root file system. The Windows equivalent for shared libraries are DLL files.
/media
Contains mount points for removable media, such as CD-ROMs, USB sticks
and digital cameras (if they use USB). /media
generally holds any type of drive except the hard drive of your system.
As soon as your removable medium has been inserted or connected to the
system and has been mounted, you can access it from here.
/mnt
This directory provides a mount point for a temporarily mounted file
system. root may mount file systems here.
/opt
Reserved for the installation of third-party software. Optional software and larger add-on program packages can be found here.
/root
Home directory for the root user. The personal data of root
is located here.
/sbin
As the s indicates, this directory holds utilities
for the superuser. /sbin contains the binaries
essential for booting, restoring and recovering the system in addition
to the binaries in /bin.
/srv
Holds data for services provided by the system, such as FTP and HTTP.
/tmp
This directory is used by programs that require temporary storage of files.
![]() | Cleaning up /tmp at Boot Time |
|---|---|
Data stored in | |
/usr
/usr has nothing to do with users, but is the
acronym for UNIX system resources. The data in
/usr is static, read-only data that can be shared
among various hosts compliant with the Filesystem Hierarchy Standard
(FHS). This directory contains all application programs and establishes
a secondary hierarchy in the file system. KDE4 and GNOME are also
located here. /usr holds a number of
subdirectories, such as /usr/bin,
/usr/sbin, /usr/local, and
/usr/share/doc.
/usr/bin
Contains generally accessible programs.
/usr/sbin
Contains programs reserved for the system administrator, such as repair functions.
/usr/local
In this directory the system administrator can install local, distribution-independent extensions.
/usr/share/doc
Holds various documentation files and the release notes for your
system. In the manual subdirectory find an online
version of this manual. If more than one language is installed, this
directory may contain versions of the manuals for different languages.
Under packages find the documentation included in
the software packages installed on your system. For every package, a
subdirectory
/usr/share/doc/packages/
is created that often holds README files for the package and sometimes
examples, configuration files or additional scripts.
packagename
If HOWTOs are installed on your system
/usr/share/doc also holds the
howto subdirectory in which to find additional
documentation on many tasks related to the setup and operation of Linux
software.
/var
Whereas /usr holds static, read-only data,
/var is for data which is written during system
operation and thus is variable data, such as log files or spooling
data. For an overview of the most important log files you can find
under /var/log/, refer to
Table A.2, “Log Files”.
/windows
Only available if you have both Microsoft Windows and Linux installed on your system. Contains the Windows data available on the Windows partition of your system. Whether you can edit the data in this directory depends on the file system your Windows partition uses. If it is FAT32, you can open and edit the files in this directory. For NTFS, openSUSE also includes write access support. However, the driver for the NTFS-3g file system has limited functionality. Learn more in Section “Accessing Files on Different OS on the Same Computer” (Chapter 23, Copying and Sharing Files, ↑Reference).
Shell scripts are a convenient way of doing all sorts of tasks: collecting data, searching for a word or phrase in a text and many other useful things. The following example shows a small shell script that prints a text:
Example 18.1. A Shell Script Printing a Text
#!/bin/sh# Output the following line:
echo "Hello World"
Before you can run this script you need some prerequisites:
Every script should contain a Shebang line (this is already the case with our example above.) If a script does not have this line, you have to call the interpreter manually.
You can save the script wherever you want. However, it is a good idea
to save it in a directory where the shell can find it. The search path
in a shell is determined by the environment variable
PATH. Usually a normal user does not have write access
to /usr/bin. Therefore it is recommended to save
your scripts in the users' directory ~/bin/. The
above example gets the name hello.sh.
The script needs executable permissions. Set the permissions with the following command:
chmod +x ~/bin/hello.sh
If you have fullfilled all of the above prerequisites, you can execute the script in the following ways:
As Absolute Path. The script can be executed with an absolute path. In our case, it is ~/bin/hello.sh.
Everywhere.
If the PATH environment variable contains the directory
where the script is located, you can execute the script just with
hello.sh.
Each command can use three channels, either for input or output:
Standard Output. This is the default output channel. Whenever a command prints something, it uses the standard output channel.
Standard Input. If a command needs input from users or other commands, it uses this channel.
Standard Error. Commands use this channel for error reporting.
To redirect these channels, there are the following possibilities:
Command > File
Saves the output of the command into a file, an existing file will be
deleted. For example, the ls command writes its
output into the file listing.txt:
ls > listing.txt
Command >> File
Appends the output of the command to a file. For example, the
ls command appends its output to the file
listing.txt:
ls >> listing.txt
Command < File
Reads the file as input for the given command. For example, the read command reads in the content of the file into the variable:
read a < foo
Command1 | Command2
Redirects the output of the left command as input for the right
command. For example, the cat command outputs the
content of the /proc/cpuinfo file. This output is
used by grep to filter only those lines which
contain cpu:
cat /proc/cpuinfo | grep cpu
Every channel has a file descriptor: 0 (zero) for
standard input, 1 for standard output and 2 for standard error. It is
allowed to insert this file descriptor before a <
or > character. For example, the following line
searches for a file starting with foo, but
suppresses its errors by redirecting it to
/dev/null:
find / -name "foo*" 2>/dev/null
An alias is a shortcut definition of one or more commands. The syntax for an alias is:
aliasNAME=DEFINITION
For example, the following line defines an alias lt
which outputs a long listing (option -l), sorts it by
modification time (-t) and prints it in reverse order
while sorting (-r):
alias lt='ls -ltr'
To view all alias definitions, use alias. Remove your alias with unalias and the corresponding alias name.
A shell variable can be global or local. Global variables, or environment variables, can be accessed in all shells. In contrast, local variables are visible in the current shell only.
To view all environment variables, use the printenv command. If you need to know the value of a variable, insert the name of your variable as an argument:
printenv PATH
A variable, be it global or local, can also be viewed with echo:
echo $PATH
To set a local variable, use a variable name followed by the equal sign, followed by the value:
PROJECT="SLED"
Do not insert spaces around the equal sign, otherwise you get an error. To set an environment variable, use export:
export NAME="tux"
To remove a variable, use unset:
unset NAME
The following table contains some common environment variables which can be used in you shell scripts:
Table 18.5. Useful Environment Variables¶
|
|
the home directory of the current user |
|
|
the current host name |
|
|
when a tool is localized, it uses the language from this environment
variable. English can also be set to |
|
|
the search path of the shell, a list of directories separated by colon |
|
|
specifies the normal prompt printed before each command |
|
|
specifies the secondary prompt printed when you execute a multi-line command |
|
|
current working directory |
|
|
the current user |
For example, if you have the script foo.sh you can execute it like this:
foo.sh "Tux Penguin" 2000
To access all the arguments which are passed to your script, you need
positional parameters. These are $1 for the first
argument, $2 for the second, and so on. You can have up
to nine parameters. To get the script name, use $0.
The following script foo.sh prints all arguments from 1 to 4:
#!/bin/sh echo \"$1\" \"$2\" \"$3\" \"$4\"
If you execute this script with the above arguments, you get:
"Tux Penguin" "2000" "" ""
Variable substitutions apply a pattern to the content of a variable either from the left or right side. The following list contains the possible syntax forms:
${VAR#pattern}
removes the shortest possible match from the left:
file=/home/tux/book/book.tar.bz2
echo ${file#*/}
home/tux/book/book.tar.bz2${VAR##pattern}
removes the longest possible match from the left:
file=/home/tux/book/book.tar.bz2
echo ${file##*/}
book.tar.bz2${VAR%pattern}
removes the shortest possible match from the right:
file=/home/tux/book/book.tar.bz2
echo ${file%.*}
/home/tux/book/book.tar${VAR%%pattern}
removes the longest possible match from the right:
file=/home/tux/book/book.tar.bz2
echo ${file%%.*}
/home/tux/book/book${VAR/pattern_1/pattern_2}
substitutes the content of VAR from the
pattern_1 with
pattern_2:
file=/home/tux/book/book.tar.bz2
echo ${file/tux/wilber}
/home/wilber/book/book.tar.bz2Shells allow you to concatenate and group commands for conditional execution. Each command returns an exit code which determines the success or failure of its operation. If it is 0 (zero) the command was successful, everything else marks an error which is specific to the command.
The following list shows, how commands can be grouped:
Command1 ; Command2
executes the commands in sequential order. The exit code is not checked. The following line displays the content of the file with cat and then prints its file properties with ls regardless of their exit codes:
cat filelist.txt ; ls -l filelist.txt
Command1 && Command2
runs the right command, if the left command was successful (logical AND). The following line displays the content of the file and prints its file properties only, when the previous command was successful (compare it with the previous entry in this list):
cat filelist.txt && ls -l filelist.txt
Command1 || Command2
runs the right command, when the left command has failed (logical OR).
The following line creates only a directory in
/home/wilber/bar when the creation of the
directory in /home/tux/foo has failed:
mkdir /home/tux/foo || mkdir /home/wilber/bar
funcname(){ ... }
creates a shell function. You can use the positional parameters to
access its arguments. The following line defines the function
hello to print a short message:
hello() { echo "Hello $1"; }You can call this function like this:
hello Tux
which prints:
Hello Tux
To control the flow of your script, a shell has while, if, for and case constructs.
The if command is used to check expressions. For example, the following code tests whether the current user is Tux:
if test $USER = "tux"; then echo "Hello Tux." else echo "You are not Tux." fi
The test expression can be as complex or simple as possible. The
following expression checks if the file foo.txt
exists:
if test -e /tmp/foo.txt ; then echo "Found foo.txt" fi
The test expression can also be abbreviated in angled brackets:
if [ -e /tmp/foo.txt ] ; then echo "Found foo.txt" fi
Find more useful expressions at http://www.cyberciti.biz/nixcraft/linux/docs/uniqlinuxfeatures/lsst/ch03sec02.html.
The for loop allows you to execute commands to a list of entries. For example, the following code prints some information about PNG files in the current directory:
for i in *.png; do ls -l $i done
Important information about Bash is provided in the man pages man bash. More about this topic can be found in the following list:
http://tldp.org/LDP/Bash-Beginners-Guide/html/index.html—Bash Guide for Beginners
http://tldp.org/HOWTO/Bash-Prog-Intro-HOWTO.html—BASH Programming - Introduction HOW-TO
http://tldp.org/LDP/abs/html/index.html—Advanced Bash-Scripting Guide
http://www.grymoire.com/Unix/Sh.html—Sh - the Bourne Shell
Contents
openSUSE® comes with various sources of information and documentation, many of which are already integrated into your installed system.
/usr/share/doc
This traditional help directory holds various documentation files and
release notes for your system. It contains also information of
installed packages in the subdirectory packages.
Find more detailed information in
Section A.1.1, “Documentation Directory”.
When working with the shell, you do not need to know the options of the commands by heart. Traditionally, the shell provides integrated help by means of man pages and info pages. Read more in Section A.1.2, “Man Pages” and Section A.1.3, “Info Pages”.
The help centers of both the KDE desktop (KDE help center) and the GNOME desktop (Help) provide central access to the most important documentation resources on your system in searchable form. These resources include online help for installed applications, man pages, info pages, and the Novell/SUSE manuals delivered with your product.
When installing new software with YaST, the software documentation is installed automatically (in most cases) and usually appears in the help center of your desktop. However, some applications, such as GIMP, may have different online help packages that can be installed separately with YaST and do not integrate into the help centers.
The traditional directory to find documentation on your
installed Linux system is /usr/share/doc. Usually,
the directory contains information about the packages installed on your
system, plus release notes, manuals, and more.
![]() | Contents Depends on Installed Packages |
|---|---|
In the Linux world, many manuals and other kinds of documentation are
available in the form of packages, just like software. How much and
which information you find in | |
We provide HTML and PDF versions of our books in different
languages. In the manual subdirectory, find HTML
versions of most of the Novell/SUSE manuals available for your
product. For an overview of all documentation available for your product
refer to the preface of the manuals.
If more than one language is installed,
/usr/share/doc/manual may contain different
language versions of the manuals. The HTML versions of the Novell/SUSE
manuals are also available in the help center of both desktops. For
information on where to find the PDF and HTML versions of the books on
your installation media, refer to the openSUSE Release Notes. They
are available on your installed system under
/usr/share/doc/release-notes/ or online at your
product-specific Web page at
http://www.suse.com/documentation/.
If the howto
package is installed on your system, /usr/share/doc
also holds the howto subdirectory, where you find
additional documentation for many tasks relating to the setup and
operation of Linux software.
Under packages, find the documentation
that is included in the software packages installed on your system. For
every package, a subdirectory
/usr/share/doc/packages/
is created. It often contains README files for the package and sometimes
examples, configuration files, or additional scripts. The following list
introduces typical files to be found under
packagename/usr/share/doc/packages. None of these entries are
mandatory and many packages might just include a few of them.
AUTHORS
List of the main developers.
BUGS
Known bugs or malfunctions. Might also contain a link to a Bugzilla Web page where you can search all bugs.
CHANGES
, ChangeLog
Summary of changes from version to version. Usually interesting for developers, because it is very detailed.
COPYING
, LICENSE
Licensing information.
FAQ
Question and answers collected from mailing lists or newsgroups.
INSTALL
How to install this package on your system. As the package is already installed by the time you get to read this file, you can safely ignore the contents of this file.
README, README.*
General information on the software. For example, for what purpose and how to use it.
TODO
Things that are not implemented yet, but probably will be in the future.
MANIFEST
List of files with a brief summary.
NEWS
Description of what is new in this version.
Man pages are an essential part of any Linux system. They explain the usage of a command and all available options and parameters. Man pages can be accessed with man followed by the name of the command, for example, man ls.
Man pages are displayed directly in the shell. To navigate them, move up and down with Page ↑ and Page ↓. Move between the beginning and the end of a document with Home and End. End this viewing mode by pressing Q. Learn more about the man command itself with man man. Man pages are sorted in categories as shown in Table A.1, “Man Pages—Categories and Descriptions” (taken from the man page for man itself).
Table A.1. Man Pages—Categories and Descriptions¶
|
Number |
Description |
|---|---|
|
1 |
Executable programs or shell commands |
|
2 |
System calls (functions provided by the Kernel) |
|
3 |
Library calls (functions within program libraries) |
|
4 |
Special files (usually found in |
|
5 |
File formats and conventions ( |
|
6 |
Games |
|
7 |
Miscellaneous (including macro packages and conventions), for example, man(7), groff(7) |
|
8 |
System administration commands (usually only for |
|
9 |
Kernel routines (nonstandard) |
Each man page consists of several parts labeled NAME , SYNOPSIS , DESCRIPTION , SEE ALSO , LICENSING , and AUTHOR . There may be additional sections available depending on the type of command.
Info pages are another important source of information on your system. Usually, they are more detailed than man pages. To view the info page for a certain command, enter info followed by the name of the command, for example, info ls. You can browse an info page with a viewer directly in the shell and display the different sections, called “nodes”. Use Space to move forward and <— to move backwards. Within a node, you can also browse with Page ↑ and Page ↓ but only Space and <— will take you also to the previous or subsequent node. Press Q to end the viewing mode. Not every man page comes with an info page and vice versa.
In addition to the online versions of the
openSUSE
manuals installed under /usr/share/doc, you can also
access the product-specific manuals and documentation on the Web. For an
overview of all documentation available for openSUSE check out your
product-specific documentation Web page at
http://doc.opensuse.org.
If you are searching for additional product-related information, you can also refer to the following Web sites:
Detailed information about lots of different aspects of the openSUSE system can be found in our Wiki at http://en.opensuse.org. You may also contribute to each Wiki page and change or add new pages.
The openSUSE Support Database (SDB) can be found at http://en.opensuse.org/Portal:Support_database. It features articles written as solutions for technical problems with openSUSE. They cover issues from installation and configuration, to workarounds for bugs and missing features.
There are several openSUSE forums where you can dive in on discussions about openSUSE, or get support. See http://en.opensuse.org/openSUSE:Forums_list for a list.
Find documentation for many aspects of KDE suitable for users and administrators at http://www.kde.org/documentation/.
Documentation for GNOME users, administrators and developers is available at http://library.gnome.org/.
The Linux Documentation Project (TLDP) is run by a team of volunteers who write Linux-related documentation (see http://www.tldp.org). It's probably the most comprehensive documentation resource for Linux. The set of documents contains tutorials for beginners, but is mainly focused on experienced users and professional system administrators. TLDP publishes HOWTOs, FAQs, and guides (handbooks) under a free license. Parts of the documentation from TLDP is also available on openSUSE
You may also want to try general-purpose search engines. For example, use
search terms Linux CD-RW help or OpenOffice
file conversion problem if you have trouble with burning CDs or
LibreOffice file conversion. Google™ also has a Linux-specific search
engine at http://www.google.com/linux that you might find
useful.
This chapter describes a range of potential problems and their solutions. Even if your situation is not precisely listed here, there may be one Even if your situation is not precisely listed here, there may be one similar enough to offer hints to the solution of your problem.
Linux reports things in a very detailed way. There are several places to look when you encounter problems with your system, most of which are standard to Linux systems in general, and some of which are relevant to openSUSE systems. Most log files can be viewed with YaST (+).
A list of the most frequently checked log files follows with the
description of their typical purpose. Paths containing
~ refer to the current user's home directory.
Table A.2. Log Files¶
|
Log File |
Description |
|---|---|
|
|
Messages from the desktop applications currently running. |
|
|
Log files from AppArmor, see Part “Confining Privileges with AppArmor” (↑Security Guide) for detailed information. |
|
|
Messages from the kernel reported during the boot process. |
|
|
Messages from the mail system. |
|
|
Ongoing messages from the kernel and system log daemon (when running). |
|
|
Log file from NetworkManager to collect problems with network connectivity |
|
|
Directory containing Samba server and client log messages. |
|
|
Hardware messages from the SaX display and KVM system. |
|
|
All messages from the kernel and system log daemon with the “warning” level or higher. |
|
|
Binary file containing user login records for the current machine session. View it with last. |
|
|
Various start-up and runtime logs from the X Window system. It is useful for debugging failed X start-ups. |
|
|
Directory containing YaST's actions and their results. |
|
|
Log file of zypper. |
Apart from log files, your machine also supplies you with information
about the running system. See
Table A.3: System Information With the /proc File System
Table A.3. System Information With the /proc File System¶
|
File |
Description |
|---|---|
|
|
Contains processor information, including its type, make, model, and performance. |
|
|
Shows which DMA channels are currently being used. |
|
|
Shows which interrupts are in use, and how many of each have been in use. |
|
|
Displays the status of I/O (input/output) memory. |
|
|
Shows which I/O ports are in use at the moment. |
|
|
Displays memory status. |
|
|
Displays the individual modules. |
|
|
Displays devices currently mounted. |
|
|
Shows the partitioning of all hard disks. |
|
|
Displays the current version of Linux. |
Apart from the /proc file system, the Linux kernel
exports information with the sysfs module, an
in-memory filesystem. This module represents kernel objects, their
attributes and relationships. For more information about
sysfs, see the context of udev in
Chapter 8, Dynamic Kernel Device Management with udev (↑Reference).
Table A.4
contains an overview of the most common directories under
/sys.
Table A.4. System Information With the /sys File System¶
|
File |
Description |
|---|---|
|
|
Contains subdirectories for each block device discovered in the system. Generally, these are mostly disk type devices. |
|
|
Contains subdirectories for each physical bus type. |
|
|
Contains subdirectories grouped together as a functional types of devices (like graphics, net, printer, etc.) |
|
|
Contains the global device hierarchy. |
Linux comes with a number of tools for system analysis and monitoring. See Chapter 2, System Monitoring Utilities (↑System Analysis and Tuning Guide) for a selection of the most important ones used in system diagnostics.
Each of the following scenarios begins with a header describing the problem followed by a paragraph or two offering suggested solutions, available references for more detailed solutions, and cross-references to other scenarios that are related.
Installation problems are situations when a machine fails to install. It may fail entirely or it may not be able to start the graphical installer. This section highlights some of the typical problems you may run into, and offers possible solutions or workarounds for these kinds of situations.
If you encounter any problems using the openSUSE installation media, check the integrity of your installation media. Boot from the media and choose from the boot menu. In a running system, start YaST and choose +. Media problems are more probable with the media you burn yourself. Burning the media at a low speed (4x) helps avoiding problems.
Display detected hardware and technical data using +. Click any node of the tree for more information about a device. This module is especially useful, when submitting a support request for which you need information about your hardware.
Save the displayed hardware information to a file by clicking . Select the desired directory and filename then click to create the file.
If your computer does not contain a bootable DVD-ROM drive or if the one you have is not supported by Linux, there are several options you can install your machine without a built-in DVD drive:
If it is supported by your BIOS and the installation kernel, boot from external DVD drives or USB storage devices.
If a machine lacks a DVD drive, but provides a working ethernet connection, perform a completely network-based installation. See Section “Remote Installation via VNC—PXE Boot and Wake on LAN” (Chapter 2, Remote Installation, ↑Reference) and Section “Remote Installation via SSH—PXE Boot and Wake on LAN” (Chapter 2, Remote Installation, ↑Reference) for details.
Linux supports most existing DVD drives. If the system has neither a DVD drive nor a floppy disk, it is still possible that an external DVD drive, connected through USB, FireWire, or SCSI, can be used to boot the system. This depends mainly on the interaction of the BIOS and the hardware used. Sometimes a BIOS update may help if you encounter problems.
When installing from a KDE or GNOME Live CD, you can also create a “Live USB stick” to boot from. Refer to http://en.opensuse.org/Live_USB_stick for detailed instructions.
One reason why a machine does not boot the installation media can be an incorrect boot sequence setting in BIOS. The BIOS boot sequence must have DVD drive set as the first entry for booting. Otherwise the machine would try to boot from another medium, typically the hard disk. Guidance for changing the BIOS boot sequence can be found the documentation provided with your motherboard, or in the following paragraphs.
The BIOS is the software that enables the very basic functions of a computer. Motherboard vendors provide a BIOS specifically made for their hardware. Normally, the BIOS setup can only be accessed at a specific time—when the machine is booting. During this initialization phase, the machine performs a number of diagnostic hardware tests. One of them is a memory check, indicated by a memory counter. When the counter appears, look for a line, usually below the counter or somewhere at the bottom, mentioning the key to press to access the BIOS setup. Usually the key to press is one of Del, F1, or Esc. Press this key until the BIOS setup screen appears.
Procedure A.1. Changing the BIOS Boot Sequence¶
Enter the BIOS using the proper key as announced by the boot routines and wait for the BIOS screen to appear.
To change the boot sequence in an AWARD BIOS, look for the entry. Other manufacturers may have a different name for this, such as . When you have found the entry, select it and confirm with Enter.
In the screen that opens, look for a subentry called or . The boot sequence
looks something like C,A or A,C.
In the former case, the machine first searches the hard disk (C) then
the floppy drive (A) to find a bootable medium. Change the settings by
pressing PgUp or PgDown until the
sequence is A,CDROM,C.
Leave the BIOS setup screen by pressing Esc. To save the changes, select , or press F10. To confirm that your settings should be saved, press Y.
Procedure A.2. Changing the Boot Sequence in a SCSI BIOS (Adaptec Host Adapter)
Open the setup by pressing Ctrl+A.
Select . The connected hardware components are now displayed.
Make note of the SCSI ID of your DVD drive.
Exit the menu with Esc.
Open . Under , select and press Enter.
Enter the ID of the DVD drive and press Enter again.
Press Esc twice to return to the start screen of the SCSI BIOS.
Exit this screen and confirm with to boot the computer.
Regardless of what language and keyboard layout your final installation will be using, most BIOS configurations use the US keyboard layout as depicted in the following figure:
Some hardware types, mainly very old or very recent ones, fail to install. In many cases, this may happen because support for this type of hardware is missing in the installation kernel, or due to certain functionality included in this kernel, such as ACPI, that can still cause problems on some hardware.
If your system fails to install using the standard mode from the first installation boot screen, try the following:
With the DVD still in the drive, reboot the machine with Ctrl-Alt-Del or using the hardware reset button.
When the boot screen appears, press F5, use the arrow keys of your keyboard to navigate to and press Enter to launch the boot and installation process. This option disables the support for ACPI power management techniques.
Proceed with the installation as described in Chapter 1, Installation with YaST (↑Reference).
If this fails, proceed as above, but choose instead. This option disables ACPI and DMA support. Most hardware will boot with this option.
If both of these options fail, use the boot options prompt to pass any
additional parameters needed to support this type of hardware to the
installation kernel. For more information about the parameters available
as boot options, refer to the kernel documentation located in
/usr/src/linux/Documentation/kernel-parameters.txt.
![]() | Obtaining Kernel Documentation |
|---|---|
Install the | |
There are various other ACPI-related kernel parameters that can be entered at the boot prompt prior to booting for installation:
acpi=off
This parameter disables the complete ACPI subsystem on your computer. This may be useful if your computer cannot handle ACPI at all or if you think ACPI in your computer causes trouble.
acpi=force
Always enable ACPI even if your computer has an old BIOS dated before
the year 2000. This parameter also enables ACPI if it is set in
addition to acpi=off.
acpi=noirq
Do not use ACPI for IRQ routing.
acpi=ht
Run only enough ACPI to enable hyper-threading.
acpi=strict
Be less tolerant of platforms that are not strictly ACPI specification compliant.
pci=noacpi
Disable PCI IRQ routing of the new ACPI system.
pnpacpi=off
This option is for serial or parallel problems when your BIOS setup contains wrong interrupts or ports.
notsc
Disable the time stamp counter. This option can be used to work around timing problems on your systems. It is a recent feature, if you see regressions on your machine, especially time related or even total hangs, this option is worth a try.
nohz=off
Disable the nohz feature. If your machine hangs, this option may help. Otherwise it is of no use.
Once you have determined the right parameter combination, YaST automatically writes them to the boot loader configuration to make sure that the system boots properly next time.
If unexplainable errors occur when the kernel is loaded or during the installation, select in the boot menu to check the memory. If returns an error, it is usually a hardware error.
After you insert the medium into your drive and reboot your machine, the installation screen comes up, but after you select , the graphical installer does not start.
There are several ways to deal with this situation:
Try to select another screen resolution for the installation dialogs.
Select for installation.
Do a remote installation via VNC using the graphical installer.
Procedure A.3. Change Screen Resolution for Installation¶
Boot for installation.
Press F3 to open a menu from which to select a lower resolution for installation purposes.
Select and proceed with the installation as described in Chapter 1, Installation with YaST (↑Reference).
Procedure A.4. Installation in Text Mode¶
Boot for installation.
Press F3 and select .
Select and proceed with the installation as described in Chapter 1, Installation with YaST (↑Reference).
Procedure A.5. VNC Installation¶
Boot for installation.
Enter the following text at the boot options prompt:
vnc=1 vncpassword=some_password
Replace some_password with the password to
use for VNC installation.
Select then press Enter to start the installation .
Instead of starting right into the graphical installation routine, the system continues to run in a text mode, then halts, displaying a message containing the IP address and port number at which the installer can be reached via a browser interface or a VNC viewer application.
If using a browser to access the installer, launch the browser and enter the address information provided by the installation routines on the future openSUSE machine and hit Enter:
http://ip_address_of_machine:5801A dialog opens in the browser window prompting you for the VNC password. Enter it and proceed with the installation as described in Chapter 1, Installation with YaST (↑Reference).
![]() | |
Installation via VNC works with any browser under any operating system, provided Java support is enabled. | |
Provide the IP address and password to your VNC viewer when prompted. A window opens, displaying the installation dialogs. Proceed with the installation as usual.
You inserted the medium into the drive, the BIOS routines are finished, but the system does not start with the graphical boot screen. Instead it launches a very minimalistic text-based interface. This may happen on any machine not providing sufficient graphics memory for rendering a graphical boot screen.
Although the text boot screen looks minimalistic, it provides nearly the same functionality as the graphical one:
Unlike the graphical interface, the different boot options cannot be selected using the cursor keys of your keyboard. The boot menu of the text mode boot screen offers some keywords to enter at the boot prompt. These keywords map to the options offered in the graphical version. Enter your choice and hit Enter to launch the boot process.
After selecting a boot option, enter the appropriate keyword at the boot prompt or enter some custom boot options as described in Section A.2.2.5, “Fails to Boot”. To launch the installation process, press Enter.
Use the F keys to determine the screen resolution for installation. If you need to boot in text mode, choose F3.
Boot problems are situations when your system does not boot properly (does not boot to the expected runlevel and login screen).
If the hardware is functioning properly, it is possible that the boot loader is corrupted and Linux cannot start on the machine. In this case, it is necessary to repair the boot loader. To do so, you need start the Rescue System as described in Section A.2.7, “Recovering a Corrupted System” and follow the instructions at Section A.2.7.1.4, “Modifying and Reinstalling the Boot Loader”.
Other reasons for the machine not booting may be BIOS-related:
Check your BIOS for references to your hard drive. GRUB may simply not be started if the hard drive itself cannot be found with the current BIOS settings.
Check whether your system's boot order includes the hard disk. If the hard disk option was not enabled, your system may install properly, but fails to boot when access to the hard disk is required.
If the machine comes up, but does not boot into the graphical login
manager, anticipate problems either with the choice of the default
runlevel or the configuration of the X Window System. To check the
runlevel configuration, log in as the
root user and check whether
the machine is configured to boot into runlevel 5 (graphical desktop). A
quick way to check this is to examine the contents of
/etc/inittab, as follows:
tux@mercury:~> grep "id:" /etc/inittab id:5:initdefault:
The returned line indicates that the machine's default runlevel
(initdefault) is set to 5 and that
it should boot to the graphical desktop. If the runlevel is set to any
other number, use the YaST Runlevel Editor module to set it to
5.
![]() | |
Do not edit the runlevel configuration manually. Otherwise SuSEconfig
(run by YaST) will overwrite these changes on its next run. If you
need to make manual changes here, disable future SuSEconfig changes by
setting | |
If the runlevel is set to 5, your desktop or X
Windows software is probably misconfigured or corrupted. Examine the log
files at /var/log/Xorg.*.log for detailed messages
from the X server as it attempted to start. If the desktop fails during
start, it may log error messages to
/var/log/messages. If these error messages hint at
a configuration problem in the X server, try to fix these issues. If the
graphical system still does not come up, consider reinstalling the
graphical desktop.
![]() | Starting X Window System Manually |
|---|---|
One quick test: the startx command should force the X Window System to start with the configured defaults if the user is currently logged in on the console. If that does not work, it should log errors to the console. | |
Login problems are those where your machine does, in fact, boot to the expected welcome screen or login prompt, but refuses to accept the username and password, or accepts them but then does not behave properly (fails to start the graphic desktop, produces errors, drops to a command line, etc.).
This usually occurs when the system is configured to use network
authentication or directory services and, for some reason, is unable to
retrieve results from its configured servers. The
root user, as the only local
user, is the only user that can still log in to these machines. The
following are some common reasons why a machine appears functional but
is unable to process logins correctly:
The network is not working. For further directions on this, turn to Section A.2.5, “Network Problems”.
DNS is not working at the moment (which prevents GNOME or KDE from working and the system from making validated requests to secure servers). One indication that this is the case is that the machine takes an extremely long time to respond to any action. Find more information about this topic in Section A.2.5, “Network Problems”.
If the system is configured to use Kerberos, the system's local time may have drifted past the accepted variance with the Kerberos server time (this is typically 300 seconds). If NTP (network time protocol) is not working properly or local NTP servers are not working, Kerberos authentication ceases to function because it depends on common clock synchronization across the network.
The system's authentication configuration is misconfigured. Check the PAM configuration files involved for any typographical errors or misordering of directives. For additional background information about PAM and the syntax of the configuration files involved, refer to Chapter 2, Authentication with PAM (↑Security Guide).
The home partition is encrypted. Find more information about this topic in Section A.2.4.3, “Login to Encrypted Home Partition Fails”.
In all cases that do not involve external network problems, the solution is to reboot the system into single-user mode and repair the configuration before booting again into operating mode and attempting to log in again. To boot into single-user mode:
This is by far the most common problem users encounter, because there are many reasons this can occur. Depending on whether you use local user management and authentication or network authentication, login failures occur for different reasons.
Local user management can fail for the following reasons:
The user may have entered the wrong password.
The user's home directory containing the desktop configuration files is corrupted or write protected.
There may be problems with the X Window System authenticating this particular user, especially if the user's home directory has been used with another Linux distribution prior to installing the current one.
To locate the reason for a local login failure, proceed as follows:
Check whether the user remembered his password correctly before you start debugging the whole authentication mechanism. If the user may not remember his password correctly, use the YaST User Management module to change the user's password. Pay attention to the Caps Lock key and unlock it, if necessary.
Log in as root and check
/var/log/messages for error messages of the login
process and of PAM.
Try to log in from a console (using Ctrl+Alt+F1). If this is successful, the blame cannot be put on PAM, because it is possible to authenticate this user on this machine. Try to locate any problems with the X Window System or the desktop (GNOME or KDE). For more information, refer to Section A.2.4.4, “Login Successful but GNOME Desktop Fails” and Section A.2.4.5, “Login Successful but KDE Desktop Fails”.
If the user's home directory has been used with another Linux
distribution, remove the Xauthority file in the
user's home. Use a console login via Ctrl+Alt+F1
and run rm .Xauthority as this user. This should
eliminate X authentication problems for this user. Try graphical login
again.
If graphical login still fails, do a console login with Ctrl+Alt+F1.
Try to start an X session on another display—the first one
(:0) is already in use:
startx -- :1
This should bring up a graphical screen and your desktop. If it does
not, check the log files of the X Window System
(/var/log/Xorg.)
or the log file for your desktop applications
(displaynumber.log.xsession-errors in the user's home directory)
for any irregularities.
If the desktop could not start because of corrupt configuration files, proceed with Section A.2.4.4, “Login Successful but GNOME Desktop Fails” or Section A.2.4.5, “Login Successful but KDE Desktop Fails”.
The following are some common reasons why network authentication for a particular user may fail on a specific machine:
The user may have entered the wrong password.
The username exists in the machine's local authentication files and is also provided by a network authentication system, causing conflicts.
The home directory exists but is corrupt or unavailable. Perhaps it is write protected or is on a server that is inaccessible at the moment.
The user does not have permission to log in to that particular host in the authentication system.
The machine has changed hostnames, for whatever reason, and the user does not have permission to log in to that host.
The machine cannot reach the authentication server or directory server that contains that user's information.
There may be problems with the X Window System authenticating this particular user, especially if the user's home has been used with another Linux distribution prior to installing the current one.
To locate the cause of the login failures with network authentication, proceed as follows:
Check whether the user remembered their password correctly before you start debugging the whole authentication mechanism.
Determine the directory server which the machine relies on for authentication and make sure that it is up and running and properly communicating with the other machines.
Determine that the user's username and password work on other machines to make sure that his authentication data exists and is properly distributed.
See if another user can log in to the misbehaving machine. If another
user can log in without difficulty or if
root can log in, log in and
examine the /var/log/messages file. Locate the
time stamps that correspond to the login attempts and determine if PAM
has produced any error messages.
Try to log in from a console (using Ctrl+Alt+F1). If this is successful, the problem is not with PAM or the directory server on which the user's home is hosted, because it is possible to authenticate this user on this machine. Try to locate any problems with the X Window System or the desktop (GNOME or KDE). For more information, refer to Section A.2.4.4, “Login Successful but GNOME Desktop Fails” and Section A.2.4.5, “Login Successful but KDE Desktop Fails”.
If the user's home directory has been used with another Linux
distribution, remove the Xauthority file in the
user's home. Use a console login via Ctrl+Alt+F1
and run rm .Xauthority as this user. This should
eliminate X authentication problems for this user. Try graphical login
again.
If graphical login still fails, do a console login with Ctrl+Alt+F1.
Try to start an X session on another display—the first one
(:0) is already in use:
startx -- :1
This should bring up a graphical screen and your desktop. If it does
not, check the log files of the X Window System
(/var/log/Xorg.)
or the log file for your desktop applications
(displaynumber.log.xsession-errors in the user's home directory)
for any irregularities.
If the desktop could not start because of corrupt configuration files, proceed with Section A.2.4.4, “Login Successful but GNOME Desktop Fails” or Section A.2.4.5, “Login Successful but KDE Desktop Fails”.
It is recommended to use an encrypted home partition for laptops. If you cannot log in to your laptop, the reason is usually simple: your partition could not be unlocked.
During the boot time, you have to enter the passphrase to unlock your encrypted partition. If you do not enter it, the boot process continues, leaving the partition locked.
To unlock your encrypted partition, proceed as follows:
Switch to the text console with Ctrl+Alt+F1.
Become root.
Restart the unlocking process again with:
/etc/init.d/boot.crypto restart
Enter your passphrase to unlock your encrypted partition.
Exit the text console and switch back to the login screen with Alt+F7.
Log in as usual.
If this is the case, it is likely that your GNOME configuration files have become corrupted. Some symptoms may include the keyboard failing to work, the screen geometry becoming distorted, or even the screen coming up as a bare gray field. The important distinction is that if another user logs in, the machine works normally. It is then likely that the problem can be fixed relatively quickly by simply moving the user's GNOME configuration directory to a new location, which causes GNOME to initialize a new one. Although the user is forced to reconfigure GNOME, no data is lost.
Switch to a text console by pressing Ctrl+Alt+F1.
Log in with your user name.
Move the user's GNOME configuration directories to a temporary location:
mv .gconf .gconf-ORIG-RECOVER mv .gnome2 .gnome2-ORIG-RECOVER
Log out.
Log in again, but do not run any applications.
Recover your individual application configuration data (including the
Evolution e-mail client data) by copying the
~/.gconf-ORIG-RECOVER/apps/ directory back into
the new ~/.gconf directory as follows:
cp -a .gconf-ORIG-RECOVER/apps .gconf/
If this causes the login problems, attempt to recover only the critical application data and reconfigure the remainder of the applications.
There are several reasons why a KDE desktop would not allow users to login. Corrupted cache data can cause login problems as well as corrupt KDE desktop configuration files.
Cache data is used at desktop start-up to increase performance. If this data is corrupted, start-up is slowed down or fails entirely. Removing them forces the desktop start-up routines to start from scratch. This takes more time than a normal start-up, but data is intact after this and the user can login.
To remove the cache files of the KDE desktop, issue the following
command as root:
rm -rf /tmp/kde-user/tmp/ksocket-user
Replace user with your username. Removing
these two directories just removes the corrupted cache files. No real
data is harmed using this procedure.
Corrupted desktop configuration files can always be replaced with the initial configuration files. If you want to recover the user's adjustments, carefully copy them back from their temporary location after the configuration has been restored, using the default configuration values.
To replace a corrupted desktop configuration with the initial configuration values, proceed as follows:
Switch to a text console by pressing Ctrl+Alt+F1.
Log in with your username.
Move the KDE configuration directory and the
.skel files to a temporary location:
For KDE3 use these commands:
mv .kde .kde-ORIG-RECOVER
mv .skel .skel-ORIG-RECOVERFor KDE4 use these commands:
mv .kde4 .kde4-ORIG-RECOVER
mv .skel .skel-ORIG-RECOVERLog out.
Log in again.
After the desktop has started successfully, copy the user's own configurations back into place:
cp -a KDEDIR/share .kde/share
Replace KDEDIR with the directory from
Step 3.
![]() | |
If the user's own adjustments caused the login to fail and continue
to do so, repeat the procedure as described above, but do not copy
the | |
Many problems of your system may be network-related, even though they do not seem to be at first. For example, the reason for a system not allowing users to log in may be a network problem of some kind. This section introduces a simple check list you can apply to identify the cause of any network problem encountered.
Procedure A.6. How to Identify Network Problems¶
When checking the network connection of your machine, proceed as follows:
If you use an ethernet connection, check the hardware first. Make sure that your network cable is properly plugged into your computer and router (or hub, etc.). The control lights next to your ethernet connector are normally both be active.
If the connection fails, check whether your network cable works with another machine. If it does, your network card causes the failure. If hubs or switches are included in your network setup, they may be faulty, as well.
If using a wireless connection, check whether the wireless link can be established by other machines. If not, contact the wireless network's administrator.
Once you have checked your basic network connectivity, try to find out which service is not responding. Gather the address information of all network servers needed in your setup. Either look them up in the appropriate YaST module or ask your system administrator. The following list gives some of the typical network servers involved in a setup together with the symptoms of an outage.
A broken or malfunctioning name service affects the network's functionality in many ways. If the local machine relies on any network servers for authentication and these servers cannot be found due to name resolution issues, users would not even be able to log in. Machines in the network managed by a broken name server would not be able to “see” each other and communicate.
A malfunctioning or completely broken NTP service could affect Kerberos authentication and X server functionality.
If any application needs data stored in an NFS mounted directory, it
will not be able to start or function properly if this service was
down or misconfigured. In the worst case scenario, a user's personal
desktop configuration would not come up if their home directory
containing the .gconf or
.kde subdirectories could not be found due to a
faulty NFS server.
If any application needs data stored in a directory on a faulty Samba server, it will not be able to start or function properly.
If your openSUSE system relies on a faulty NIS server to provide the user data, users will not be able to log in to this machine.
If your openSUSE system relies on a faulty LDAP server to provide the user data, users will not be able to log in to this machine.
Authentication will not work and login to any machine fails.
Users cannot print.
Check whether the network servers are running and whether your network setup allows you to establish a connection:
![]() | |
The debugging procedure described below only applies to a simple network server/client setup that does not involve any internal routing. It assumes both server and client are members of the same subnet without the need for additional routing. | |
Use ping IP address or
hostname (replace
hostname with the hostname of the server)
to check whether each one of them is up and responding to the
network. If this command is successful, it tells you that the host
you were looking for is up and running and that the name service for
your network is configured correctly.
If ping fails with destination host unreachable,
either your system or the desired server is not properly configured
or down. Check whether your system is reachable by running
ping IP address or
your_hostname from another
machine. If you can reach your machine from another machine, it is
the server that is not running at all or not configured correctly.
If ping fails with unknown host, the name service
is not configured correctly or the hostname used was incorrect. For
further checks on this matter, refer to
Step 4.b.
If ping still fails, either your network card is not configured
correctly or your network hardware is faulty.
Use host hostname to
check whether the hostname of the server you are trying to connect to
is properly translated into an IP address and vice versa. If this
command returns the IP address of this host, the name service is up
and running. If the host command fails, check all
network configuration files relating to name and address resolution
on your host:
/etc/resolv.conf
This file is used to keep track of the name server and domain you are currently using. It can be modified manually or automatically adjusted by YaST or DHCP. Automatic adjustment is preferable. However, make sure that this file has the following structure and all network addresses and domain names are correct:
searchfully_qualified_domain_namenameserveripaddress_of_nameserver
This file can contain more than one name server address, but at least one of them must be correct to provide name resolution to your host. If needed, adjust this file using the YaST Network Setting module (Hostname/DNS tab).
If your network connection is handled via DHCP, enable DHCP to change hostname and name service information by selecting and in the YaST DNS and Hostname module.
/etc/nsswitch.conf
This file tells Linux where to look for name service information. It should look like this:
... hosts: files dns networks: files dns ...
The dns entry is vital. It tells Linux to use an
external name server. Normally, these entries are automatically
managed by YaST, but it would be prudent to check.
If all the relevant entries on the host are correct, let your system administrator check the DNS server configuration for the correct zone information. For detailed information about DNS, refer to Chapter 11, The Domain Name System (↑Reference). If you have made sure that the DNS configuration of your host and the DNS server are correct, proceed with checking the configuration of your network and network device.
If your system cannot establish a connection to a network server and you have excluded name service problems from the list of possible culprits, check the configuration of your network card.
Use the command ifconfig
network_device (executed as
root) to check whether this
device was properly configured. Make sure that both inet
address and Mask are configured correctly.
An error in the IP address or a missing bit in your network mask
would render your network configuration unusable. If necessary,
perform this check on the server as well.
If the name service and network hardware are properly configured and
running, but some external network connections still get long
time-outs or fail entirely, use traceroute
fully_qualified_domain_name
(executed as root) to track
the network route these requests are taking. This command lists any
gateway (hop) that a request from your machine passes on its way to
its destination. It lists the response time of each hop and whether
this hop is reachable at all. Use a combination of traceroute and
ping to track down the culprit and let the administrators know.
Once you have identified the cause of your network trouble, you can resolve it yourself (if the problem is located on your machine) or let the system administrators of your network know about your findings so they can reconfigure the services or repair the necessary systems.
If you have a problem with network connectivity, narrow it down as described in Procedure A.6, “How to Identify Network Problems”. If NetworkManager seems to be the culprit, proceed as follows to get logs providing hints on why NetworkManager fails:
Open a shell and log in as
root.
Restart the NetworkManager:
rcnetwork restart -o nm
Open a web page, for example, http://www.opensuse.org as normal user to see, if you can connect.
Collect any information about the state of NetworkManager in
/var/log/NetworkManager.
For more information about NetworkManager, refer to Chapter 21, Using NetworkManager (↑Reference).
Data problems are when the machine may or may not boot properly but, in either case, it is clear that there is data corruption on the system and that the system needs to be recovered. These situations call for a backup of your critical data, enabling you to recover the system state from before your system failed. openSUSE offers dedicated YaST modules for system backup and restoration as well as a rescue system that can be used to recover a corrupted system from the outside.
Sometimes you need to perform a backup from an entire partition or even hard disk. Linux comes with the dd tool which can create a exact copy of your disc. Combined with gzip you save some space.
Procedure A.7. Backing up and Restoring Harddisks
Start a Shell as user root.
Select your source device. Typically this is something like
/dev/sda (labeled as
SOURCE).
Decide where you want to store your image (labeled as
BACKUP_PATH). It must be different from
your source device. In other words: if you make a backup from
/dev/sda, your image file must not to be stored
under /dev/sda.
Run the commands to create a compressed image file:
dd if=/dev/SOURCE| gzip > /BACKUP_PATH/image.gz
Restore the hard disk with the following commands:
gzip -dc /BACKUP_PATH/image.gz | dd of=/dev/SOURCE
If you only need a partition to backup, replace the
SOURCE placeholder with your respective
partition. In this case, your image file can lie on the same hard disk,
but on a different partition.
System backups can be easily managed using the YaST System Backup module:
As root, start YaST and select +.
Create a backup profile holding all details needed for the backup, filename of the archive file, scope, and type of the backup:
Select +.
Enter a name for the archive.
Enter the path to the location of the backup if you want to keep a local backup. For your backup to be archived on a network server (via NFS), enter the IP address or name of the server and the directory that should hold your archive.
Determine the archive type and click .
Determine the backup options to use, such as whether files not belonging to any package should be backed up and whether a list of files should be displayed prior to creating the archive. Also determine whether changed files should be identified using the time-consuming MD5 mechanism.
Use to enter a dialog for the backup of entire hard disk areas. Currently, this option only applies to the Ext2 file system.
Finally, set the search constraints to exclude certain system areas from the backup area that do not need to be backed up, such as lock files or cache files. Add, edit, or delete items until your needs are met and leave with .
Once you have finished the profile settings, you can start the backup right away with or configure automatic backup. It is also possible to create other profiles tailored for various other purposes.
To configure automatic backup for a given profile, proceed as follows:
Select from the menu.
Select .
Determine the backup frequency. Choose , , or .
Determine the backup start time. These settings depend on the backup frequency selected.
Decide whether to keep old backups and how many should be kept. To receive an automatically generated status message of the backup process, check .
Click to apply your settings and have the first backup start at the time specified.
Use the YaST System Restoration module to restore the system configuration from a backup. Restore the entire backup or select specific components that were corrupted and need to be reset to their old state.
Start ++.
Enter the location of the backup file. This could be a local file, a network mounted file, or a file on a removable device, such as a floppy or a DVD. Then click .
The following dialog displays a summary of the archive properties, such as the filename, date of creation, type of backup, and optional comments.
Review the archived content by clicking . Clicking returns you to the dialog.
opens a dialog in which to fine-tune the restore process. Return to the dialog by clicking .
Click to open the view of packages to restore. Press to restore all files in the archive or use the various , , and buttons to fine-tune your selection. Only use the option if the RPM database is corrupted or deleted and this file is included in the backup.
After you click , the backup is restored. Click to leave the module after the restore process is completed.
There are several reasons why a system could fail to come up and run properly. A corrupted file system following a system crash, corrupted configuration files, or a corrupted boot loader configuration are the most common ones.
openSUSE contains a rescue system. The rescue system is a small Linux system that can be loaded into a RAM disk and mounted as root file system, allowing you to access your Linux partitions from the outside. Using the rescue system, you can recover or modify any important aspect of your system:
Manipulate any type of configuration file.
Check the file system for defects and start automatic repair processes.
Access the installed system in a “change root” environment.
Check, modify, and reinstall the boot loader configuration.
Recover from a badly installed device driver or unusable kernel.
Resize partitions using the parted command. Find more information about this tool at the GNU Parted website http://www.gnu.org/software/parted/parted.html.
The rescue system can be loaded from various sources and locations. The simplest option is to boot the rescue system from the original installation medium:
Insert the installation medium into your DVD drive.
Reboot the system.
At the boot screen, press F4 and choose . Then choose from the main menu.
Enter root at the Rescue: prompt.
A password is not required.
If your hardware setup does not include a DVD drive, you can boot the
rescue system from a network source (including the
openSUSE FTP server). The following example applies to a
remote boot scenario—if using another boot medium, such as a DVD,
modify the info file accordingly and boot as you
would for a normal installation.
Enter the configuration of your PXE boot setup and add the lines
install=
and protocol://instsourcerescue=1. If you need to start the repair
system, use repair=1 instead. As with a normal
installation, protocol stands for any of the
supported network protocols (NFS, HTTP, FTP, etc.) and
instsource for the path to your network
installation source.
Boot the system using “Wake on LAN”, as described in Section “Wake on LAN” (Chapter 2, Remote Installation, ↑Reference).
Enter root at the Rescue: prompt.
A password is not required.
Once you have entered the rescue system, you can make use of the virtual consoles that can be reached with Alt+F1 to Alt+F6.
A shell and many other useful utilities, such as the mount program, are
available in the /bin directory. The
sbin directory contains important file and network
utilities for reviewing and repairing the file system. This directory
also contains the most important binaries for system maintenance, such as
fdisk, mkfs, mkswap, mount, mount, init, and shutdown, and ifconfig, ip,
route, and netstat for maintaining the network. The directory
/usr/bin contains the vi editor, find, less, and
ssh.
To see the system messages, either use the command
dmesg or view the file
/var/log/messages.
As an example for a configuration that might be fixed using the rescue system, imagine you have a broken configuration file that prevents the system from booting properly. You can fix this using the rescue system.
To manipulate a configuration file, proceed as follows:
Start the rescue system using one of the methods described above.
To mount a root file system located under
/dev/sda6 to the rescue system, use the following
command:
mount /dev/sda6 /mnt
All directories of the system are now located under
/mnt
Change the directory to the mounted root file system:
cd /mnt
Open the problematic configuration file in the vi editor. Adjust and save the configuration.
Unmount the root file system from the rescue system:
umount /mnt
Reboot the machine.
Generally, file systems cannot be repaired on a running system. If you
encounter serious problems, you may not even be able to mount your root
file system and the system boot may end with a “kernel
panic”. In this case, the only way is to repair the system from
the outside. The rescue system provides
all tools needed for a manual file system check or repair. It
contains the utilities to check and repair the btrfs,
ext2, ext3,
ext4, reiserfs,
xfs, dosfs, and
vfat file systems.
If you need to access the installed system from the rescue system, you need to do this in a change root environment. For example, to modify the boot loader configuration, or to execute a hardware configuration utility.
To set up a change root environment based on the installed system, proceed as follows:
First mount the root partition from the installed system and the device file system (change the device name to your current settings):
mount /dev/sda6 /mnt mount --bind /dev /mnt/dev
Now you can “change root” into the new environment:
chroot /mnt
Then mount /proc and /sys:
mount /proc mount /sys
Finally, mount the remaining partitions from the installed system:
mount -a
Now you have access to the installed system. Before rebooting the
system, unmount the partitions with umount
-a and leave the “change root”
environment with exit.
![]() | Limitations |
|---|---|
Although you have full access to the files and applications of the
installed system, there are some limitations. The kernel that is
running is the one that was booted with the rescue system, not with the
change root environment. It only supports essential hardware and it is
not possible to add kernel modules from the installed system unless the
kernel versions are exactly the same. Always check the version of the
currently running (rescue) kernel with uname -r and
then find out if a matching subdirectory exists in the
Also note that you leave the “change root” environment when you switch the console with Alt+F1 to Alt+F6. | |
Sometimes a system cannot boot because the boot loader configuration is corrupted. The start-up routines cannot, for example, translate physical drives to the actual locations in the Linux file system without a working boot loader.
To check the boot loader configuration and reinstall the boot loader, proceed as follows:
Perform the necessary steps to access the installed system as described in Section A.2.7.1.3, “Accessing the Installed System”.
Check whether the following files are correctly configured according to the GRUB configuration principles outlined in Chapter 6, The Boot Loader GRUB (↑Reference) and apply fixes if necessary.
/etc/grub.conf
/boot/grub/device.map
/boot/grub/menu.lst
/etc/sysconfig/bootloader
Reinstall the boot loader using the following command sequence:
grub --batch < /etc/grub.conf
Unmount the partitions, log out from the “change root” environment, and reboot the system:
umount -a exit reboot
A kernel update may introduce a new bug which can impact the operation of your system. For example a driver for a piece of hardware in your system may be faulty, which prevents you from accessing and using it. In this case, revert to the last working kernel (if available on the system) or install the original kernel from the installation media.
![]() | How to Keep Last Kernels after Update |
|---|---|
To prevent failures to boot after a faulty kernel update, use the
kernel multiversion feature and tell For example to always keep the last two kernels and the currently running one, add multiversion.kernels = latest,latest-1,running
to the | |
A similar case is when you need to reinstall or update a broken driver for a device not supported by openSUSE. For example when a hardware vendor uses a specific device, such as a hardware RAID controller, which needs a binary driver to be recognized by the operating system. The vendor typically releases a Driver Update Disk with the fixed or updated version of the required driver.
In both cases you need to access the installed system in the rescue mode and fix the kernel related problem, otherwise the system may fail to boot correctly:
Boot from the openSUSE installation media.
If you are recovering after a faulty kernel update, skip this step. If you need to use a driver update disk (DUD), press F6 to load the driver update after the boot menu appears, and choose the path or URL to the driver update and confirm with .
Choose from the boot menu and press Enter. If you chose to use DUD, you will be asked to specify where the driver update is stored.
Enter root at the Rescue:
prompt. A password is not required.
Manually mount the target system and “change root” into the new environment. For more information, see Section A.2.7.1.3, “Accessing the Installed System”.
If using DUD, install/reinstall/update the faulty device driver package. Always make sure the installed kernel version exactly matches the version of the driver you are installing.
If fixing faulty kernel update installation, you can install the original kernel from the installation media with the following procedure.
Identify your DVD device with hwinfo --cdrom and mount it with mount /dev/sr0 /mnt.
Navigate to the directory where your kernel files are stored on the DVD, for example cd /mnt/suse/x86_64/.
Install required kernel-*,
kernel-*-base, and
kernel-*-extra packages of your flavor with
the rpm -i command.
After the installation finishes, check that a new menu entry
relevant for the newly installed kernel was added to the boot loader
configuration file (/boot/grub/menu.lst for
grub).
Update configuration files and reinitialize the boot loader if needed. For more information, see Section A.2.7.1.4, “Modifying and Reinstalling the Boot Loader”
Remove any bootable media from the system drive and reboot.
Copyright© 2006– 2011 Novell, Inc. and contributors. All rights reserved.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or (at your option) version 1.3; with the Invariant Section being this copyright notice and license. A copy of the license version 1.2 is included in the section entitled “GNU Free Documentation License”.
For Novell trademarks, see the Novell Trademark and Service Mark list http://www.novell.com/company/legal/trademarks/tmlist.html. Linux* is a registered trademark of Linus Torvalds. All other third party trademarks are the property of their respective owners. A trademark symbol (®, ™ etc.) denotes a Novell trademark; an asterisk (*) denotes a third party trademark.
All information found in this book has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Novell, Inc., SUSE LINUX Products GmbH, the authors, nor the translators shall be held liable for possible errors or the consequences thereof.
Version 1.2, November 2002
Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
The purpose of this License is to make a manual, textbook, or other functional and useful document “free” in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.
This License is a kind of “copyleft”, which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.
We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.
This License applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under the conditions stated herein. The “Document”, below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as “you”. You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law.
A “Modified Version” of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.
A “Secondary Section” is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document’s overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.
The “Invariant Sections” are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections then there are none.
The “Cover Texts” are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words.
A “Transparent” copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup, or absence of markup, has been arranged to thwart or discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any substantial amount of text. A copy that is not “Transparent” is called “Opaque”.
Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML, PostScript or PDF produced by some word processors for output purposes only.
The “Title Page” means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, “Title Page” means the text near the most prominent appearance of the work’s title, preceding the beginning of the body of the text.
A section “Entitled XYZ” means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as “Acknowledgements”, “Dedications”, “Endorsements”, or “History”.) To “Preserve the Title” of such a section when you modify the Document means that it remains a section “Entitled XYZ” according to this definition.
The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document. These Warranty Disclaimers are considered to be included by reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License.
You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3.
You may also lend copies, under the same conditions stated above, and you may publicly display copies.
If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document’s license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects.
If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.
If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a computer-network location from which the general network-using public has access to download using public-standard network protocols a complete Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.
You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:
A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
B. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement.
C. State on the Title page the name of the publisher of the Modified Version, as the publisher.
D. Preserve all the copyright notices of the Document.
E. Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
F. Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below.
G. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document’s license notice.
H. Include an unaltered copy of this License.
I. Preserve the section Entitled “History”, Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled “History” in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
J. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the “History” section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
K. For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
M. Delete any section Entitled “Endorsements”. Such a section may not be included in the Modified Version.
N. Do not retitle any existing section to be Entitled “Endorsements” or to conflict in title with any Invariant Section.
O. Preserve any Warranty Disclaimers.
If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version’s license notice. These titles must be distinct from any other section titles.
You may add a section Entitled “Endorsements”, provided it contains nothing but endorsements of your Modified Version by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.
You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.
The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version.
You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers.
The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.
In the combination, you must combine any sections Entitled “History” in the various original documents, forming one section Entitled “History”; likewise combine any sections Entitled “Acknowledgements”, and any sections Entitled “Dedications”. You must delete all sections Entitled “Endorsements”.
You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.
You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document.
A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an “aggregate” if the copyright resulting from the compilation is not used to limit the legal rights of the compilation’s users beyond what the individual works permit. When the Document is included in an aggregate, this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document.
If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document’s Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate.
Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License, and all the license notices in the Document, and any Warranty Disclaimers, provided that you also include the original English version of this License and the original versions of those notices and disclaimers. In case of a disagreement between the translation and the original version of this License or a notice or disclaimer, the original version will prevail.
If a section in the Document is Entitled “Acknowledgements”, “Dedications”, or “History”, the requirement (section 4) to Preserve its Title (section 1) will typically require changing the actual title.
You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/.
Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License “or any later version” applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.
To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page:
Copyright (c) YEAR YOUR NAME. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled “GNU Free Documentation License”.
If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the “with...Texts.” line with this:
with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
If you have Invariant Sections without Cover Texts, or some other combination of the three, merge those two alternatives to suit the situation.
If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software.