ref_prm(1) ref_prm(1)
NAME
refprm - Allgemeine Einführung zum Referenzhandbuch für Programmierer
BESCHREIBUNG
Übersicht
Im Referenzhandbuch für Programmierer (Reliant UNIX 5.44) werden die
Kommandos, Systemaufrufe, Bibliotheksfunktionen, Dateiformate und
Hilfswerkzeuge beschrieben, die von C-Programmierern auf den Rechnern
RM400 (bzw. RM200 und RM300) und RM600 benutzt werden.
Namenskonventionen
Im gesamten Handbuch stellen die Extensionen, die in Klammern hinter
einem Kommandonamen, dem Namen einer Bibliotheksfunktion, dem Namen
für eine Include-Datei usw. stehen, Querverweise auf den entsprechen-
den Abschnitt in diesem Handbuch dar. So finden Sie beispielsweise die
Beschreibung einer Bibliotheksfunktion mit der Extension (2) oder (3C)
im entsprechenden Abschnitt des Handbuchs.
Beschreibungen mit der Extension (1M) befinden sich entweder im ent-
sprechenden Abschnitt des Referenzhandbuchs für Systemverwalter oder
des Netz-Referenzhandbuchs.
Beschreibung mit der Extension (3N) befinden sich im entsprechenden
Abschnitt des Netz-Referenzhandbuchs.
Beschreibungen mit den Extensionen (4) oder (5) befinden sich entweder
im Abschnitt 4 oder 5 des vorliegenden Handbuchs oder im Referenzhand-
buch für Programmierer (bzw. im Netz-Referenzhandbuch).
Beschreibungen mit den Extensionen (7) oder (8) befinden sich entweder
im entsprechenden Abschnitt des Referenzhandbuchs für Systemverwalter
oder des Netz-Referenzhandbuchs.
Ist nach einem Kommandonamen eine (1) angegeben, so befindet sich die
dazugehörige Beschreibung außer in diesem Handbuch entweder im Hand-
buch
Kommandos. Referenzhandbuch für Benutzer
oder im
Netz-Referenzhandbuch.
Am Ende dieser Referenzseite sowie unter refurm(1) und refnet(1)
finden Sie eine Übersicht, in welchem Handbuch welches Benutzer-
Kommando zu finden ist.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
ref_prm(1) ref_prm(1)
Hinweis für Online-Benutzer:
Man kann mit dem man-Kommando eine Referenzseite (Manual Page) über
die Extension gezielt aufrufen. Dies ist nützlich, wenn eine Referenz-
seite unter dem selben Namen in mehreren Abschnitten vorhanden ist und
sich nur durch die Extension am Namen unterscheidet, etwa bei "iconv",
das es in drei "Versionen" gibt: iconv(1) [Benutzer-Kommando],
iconv(3C) [C-Funktion] und iconv(5) [Header-Datei]. Wenn Sie die Refe-
renzseite mit "man iconv" aufrufen, werden Ihnen nacheinander alle
drei Beschreibungen am Bildschirm angezeigt. Wenn Sie dagegen nur eine
dieser drei Beschreibungen interessiert - z. B. die der C-Funktion -,
müssen Sie die Referenzseite folgendermaßen aufrufen: "man 3C iconv".
Analog verhält es sich mit Referenzseiten, die es in verschiedenen
"Versionen" gibt, etwa von AT&T und UCB. Auch hier kann man die
gewünschte Beschreibung gezielt aufrufen, etwa beim Kommando "chown",
das es in zwei Ausprägungen von AT&T und von UCB gibt. Wenn Sie z. B.
nur die UCB-Beschreibung interessiert, müssen Sie die Referenzseite
folgendermaßen aufrufen: "man 1-ucb chown".
Struktur
Das Referenzhandbuch für Programmierer ist in folgende Abschnitte
gegliedert:
(1) Kommandos
(2) Systemaufrufe
(3) Verschiedene Funktionen der Bibliothek libucb
(3C) Funktionen zur C-Programmierung aus der Standardbibliothek libc
(3E) Funktionen für das ELF-Format aus der Bibliothek libelf
(3G) Allgemeine Funktionen der Bibliothek libgen
(3M) Mathematische Funktionen aus der Bibliothek libm
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
ref_prm(1) ref_prm(1)
(3S) Funktionen für die Standardein-/ausgabe aus der Standardbiblio-
thek libc
(3X) Funktionen aus Spezialbibliotheken
(4) Dateiformate und Include-Dateien
(5) Verschiedene Einrichtungen und Include-Dateien
Abschnitt 1, "Kommandos", beschreibt die Kommandos, die für C und
andere Programmiersprachen verwendet werden.
Abschnitt 2, "Systemaufrufe", beschreibt den Zugriff auf die vom
Systemkern zur Verfügung gestellten Dienste.
Die Abschnitte 3?, "Bibliotheksfunktionen", beschreiben die zur Verfü-
gung stehenden Bibliotheksfunktionen. Eine ausführliche Beschreibung
zum Umgang mit Systemaufrufen bzw. Bibliotheksfunktionen finden Sie
unter introprm2(2). Eine Einführung zur Bibliothek libelf (ELF-For-
mat) finden Sie unter elf(3E).
Aus der Sicht des Programmierers besteht kein Unterschied zwischen den
Systemaufrufen im Abschnitt 2 und den Bibliotheksfunktionen in den
3er-Abschnitten. Die Aufteilung in die Abschnitte 2 und 3 ist ein
Relikt aus der Historie von UNIX.
Abschnitt 4, "Dateiformate", dokumentiert die Struktur bestimmter
Dateiarten. So wird beispielsweise das Format für die Ausgabe des Bin-
derprogramms in a.out(4) angegeben. Außerdem sind im Abschnitt 4
einige Header-Dateien beschrieben.
Abschnitt 5, "Verschiedene Einrichtungen", beschreibt verschiedene
Einrichtungen wie z. B. Makro-Pakete, Zeichensätze usw. Daneben sind
auch im Abschnitt 5 Header-Dateien beschrieben.
Im allgemeinen sind die Header- bzw. Include-Dateien in den Verzeich-
nissen /usr/include und /usr/include/sys zu finden.
Mehrere Abschnitte beginnen mit einer Beschreibung mit dem Namen
introprmn. Die darauf folgenden Beschreibungen sind alphabetisch
angeordnet und können auch mehrere Seiten umfassen. Etliche Einträge
beschreiben mehrere Routinen auf einmal. In derartigen Fällen exi-
stiert der Eintrag nur einmal, und zwar unter dem "Primärnamen" alpha-
betisch eingeordnet. Ein Beispiel für einen derartigen Eintrag stellt
string(3C) dar, da dort dem primären Sammelnamen "string:" 15 ver-
schiedene Routinen (von strcat bis strstr) beschrieben sind. Diese
"Alias-Namen" sind immer nur unter dem Namen des entsprechenden Pri-
märnamens aufgeführt und beschrieben.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98
ref_prm(1) ref_prm(1)
Für Online-Benutzer hat dies die Konsequenz, daß sowohl beim Aufruf
"man string" als auch etwa beim Aufruf "man strlen" nur eine einzige
Referenzseite (Manual Page) angezeigt wird, die die gewünschte
Beschreibung enthält.
Alle Referenzseiten haben ein gemeinsames Format, was die inhaltliche
Gliederung (Kapitel-Struktur) und die Syntax für die Verwendung der
Kommandos betrifft. Näheres zu diesen Konventionen finden Sie unter
introprm1(1) und introurm(1). Generelle Hinweise zu den intro-
Referenzseiten finden Sie unter intro(1). In manprint(1) ist beschrie-
ben, wie Sie eine mit dem "man"-Kommando am Bildschirm angezeigte
Referenzseite ausdrucken können.
BENUTZER-KOMMANDOS IN ANDEREN HANDBÜCHERN
Kommandos. Referenzhandbuch für Benutzer
.(1)
:(1)
[(1)
a20r(1)
acctcom(1)
addbib(1)
aedplot(1)
alias(1)
apropos(1)
apropos(1-ucb)
ar(1)
arch(1)
at(1)
atq(1)
atrm(1)
awk(1)
banner(1)
basename(1)
basename(1-ucb)
batch(1)
bc(1)
bdiff(1)
bfs(1)
bg(1)
bgplot(1)
biff(1)
break(1)
cal(1)
calendar(1)
cancel(1)
cat(1)
cd(1)
ced(1)
chdir(1)
checknr(1)
Seite 4 Reliant UNIX 5.44 Gedruckt 11/98
ref_prm(1) ref_prm(1)
chgrp(1)
chmod(1)
chown(1)
chown(1-ucb)
chsh(1)
cksum(1)
clear(1)
cmp(1)
col(1)
colon(1)
comm(1)
command(1)
compress(1)
continue(1)
copy(1)
cp(1)
cpio(1)
cpl(1)
crontab(1)
crtplot(1)
crypt(1)
csh(1)
csplit(1)
ctags(1)
cut(1)
date(1)
dc(1)
dd(1)
deroff(1)
deroff(1-ucb)
destroy(1)
df(1)
df(1-ucb)
df(1-ufs)
df(1-vxfs)
dfspace(1)
diff(1)
diff3(1)
dircmp(1)
dirname(1)
disable(1)
doscat(1)
doscp(1)
dosdir(1)
dosfilt(1)
dosformat(1)
doslabel(1)
dosls(1)
dosmkdir(1)
dosrm(1)
dosrmdir(1)
dot(1)
Seite 5 Reliant UNIX 5.44 Gedruckt 11/98
ref_prm(1) ref_prm(1)
du(1)
du(1-ucb)
dumbplot(1)
dumpmsg(1)
e(1)
echo(1)
echo(1-ucb)
ed(1)
edit(1)
egrep(1)
enable(1)
env(1)
eval(1)
ex(1)
exec(1)
exit(1)
expand(1)
export(1)
expr(1)
exstr(1)
extract(1)
face(1)
factor(1)
false(1)
fc(1)
fg(1)
fgrep(1)
file(1)
find(1)
findman(1)
flchk(1)
fldisp(1)
flinit(1)
fmli(1)
fmt(1)
fmtmsg(1)
fold(1)
fsirand(1)
gcore(1)
gencat(1)
getconf(1)
getext(1)
getopt(1)
getoptcvt(1)
getopts(1)
gettxt(1)
gettypes(1)
gigiplot(1)
grep(1)
groups(1)
groups(1-ucb)
hash(1)
Seite 6 Reliant UNIX 5.44 Gedruckt 11/98
ref_prm(1) ref_prm(1)
hashcheck(1)
hashmake(1)
hd(1)
head(1)
hpplot(1)
i286(1)
i386(1)
i486(1)
ic(1)
iconv(1)
id(1)
iecho(1)
implot(1)
indxbib(1)
ipcrm(1)
ipcs(1)
iput(1)
jobs(1)
join(1)
jsh(1)
kill(1)
ksh(1)
last(1)
lastcomm(1)
lc(1)
less(1)
lesskey(1)
let(1)
lfmt(1)
line(1)
listusers(1)
ln(1)
ln(1-ucb)
locale(1)
localedef(1)
logger(1)
logger(1-ucb)
login(1)
logname(1)
look(1)
lookbib(1)
lp(1)
lpq(1)
lpr(1)
lprm(1)
lpstat(1)
lptest(1)
ls(1)
ls(1-ucb)
m120(1)
m68k(1)
mach(1)
Seite 7 Reliant UNIX 5.44 Gedruckt 11/98
ref_prm(1) ref_prm(1)
machid(1)
mail(1)
mail(1-ucb)
mailalias(1)
mailx(1)
makekey(1)
man(1)
man(1-ucb)
man-news(1)
manprint(1)
md5(1)
mesg(1)
mips(1)
mkdir(1)
mkfifo(1)
mkmsgs(1)
more(1)
mt(1)
mv(1)
nawk(1)
newform(1)
newgrp(1)
news(1)
nice(1)
nl(1)
nohup(1)
notify(1)
od(1)
pack(1)
page(1)
pagesize(1)
passwd(1)
paste(1)
patch(1)
pathchk(1)
pax(1)
pcat(1)
pdp11(1)
pfmt(1)
pg(1)
plot(1)
pr(1)
print(1)
printenv(1)
printf(1)
priocntl(1)
prt(1)
ps(1)
ps(1-ucb)
pwd(1)
random(1)
read(1)
Seite 8 Reliant UNIX 5.44 Gedruckt 11/98
ref_prm(1) ref_prm(1)
readonly(1)
red(1)
refer(1)
renice(1)
renice(1-ucb)
reset(1-ucb)
return(1)
rksh(1)
rm(1)
rm200(1)
rm300(1)
rm400(1)
rm600(1)
rm700(1)
rmail(1)
rmail(1-ucb)
rmdir(1)
roffbib(1)
sar(1)
script(1)
sdiff(1)
sed(1)
set(1)
setext(1)
settime(1)
sh(1)
shift(1)
shl(1)
sinfilt(1)
sleep(1)
soelim(1)
sort(1)
sortbib(1)
sparc(1)
spell(1)
spellin(1)
split(1)
srchtxt(1)
stop(1)
strchg(1)
strconf(1)
strextract(1)
strings(1)
stty(1)
stty(1-ucb)
su(1)
sum(1)
sum(1-ucb)
suspend(1)
t300(1)
t300s(1)
t4013(1)
Seite 9 Reliant UNIX 5.44 Gedruckt 11/98
ref_prm(1) ref_prm(1)
t450(1)
t4600(1)
tabs(1)
tail(1)
tar(1)
tcopy(1)
tee(1)
tek(1)
test(1)
test(1-ucb)
time(1)
times(1)
timex(1)
touch(1)
tput(1)
tr(1)
tr(1-ucb)
trap(1)
true(1)
truss(1)
tset(1)
tset(1-ucb)
tty(1)
type(1)
typeset(1)
u370(1)
u3b(1)
u3b15(1)
u3b2(1)
u3b5(1)
ul(1)
ulimit(1)
umask(1)
unalias(1)
uname(1)
uncompress(1)
unexpand(1)
unifdef(1)
uniq(1)
units(1)
unpack(1)
unset(1)
uptime(1)
users(1)
vacation(1)
vacation(1-ucb)
vax(1)
vedit(1)
vi(1)
view(1)
w(1)
wait(1)
Seite 10 Reliant UNIX 5.44 Gedruckt 11/98
ref_prm(1) ref_prm(1)
wc(1)
wcheck(1)
whatis(1)
whence(1)
which(1)
who(1)
whoami(1)
write(1)
xargs(1)
xpg4sh(1)
yes(1)
zcat(1)
Netz-Referenzhandbuch
ct(1)
cu(1)
domainname(1)
finger(1)
ftp(1)
hostid(1)
hostname(1)
rcp(1)
rlogin(1)
rpcgen(1)
rsh(1)
ruptime(1)
rusers(1)
rwho(1)
talk(1)
telnet(1)
tftp(1)
uucp(1)
uudecode(1)
uuencode(1)
uuglist(1)
uulog(1)
uuname(1)
uupick(1)
uustat(1)
uuto(1)
uux(1)
whois(1)
ypcat(1)
ypmatch(1)
ypwhich(1)
Seite 11 Reliant UNIX 5.44 Gedruckt 11/98
ref_prm(1) ref_prm(1)
HINWEISE
Wenn Sie zu einem Stichwort nicht den genauen Namen der Referenzseite
wissen, ist das Kommando apropos(1) [alternativer Aufruf "man -k",
beide beschrieben unter man(1)] hilfreich. Angenommen, Sie möchten die
Namen derjenigen Referenzseiten herausfinden, die es zum Thema "tempo-
räre Dateien" gibt, dann geben Sie ein:
apropos temporär
Achtung: Bei eingestellter deutscher Sprachvariable ist "temporär" mit
echtem Umlaut einzugeben!
Es werden Ihnen dann folgende Referenzseiten angeboten (Groß- und
Kleinschreibung wird nicht unterschieden):
tempnam (3S) - Name für temporäre Datei erstellen
tmpfile (3S) - Temporäre Datei erstellen
tmpnam (3S) - Name für temporäre Datei erstellen
SIEHE AUCH
intro(1), introprm1(1), introurm(1), man(1), man-news(1),
manprint(1), refnet(1), refsarm(1), refurm(1), introprm2(2),
elf(3E), introprm4(4), introprm5(5).
Seite 12 Reliant UNIX 5.44 Gedruckt 11/98