DOMAIN(3) Domain/OS SysV DOMAIN(3)
NAME
domain - Domain/OS-specific C library subroutines
DESCRIPTION
Domain/OS SysV represents only a subset of the greater functionality of
Domain/OS. Furthermore, Domain/OS SysV omits some features of System V
Release 3 that are irrelevant to Apollo workstations. The following
paragraphs describe aspects of that greater functionality that are
visible to the Domain/OS SysV applications programmer and summarize
features of System V Release 3 not implemented under Domain/OS SysV.
Domain/OS Calls. All of the interfaces giving applications access to the
greater functionality of Domain/OS can be called from Domain/OS SysV.
The declarations for these calls have been prototyped according to ANSI
standard C and placed in /usr/include/apollo. See the Domain/OS Call
Reference for more information on these interfaces.
Organization File. In addition to the /etc/passwd and /etc/group files
for storing information about user and group accounts, Domain/OS SysV
provides a file for storing information about organization accounts,
/etc/org. See org(4) and "Creating and Maintaining the Registry" in
Domain/OS System Administration Reference for more information about the
organization file.
Domain/OS SysV also provides six subroutines that constitute a C-language
interface to the organization file:
_______________________________________________
______________Unique_Subroutines_______________|
| Name | Function | Reference |
_______________________________________________|
|getorgent | | |
|getorgid | | |
|getorgnam | get organization | getorgent(3C) |
|setorgent | file entry | |
|endorgent | | |
_setorgfile____________________________________|
Registry Server. Under Domain/OS SysV, /etc/passwd is a read-only object
of the type "passwd," and /etc/group is a read-only object of the type
"group," both maintained by the registry server (see rgyd(1M).
The conventional C-language interfaces to these files (described in and
getpwent(3C)) interact with the registry server transparently.
For those desiring more control, however, Domain/OS SysV provides two
additional subroutines: setpwfile and setgrfile. These allow you to
specify the password file and group file, respectively. In this case,
the subroutines interact with the named file in ways determined by its
type manager.
COFF Interfaces. Apollo compilers and the Domain/OS SysV link editor
(ld(1)) produce output in common object file format (COFF). The
interfaces to COFF objects conventionally provided by UNIX System V
Release 3 are also available in Domain/OS SysV. Domain/OS SysV, however,
provides three additional interfaces:
____________________________________________________
_________________Unique_Subroutines_________________|
| Name | Function | Reference |
____________________________________________________|
|ldgetarname | retrieve the | ldgetarname(3X) |
| | filename of a | |
| | member of an | |
_______________archive_file_________________________|
|ldgetstring | retrieve string | ldgetstring(3X) |
| | from common object | |
| | file string table | |
____________________________________________________|
|ldsgetname | retrieve section | ldsgetname(3X) |
| | name for common | |
_______________object_file_entry____________________|
Domain/OS SysV omits the following C-language subroutines, implemented in
UNIX System V, Release 3:
_______________________________________________________________
____________________Unsupported_Subroutines____________________|
| Name | Function | Reference (UNIX System V, |
| | | Release 3 manuals) |
_______________________________________________________________|
|crypt | password and file | crypt(3X) |
| | encryption | |
_______________functions_______________________________________|
|fpgetround | | |
|fpsetround | | |
|fpgetmask | IEEE floating point | |
|fpsetmask | environment control | fpgetround(3C) |
|fpgetsticky | | |
|fpsetsticky | | |
_______________________________________________________________|
|isnand | test for floating | |
|isnanf | point NaN (Not-A- | isnan(3C) |
_______________Number)_________________________________________|
|libwindows | windowing terminal | libwindows(3X) |
| | function library | |
_______________________________________________________________|
Domain/OS SysV provides no /lib/libm.a. It places its math subroutines
in /lib/libc. There also are no /lib/libc.a or shared libraries.
Domain/OS SysV Manual pages describing specific features may point out
other differences. These descriptions usually appear in the "Notes"
section.
Additional Support. Domain/OS SysV is compliant with industry standards,
including POSIX IEEE 1003.1A, XPG/3, FIPS 15110, ANSI C Standard
(X3.159-1989), and OSF OSC AES (Application Environment Specification).
The following standard-based support and additional features have been
added:
New interfaces based on POSIX IEEE 1003.1A, XPG/3, FIPS 15110, ANSI
C Standard (X3.159-1989), and OSF OSC AES (Application Environment
Specification)
Internationalization functions
POSIX IEEE 1003.4a (draft 4) based Pthreads calls
Mach-based Kernel Threads interfaces
The following standards-based man pages have been added:
cfgetispeed
cfgetospeed
cfsetispeed
cfsetospeed
pathconf
setpgid
setsid
sigaction
siglongjmp
sigpending
sigprocmask
sigsetjmp
sigsetops
sigsuspend
tcdrain
tcflow
tcflush
tcgetattr
tcgetpgrp
tcsendbreak
tcsetattr
tcsetpgrp
termios
getclock
gettimer
mktimer
msem_init
msem_lock
msem_remove
msem_unlock
reltimer
rmtimer
setclock
clearenv
fsync
The following Pthreads man pages have been added:
pthread_attr_create
pthread_attr_delete
pthread_attr_getstacksize
pthread_attr_setstacksize
pthread_cancel
pthread_cleanup_pop
pthread_cleanup_push
pthread_cond_broadcast
pthread_cond_destroy
pthread_cond_init
pthread_cond_signal
pthread_cond_timedwait
pthread_cond_wait
pthread_condattr_create
pthread_condattr_delete
pthread_create
pthread_detach
pthread_equal
pthread_exit
pthread_getspecific
pthread_join
pthread_keycreate
pthread_mutex_destroy
pthread_mutex_init
pthread_mutex_lock
pthread_mutex_trylock
pthread_mutex_unlock
pthread_mutexattr_create
pthread_mutexattr_delete
pthread_once
pthread_self
pthread_setasynccancel
pthread_setcancel
pthread_setspecific
pthread_testcancel
pthread_yield
The following Mach-based Threads man pages have been added:
thread_abort
thread_cleanup
thread_create
thread_handle_signals
thread_info
thread_inhibit
thread_resume
thread_self
thread_set_priority
thread_startup
thread_state
thread_suspend
thread_terminate
threadp_get
threadp_init
threadp_set
The following man pages for reentrant code and related functions have
been added:
flockfile
funlockfile
unlocked_getc
unlocked_putc
asctime_r
getgrgid_r
getpwuid_r
strtok_r
ctime_r
getgrnam_r
gmtime_r
ttyname_r
getlogin_r
localtime_r
readdir_r
getpwnam_r
opendir_r
The following man pages supporting internationalization (I18N) have been
added:
catclose
catgets
catopen
localeconv
nl_langinfo
SEE ALSO
domain(2), getgrent(3C), getorgent(3C), getpwent(3C), ldgetarname(3X),
ldgetstring(3X), ldsgetname(3X), a.out(4), domain(4), domain(5).
Domain/OS Call Reference.