LynxOS User's Guide

Preface

For More Information

Typographical Conventions

Special Notes

Technical Support

LynuxWorks U.S. Headquarters

LynuxWorks Europe

World Wide Web

Chapter 1 Introduction

About LynxOS

LynxOS Features

LynxOS Documentation

About POSIX

LynxOS and POSIX Standards

Benefits of POSIX

Chapter 2 Getting Started

LynxOS Packages

Starting and Stopping LynxOS

Starting and Stopping X Windows

Using PosixWorks Desk

Basic LynxOS Commands

LynxOS Man Pages

Creating File Systems and Making Backups

Making Backups

LynxOS Cross Development Environment

Setting the Cross Development Environment

The Application Development Process

Creating Source Code with vi Text Editor

Example vi C Program

Compiling and Linking Source Code

Debugging Source Code

Creating Custom Kernels

Making Final Images

Identifying LynxOS Facilities for Run-Time

Chapter 3 LynxOS System Administration

System Administration Tasks

Using the setup Utility

Managing User Privileges

Understanding the /etc Directory Contents

Creating Device Nodes

LynxOS Device Node Naming Conventions

Major and Minor Numbers

Managing Terminals

Enabling Ports for Login

Describing Terminals

Serial Port Configurations

User Accounts

Root and Setup Accounts

Using the adduser Utility

Using the deluser Utility

Understanding Security Issues

File Permissions

Changing Permissions with chmod

Default Permissions

Changing Effective User ID

Process Protection

Chapter 4 Disk Space Management

Formatting Media

Formatting Floppy Disks

Formatting SCSI Disks

Configuring Disk Space

Making File Systems

Organizing Files

Managing Disk Space Usage

The du Command

Using df Command

Using the find Command to Determine File Usage

Backing Up the System

The tar Command

Creating Backup Policies and Procedures

Chapter 5 Shared Libraries

Overview

Creating Shared Libraries by Default

Single/Multithreaded Applications and Shared Libraries

Effects of Using Shared Libraries

System Memory Usage

Disk Space Usage

Code Maintenance

Determining the Use of Shared Libraries

Example 1

Example 2

Example 3

Choosing Shared Library Contents

Updating Shared Libraries

Libraries Provided

Creating Shared Libraries

Linking to a Shared Library

Chapter 6 X & Motif Development Package

Installing and Starting X

X Server Features Overview

X Server Technology from Metro-X

Networking and the X Server

X Server Hot Key Exit

Hot Key Resolution Switching

Hardware Panning

Touchscreen Support

International Keyboard Support

Multiheaded Servers

X Libraries

The Development System

Library Documentation

x86/PPC Libraries

Motif Libraries

Other Libraries

X Utilities

imake

uil

Troubleshooting X

Before Contacting LynuxWorks Technical Support

Modifying Disk Cache Blocks

Limited Colors

Unsupported Programs

Xconsole and newconsole

Saving Errors

Window Manager

Real-Time Priorities and X

Serial Printer

Diamond Viper 550 TNT video card (x86 only)

X Development Troubleshooting

Chapter 7 Customizing the Default LynxOS Kernel Configuration

Reasons for Kernel Customization

Customizing for Performance

Customizing for Size

Customizing for Functionality

Overview of the /sys Directory

Accessing and Modifying the Main Kernel Directory

Customizing from a Cross Development Host

Adding TCP/IP to a LynxOS Kernel

Customizing a Kernel for Performance

Configurable Parameters in /sys/lynx.os/uparam.h

Parameter Default Values in /sys/lynx.os/uparam.h

Increasing Maximum Processes

Creating a Kernel for Debugging

Changing Kernel Size

Determining the Kernel Size

Removing Unused Device Drivers

Adding Functionality to a Kernel

Adding a Custom Device Driver

Configurable Tick Timer

Configuring Core Files

Configurable Options

Installing Configurable Core File Capability

User Definitions in uparam.h

Chapter 8 Creating Kernel Downloadable Images (KDIs)

Overview

mkimage - the LynxOS KDI Creation Utility

The mkimage Syntax and Features

LynxOS Kernel

Embedded File Systems

Embedded Root File Systems

Embedded Stand-Alone File System Images

Resident Text Segments

Creating a KDI Image

Procedure Overview

Enabling the RAM Disk Driver

Modifying Kernel Parameters

Creating a Specification File

Testing Kernel Images

Booting KDIs

Booting Images over a Network

Booting Images from ROM

KDI Build Templates

Template Conceptual Overview

Included KDI Build Templates

kdi Directory Structure

Restrictions

Getting Started

Building KDIs

Example--Building, Booting, and Using the developer KDI

Configuring the Developer KDI

Configuring the Linux Cross Development Host

Booting the KDI

Using the KDI

ROMing Issues

Generating PROM Images on x86 Systems

Creating Bootable Installation Media

Creating a Bootable x86 Floppy

Creating a Bootable x86 or PowerPC CD-ROM

Chapter 9 Linux ABI Compatibility

Overview

Installing the Linux ABI Layer

Linux ABI Layer

Interoperability with LynxOS Native Applications

Linux ABI Shared Libraries

Adding Linux Shared Libraries to LynxOS

Linux ABI Shared Libraries that Should Not Be Overwritten

Specifying Linux ABI Shared Library Paths

Running Linux Applications

Linux Reference Distribution

Support for Dynamically Linked Applications

Exceptions and Limitations

Extracting RPMs with rpm2cpio

Example -- Running Opera

Installing Linux ABI Layer

Downloading Opera

Configuring the Linux ABI Layer

Chapter 10 Event Logging

The Event Logging System

Event Logging Components

Process Flow

Write Flow

Read Flow

Open Flow

Notify Flow

Installing the Event Logging System

Installing on a Native LynxOS System

Installing On a Cross Development System

Configuring the Event Logging System

Event Logging Parameters

Configurable Parameters

The Event Logging Daemon

Function Prototypes and Descriptions

typedefs in eventlog.h

Writing Log Entries

Processing Log Entries

Setting Log Facilities

Querying Log Entries

Sample Driver Code

Kernel Code Example

User Code Example

Appendix A Glossary

Index

LynuxWorks, Inc. 855 Branham Lane East San Jose, CA 95138 http://www.lynuxworks.com 1.800.255.5969