Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

ttdt_open(3)  —  Subroutines

CDE

NAME

ttdt_open − create a ToolTalk communication endpoint

SYNOPSIS

#include <Tt/tttk.h> char ∗ttdt_open(int ∗ttfd,  const char ∗toolname,  const char ∗vendor,  const char ∗version,  int sendStarted);

DESCRIPTION

The ttdt_open function calls tt_open3 and tt_fd3.  It associates toolname, vendor and version with the created procid, and initializes the new procid’s default contexts from the process environment.  If sendStarted is True, ttdt_open sends a Started notice. 

RETURN VALUE

Upon successful completion, the ttdt_open function returns the created procid in a string that can be freed with tt_free; otherwise, the ttdt_open function may return any of the errors returned by tt_open3 and tt_fd3. 

No errors are propagated if sending the Started notice fails. 

SEE ALSO

Tt/tttk.h5, ttdt_close3, tt_open3, tt_fd3, tt_free3. 

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026