xref: /relibc/pthreads-emb/doc/pte_users_guide.html (revision f531db8a6880fc9c191254e1eb5575adbfe8d34b)
1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
2<html><head><meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>PTE User's Guide</title></head><body><br><big style="font-weight: bold;"><big>PTE Users Guide</big></big><br><br>Since
3PTE is designed to be cross platform, and embedded OS's vary widely in
4their build methodology, there is no "high level" build structure
5included. &nbsp;Rather, each port is responsible for providing this.
6&nbsp;The sections below describe using PTE for a specific platform.<br><br>While
7pthreads is strictly speaking a C API, PTE does include limited support
8for C++ specific features, specifically exceptions. &nbsp;This
9functionality was primarily inherited from the original code base
10(Pthreads-win32) and has been only preliminarily tested.<br><br>An
11important component of PTE is the test library that is included.
12&nbsp;Each platform contains build files as described below to build
13the test suite.<br><big style="font-weight: bold; font-style: italic;"><br>DSP/BIOS</big><br>Texas
14Instruments provides DSP/BIOS as a RTOS to be used on their series of
15digital signal processors. &nbsp;Two project files are included: one
16for the library itself and one for the test suite. &nbsp;These projects
17(and CDB/TCF files) were targeted towards the C6000 simulator, as this
18is where I did all of the development. &nbsp;When building applications
19that use the PTE library, you will need to include pthreads.h and will
20also need to provide a path to pte-types.h (originally located in
21platforms/dspbios/pte-types.h). &nbsp;This file contains definitions of
22structures and types (e.g. pid_t) that are required by pthreads but not
23supplied by DSP/BIOS<br><big style="font-weight: bold; font-style: italic;"><br>PSP OS</big><br>This
24is the operating system used by the Sony PSP. &nbsp;The PSP toolchain
25is gcc based and thus shares many similarities with a "typical" UNIX
26system, including the build system. &nbsp;PTE includes Makefiles for
27the library itself as well as the test suite. &nbsp;Note that these
28Makefiles are pretty rudimentary as I am not anywhere close to being a
29Makefile expert. &nbsp;Thus, once the library is built it will be
30necessary to copy the library itself, pthread.h and pte-types.h to the
31appropriate places in your projects build structure. &nbsp;The PSP
32toolchain includes a pthread.h header in the base distribution (why,
33I'm not sure) - it is important that you use the pthread.hsupplied with PTE rather than the one in the toolchain. <br><br></body></html>