Preface

This user’s guide provides information regarding the operation and use of the Netra trademark Data Plane Software Suite 2.0. This document is written for software engineers, developers, programmers, and users who have advanced experience with low-level programming.

Netra Data Plane Software is also referred to in this document as Netra DPS.

How This Document Is Organized

Chapter 1 is an introduction to Netra Data Plane Software Suite 2.0, and provides installation and theoretical information.

Chapter 2 discusses some of the basic aspects of the tejacc compiler.

Chapter 3 discusses the profiler used in the Netra Data Plane software.

Chapter 4 describes the Netra DPS native debugger and GNU debugger (GDB).

Chapter 5 describes interprocess communication (IPC) support.

Chapter 6 describes the remote command-line-interface (CLI).

Chapter 7 describes the the Eclipse-based Teja Advance Development Environment.

Chapter 8 describes the basic functions of the Receive Packet Classifier and the Netra DPS software interface.

Chapter 9 describes reference applications including IP packet forwarding and radio link protocol (RLP) applications..

Chapter 10 describes provides guidelines for diagnosing and tuning network applications running under the Lightweight Runtime Environment (LWRTE).

Appendix A is a tutorial to tejacc programming.

Appendix B provides frequently asked questions regarding the Netra Data Plane Software and how it interacts with the tejacc compiler.

Glossary

Using UNIX Commands

This document might not contain information about basic UNIX^® commands and procedures such as shutting down the system, booting the system, and configuring devices. Refer to the following for this information:

Software documentation that you received with your system

Solaris Operating System documentation, which is at:

http://docs.sun.com

Shell Prompts

Shell	Prompt
C shell	machine-name`%`
C shell superuser	machine-name`#`
Bourne shell and Korn shell	`$`
Bourne shell and Korn shell superuser	`#`

Typographic Conventions

Typeface`^[1]`	Meaning	Examples
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your`.login` file. Use `ls` `-a` to list all files. `% You have mail`.
`AaBbCc123`	What you type, when contrasted with on-screen computer output	`%` `su` `Password:`
AaBbCc123	Book titles, new words or terms, words to be emphasized. Replace command-line variables with real names or values.	Read Chapter 6 in the User’s Guide. These are called class options. You must be superuser to do this. To delete a file, type `rm` filename.

Typeface^[1]

Meaning

Examples

AaBbCc123

The names of commands, files, and directories; on-screen computer output

Edit your.login file.

Use ls -a to list all files.

% You have mail.

AaBbCc123

What you type, when contrasted with on-screen computer output

% su

Password:

AaBbCc123

Book titles, new words or terms, words to be emphasized. Replace command-line variables with real names or values.

Read Chapter 6 in the User’s Guide.

These are called class options.

You must be superuser to do this.

To delete a file, type rm filename.

Application	Title	Part Number	Format	Location
Operation	Netra Data Plane Software Suite 2.0 User’s Guide	820-3362-10	PDF	online
Reference	Netra Data Plane Software Suite 2.0 Reference Manual	820-3363-10	PDF	online
Last-minute information	Netra Data Plane Software Suite 2.0 Release Notes	820-3364-10	PDF	online
Documentation Location	Netra Data Plane Software Suite 2.0 Getting Started Guide	820-3365-10	PDF	online

Reference Documentation

Developing and Tuning Applications on UltraSPARC T1 Chip Multithreading Systems

http://www.opensparc.net/publications/published-by-sun/developing-and-tuning-applications-on-ultrasparcr-t1-chip-multithreading-systems.html

CoolThreads -- CMT Application Tuning and UltraSPARC T2 Server Resources http://www.sun.com/servers/coolthreads/tnb/t2.jsp

Sun Studio 12: C User’s Guide
http://docs.sun.com/app/docs/doc/819-5265

Netra Data Plane Software Suite 2.0 Reference Manual (tejacc 4.0 for Sun CMT reference manual)

Available in the Netra Data Plane Software Suite 2.0 release package.

UltraSPARC T1 Supplement to UltraSPARC Architecture 2005 Specification
http://opensparc-t1.sunsource.net/index.html

UltraSPARC Architecture 2007 Specification and OpenSPARC T2 Implementation-Supplement
http://www.opensparc.net/opensparc-t2

Logical Domains (LDoms): Sun SPARC CMT Virtualization Technology http://www.sun.com/servers/coolthreads/ldoms/index.xml

Eclipse: An Open Development Platform: http://www.eclipse.org/

GDB: The GNU Project Debugger: http://sourceware.org/gdb/

Information and documentation for the Logical Domains (LDoms) virtualization technology: http://www.sun.com/ldoms

Documentation, Support, and Training

Sun Function	URL
Documentation	`http://www.sun.com/documentation/`
Support	`http://www.sun.com/support/`
Training	`http://www.sun.com/training/`

Third-Party Web Sites

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. You can submit your comments by going to:

http://www.sun.com/hwdocs/feedback

Please include the title and part number of your document with your feedback:

Netra Data Plane Software Suite 2.0 User’s Guide, part number 820-3362-10

^{1 (TableFootnote) The settings on your browser might differ from these settings.}