Preface

Writing Device Drivers for LynxOS

Preface

This guide contains information used to support the development of LynxOS device drivers. It covers:

Device driver structure and organization,

LynxOS system calls that support device drivers, and

Device driver installation and referencing under LynxOS.

For More Information

For more information on the features of LynxOS, refer to the following printed and online documentation.

Release Notes

This printed document contains late-breaking information about the current release.

LynxOS Installation Guide

This manual supports the initial installation and configuration of LynxOS and the X Windows System.

LynxOS User's Guide

This document contains information about basic system administration and kernel level specifics of LynxOS. It contains a "Quick Starting" chapter and covers a range of topics, including tuning system performance and creating kernel images for embedded applications.

Online information

Information about commands and utilities is provided online in text format through the man command. For example, a user wanting information about the GNU compiler would use the following syntax, where gcc is the argument for information about the GNU compiler:

man gcc

More recent versions of the documentation listed here may also be found online.

Typographical Conventions

The typefaces used in this manual, summarized below, emphasize important concepts. All references to file names and commands are case sensitive and should be typed accurately.

Kind of Text

Examples

Body text; italicized for emphasis, new terms, and book titles

Refer to the LynxOS User's Guide.

Environment variables, file names, functions, methods, options, parameter names, path names, commands, and computer data

Commands that need to be highlighted within body text, or commands that must be typed as is by the user are bolded.

ls
-l
myprog.c
/dev/null

login: myname

# cd /usr/home

Text that represents a variable, such as a file name or a value that must be entered by the user

cat filename

mv file1 file2

Blocks of text that appear on the display screen after entering instructions or commands

Loading file /tftpboot/shell.kdi into 0x4000

.....................

File loaded. Size is 1314816

Copyright 2000 LynuxWorks, Inc.

All rights reserved.

LynxOS (ppc) created Mon Jul 17 17:50:22 GMT 2000

user name:

Keyboard options, button names, and menu sequences

Enter, Ctrl-C

Special Notes

The following notations highlight any key points and cautionary notes that may appear in this manual.

Note: These callouts note important or useful points in the text.

Caution! Used for situations that present minor hazards that may interfere with or threaten equipment/performance.

Technical Support

LynuxWorks Technical Support is available Monday through Friday (holidays excluded) between 8:00 AM and 5:00 PM Pacific Time (U.S. Headquarters) or between 9:00 AM and 6:00 PM Central European Time (Europe).

The LynuxWorks World Wide Web home page provides additional information about our products and LynuxWorks news groups.

LynuxWorks U.S. Headquarters

Internet: [email protected]
Phone: (408) 979-3940
Fax: (408) 979-3945

LynuxWorks Europe

Internet: [email protected]
Phone: (+33) 1 30 85 06 00
Fax: (+33) 1 30 85 06 06

World Wide Web

http://www.lynuxworks.com

Kind of Text	Examples
Body text; italicized for emphasis, new terms, and book titles	Refer to the LynxOS User's Guide.
Environment variables, file names, functions, methods, options, parameter names, path names, commands, and computer data Commands that need to be highlighted within body text, or commands that must be typed as is by the user are bolded.	ls -l myprog.c /dev/null login: myname # cd /usr/home
Text that represents a variable, such as a file name or a value that must be entered by the user	cat filename mv file1 file2
Blocks of text that appear on the display screen after entering instructions or commands	Loading file /tftpboot/shell.kdi into 0x4000 ..................... File loaded. Size is 1314816 Copyright 2000 LynuxWorks, Inc. All rights reserved. LynxOS (ppc) created Mon Jul 17 17:50:22 GMT 2000 user name:
Keyboard options, button names, and menu sequences	Enter, Ctrl-C

Note: These callouts note important or useful points in the text.

	Caution! Used for situations that present minor hazards that may interfere with or threaten equipment/performance.

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