File: rtapi_init.3rtapi

package info (click to toggle)
linuxcnc 1%3A2.9.7-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 285,604 kB
  • sloc: python: 202,568; ansic: 109,036; cpp: 99,239; tcl: 16,054; xml: 10,631; sh: 10,303; makefile: 1,255; javascript: 138; sql: 72; asm: 15
file content (31 lines) | stat: -rw-r--r-- 899 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
.TH rtapi_init "3rtapi" "2006-10-12" "LinuxCNC Documentation" "RTAPI"
.SH NAME

rtapi_init \- Sets up RTAPI

.SH SYNTAX
.HP
 int rtapi_init(const char *\fImodname\fR)

.SH ARGUMENTS
.IP \fImodname\fR
The name of this rtapi module

.SH DESCRIPTION

\fBrtapi_init\fR sets up the RTAPI.  It must be called by any
module that intends to use the API, before any other RTAPI
calls.

\fImodname\fR can optionally point to a string that identifies
the module.  The string will be truncated at \fBRTAPI_NAME_LEN\fR
characters.  If \fImodname\fR is \fBNULL\fR, the system will assign a
name.

.SH REALTIME CONSIDERATIONS
Call only from within non-realtime or realtime init/cleanup code, not from relatime tasks.

.SH RETURN VALUE
On success, returns a positive integer module ID, which is
used for subsequent calls to rtapi_xxx_new, rtapi_xxx_delete,
and rtapi_exit.  On failure, returns an RTAPI error code.