diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-26 16:38:00 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-26 16:38:00 -0400 |
| commit | 97d5c458cfa039d857301e1ca7d5af3beb37131d (patch) | |
| tree | b460cd850d0537eb71806ba30358840377b27688 /static/v10/man2 | |
| parent | b89dc2331a50c63f8b33272a5c4c61ab98abdaa3 (diff) | |
build: Better Build System
Diffstat (limited to 'static/v10/man2')
80 files changed, 0 insertions, 5502 deletions
diff --git a/static/v10/man2/Makefile b/static/v10/man2/Makefile deleted file mode 100644 index b938fb36..00000000 --- a/static/v10/man2/Makefile +++ /dev/null @@ -1,3 +0,0 @@ -MAN = $(wildcard *.2) - -include ../../mandoc.mk diff --git a/static/v10/man2/access.2 b/static/v10/man2/access.2 deleted file mode 100644 index f8f758da..00000000 --- a/static/v10/man2/access.2 +++ /dev/null @@ -1,63 +0,0 @@ -.TH ACCESS 2 -.CT 2 dirs file_inq_creat secur -.SH NAME -access \(mi determine accessibility of file -.SH SYNOPSIS -.nf -.B int access(name, mode) -.B char *name; -.fi -.SH DESCRIPTION -.I Access -checks the given -file -.I name -for accessibility. -If \fImode\fL&4\fR -is nonzero, read access is checked. -If \fImode\fL&2\fR -is nonzero, write access is checked. -If \fImode\fL&1\fR -is nonzero, execute access is checked. -If \fImode\fL==\fR0, -the file merely need exist. -In any case -all directories leading to the file -must permit searches. -0 is returned if the access is permitted,, -\-1 if not. -.PP -Permission is checked -against the real userid and groupid of the process; -this call is most useful in set-userid and set-groupid programs. -.PP -Only access bits are checked. -A directory may be announced as writable by -.IR access , -but an attempt to open it for writing will fail -(although files may be created there); -a file may look executable, but -.IR exec (2) -will fail unless it is in proper format. -.PP -If the userid of the process is the owner of the file -access is determined by the three owner bits (0700). -Otherwise, if the groupid of the process is the group -of the file access is determined by the three group bits (0070). -Otherwise access is determined by the three other bits (0007). -.SH SEE ALSO -.IR stat (2) -.SH DIAGNOSTICS -.BR EACCES , -.BR ELAB , -.BR EFAULT , -.BR EIO , -.BR ELOOP , -.BR ENOENT , -.BR ENOTDIR , -.BR EROFS , -.BR ETXTBSY -.SH BUGS -On symbolic links permissions are irrelevant and -.IR access -returns nonsense. diff --git a/static/v10/man2/acct.2 b/static/v10/man2/acct.2 deleted file mode 100644 index d00008a1..00000000 --- a/static/v10/man2/acct.2 +++ /dev/null @@ -1,46 +0,0 @@ -.TH ACCT 2 -.CT 2 sa -.SH NAME -acct \(mi turn accounting on or off -.SH SYNOPSIS -.nf -.B int acct(file) -.B char *file; -.fi -.SH DESCRIPTION -.IR Acct , -with a null-terminated string naming an existing file -as argument, turns on accounting; -records for each terminating process are appended to -.IR file . -An argument of -.L -(char *)0 -causes accounting to be turned off. -.PP -.I Acct -may only be invoked by the super-user. -.PP -The accounting file format is given in -.IR acct (5). -.SH "SEE ALSO" -.IR acct (5), -.IR sa (8) -.SH DIAGNOSTICS -.B EACCES -(file not a regular file), -.B EBUSY -(accounting already turned on), -.BR EFAULT , -.BR EIO , -.BR ELOOP , -.BR ENOENT , -.BR ENOTDIR , -.BR EPERM , -.BR EROFS , -.BR ETXTBSY -.SH BUGS -No accounting is produced for programs running -when a crash occurs. -In particular nonterminating programs are never -accounted for. diff --git a/static/v10/man2/alarm.2 b/static/v10/man2/alarm.2 deleted file mode 100644 index 62d16a42..00000000 --- a/static/v10/man2/alarm.2 +++ /dev/null @@ -1,83 +0,0 @@ -.TH ALARM 2 -.CT 2 time_man -.SH NAME -alarm, nap, pause \(mi schedule timing delays -.SH SYNOPSIS -.nf -.B unsigned alarm(seconds) -.B unsigned seconds; -.PP -.B void nap(ticks) -.PP -.B void pause() -.fi -.SH DESCRIPTION -.I Alarm -causes signal -.BR SIGALRM , -see -.IR signal (2), -to be sent to the invoking process -in the number of seconds given by the argument. -Unless caught or ignored, the signal terminates the process. -.PP -Alarm requests are not stacked; -successive calls reset the alarm clock. -If the argument is 0, -any alarm request is canceled. -Because the clock has a one second resolution, -the signal may occur up to one second early; -because of scheduling delays, -resumption of execution of when the signal is -caught may be delayed an arbitrary amount. -.PP -The return value is the amount of time -previously remaining in the alarm clock. -.PP -.I Nap -suspends execution of -the current process -for -the specified number of clock ticks. -If -.I ticks -is negative, -it is taken to be zero; -if it is greater than two seconds, -it is taken to be two seconds. -.PP -.I Pause -only returns upon termination of a signal handler started during the -.IR pause . -It is used to give up control while waiting for -a signal, -usually from -.I kill -(see -.IR signal (2)), -.IR alarm (2), -or the terminal driver -.IR ttyld (4). -.SH "SEE ALSO" -.IR kill (1), -.IR signal (2), -.IR setjmp (3), -.IR sleep (3) -.SH BUGS -If the argument to -.I alarm -is greater than 65535, -it is treated as 65535. -.br -If the alarm clock expires -during a call to -.IR alarm , -the return value will be 0, -and the signal will be delivered -immediately after the system call returns. -If the routine calling -.I alarm -saves the return value -and later restores it, -it will disable any alarm -set by the signal handler. diff --git a/static/v10/man2/back.2 b/static/v10/man2/back.2 deleted file mode 100644 index d531d7f8..00000000 --- a/static/v10/man2/back.2 +++ /dev/null @@ -1 +0,0 @@ -../../../tst/back.c:134: warning: unsigned operand of unary - diff --git a/static/v10/man2/boot.2 b/static/v10/man2/boot.2 deleted file mode 100644 index 9e936432..00000000 --- a/static/v10/man2/boot.2 +++ /dev/null @@ -1,27 +0,0 @@ -.pa 1 -.he 'BOOT (II)'7/29/72'BOOT (II)' -.ti 0 -NAME boot -- reboot UNIX -.sp -.ti 0 -SYNOPSIS sys boot / boot = 39. not in assembler -.sp -.ti 0 -DESCRIPTION UNIX -will clean up outstanding I\/O, and then execute -the reboot read-only program. -This call is restricted to the super-user. -All users will be logged out. -.sp -.ti 0 -SEE ALSO boot procedures (VII) -.sp -.ti 0 -DIAGNOSTICS the c-bit is set if you are -not the super-user -.sp -.ti 0 -BUGS It -often doesn't work (for unknown reasons). -.br -It depends on switch settings. diff --git a/static/v10/man2/break.2 b/static/v10/man2/break.2 deleted file mode 100644 index a8382637..00000000 --- a/static/v10/man2/break.2 +++ /dev/null @@ -1,34 +0,0 @@ -.pa 1 -.he 'BREAK (II)'3/15/72'BREAK (II)' -.ti 0 -NAME break -- set program break -.sp -.ti 0 -SYNOPSIS sys break; addr / break = 17. -.sp -.ti 0 -DESCRIPTION break_____ -sets the system's idea of the highest location used by the program -to addr____. Locations greater than addr____ and below the stack pointer -are not swapped and are thus liable to unexpected modification. -.sp -An argument of 0 is taken to mean 16K bytes. -If the argument is higher than the stack pointer the -entire user core area is swapped. -.sp -When a program begins execution via exec____ -the break is set at the -highest location defined by the program -and data storage areas. -Ordinarily, therefore, only programs with growing -data areas need to use break_____. -.sp -.ti 0 -SEE ALSO exec(II) -.sp -.ti 0 -DIAGNOSTICS none; strange addresses cause the break to be -set at 16K bytes. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/brk.2 b/static/v10/man2/brk.2 deleted file mode 100644 index 08227924..00000000 --- a/static/v10/man2/brk.2 +++ /dev/null @@ -1,52 +0,0 @@ -.TH BRK 2 -.CT 2 mem_man -.SH NAME -brk, sbrk \(mi change core allocation -.SH SYNOPSIS -.nf -.B int brk(addr) -.B char *addr; -.PP -.B char *sbrk(incr) -.fi -.SH DESCRIPTION -.I Brk -sets the system's idea of the lowest location not used by the program -(called the break) -to -.I addr -rounded up to the next multiple of 1024 bytes. -Locations not less than -.I addr -and below the stack pointer -may cause a memory violation if accessed. -.PP -In the alternate function -.I sbrk, -.I incr -more bytes are added to the -program's data space and a pointer to the -start of the new area is returned. -Rounding occurs as with -.I brk, -but a nominal break is remembered, so rounding does not accumulate. -.PP -When a program begins execution via -.I exec -the break is set at the -highest location defined by the program -and data storage areas. -Ordinarily, therefore, only programs with growing -data areas need to use -.IR brk . -.PP -The error return from -.I sbrk -is -.BR "(char *)-1" . -.SH "SEE ALSO" -.IR exec (2), -.IR end (3), -.IR malloc (3) -.SH DIAGNOSTICS -.B ENOMEM diff --git a/static/v10/man2/cemt.2 b/static/v10/man2/cemt.2 deleted file mode 100644 index 4d03c41a..00000000 --- a/static/v10/man2/cemt.2 +++ /dev/null @@ -1,30 +0,0 @@ -.pa 1 -.he 'CEMT (II)'9/4/72'CEMT (II)' -.ti 0 -NAME cemt -- catch emt traps -.sp -.ti 0 -.nf -SYNOPSIS sys cemt; arg / cemt = 29. -.fi -.sp -.ti 0 -DESCRIPTION This call -allows one to catch traps resulting from -the emt___ instruction. -Arg___ is a location within the program; emt___ traps -are sent to that location. -The normal effect of emt___ traps may be restored by giving -an arg___ equal to 0. -.sp -To return after catching the emt___ -trap, execute the rti___ instruction. -.sp -.ti 0 -SEE ALSO -- -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/chdir.2 b/static/v10/man2/chdir.2 deleted file mode 100644 index 04beefc4..00000000 --- a/static/v10/man2/chdir.2 +++ /dev/null @@ -1,24 +0,0 @@ -.pa 1 -.he 'CHDIR (II)'3/15/72'CHDIR (II)' -.ti 0 -NAME chdir -- change working directory -.sp -.ti 0 -SYNOPSIS sys chdir; dirname / chdir = 12. -.sp -.ti 0 -DESCRIPTION dirname_______ -is the address of the pathname of a directory, terminated by a 0 byte. -chdir_____ causes this directory -to become the current working directory. -.sp -.ti 0 -SEE ALSO chdir(I) -.sp -.ti 0 -DIAGNOSTICS The error bit (c-bit) -is set if the given name is not that of a directory -or is not readable. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/chmod.2 b/static/v10/man2/chmod.2 deleted file mode 100644 index 7727cb5e..00000000 --- a/static/v10/man2/chmod.2 +++ /dev/null @@ -1,61 +0,0 @@ -.TH CHMOD 2 -.CT 2 file_inq_creat dirs secur -.SH NAME -chmod, fchmod \(mi change mode of file -.SH SYNOPSIS -.nf -.B int chmod(name, mode) -.B char *name; -.PP -.B int fchmod(fd, mode) -.fi -.SH DESCRIPTION -.I Chmod -changes the permissions and other mode bits of the file specified -by the null-terminated string -.I name -to -.IR mode . -.I Fchmod -changes the mode bits of an open file referred -to by a file descriptor. -The modes are defined in -.IR stat (2). -Only the -.B 07777 -bits of -.IR mode -are significant. -.PP -The userid of the process must be -the super-user or the owner of the file. -.PP -Set-groupid mode, -.BR S_ISGID , -is turned off unless the process is super-user -or has the same groupid as the file. -.PP -Blind mode, -.BR S_IBLIND , -cannot be changed unless the process has capability -.BR T_EXTERN ; -see -.IR mkdir(2) -and -.IR getplab (2). -.SH "SEE ALSO" -.IR chmod (1) -.SH DIAGNOSTICS -.BR EBADF , -.BR EFAULT , -.BR EIO , -.BR ELAB , -.BR ELOOP , -.BR ENOENT , -.BR ENOTDIR , -.BR EPERM , -.BR EPRIV -.SH BUGS -An attempt to change the mode of -a file on a read-only file system -is quietly ignored. diff --git a/static/v10/man2/chown.2 b/static/v10/man2/chown.2 deleted file mode 100644 index 68b7ed52..00000000 --- a/static/v10/man2/chown.2 +++ /dev/null @@ -1,71 +0,0 @@ -.TH CHOWN 2 -.CT 2 file_inq_creat dirs secur -.SH NAME -chown, fchown \(mi change owner and group of a file -.SH SYNOPSIS -.nf -.B int chown(name, owner, group) -.B char *name; -.PP -.B int fchown(fd, owner, group) -.fi -.SH DESCRIPTION -.I Chown -changes the -.I owner -and -.I group -of the file specified by the null-terminated string -.IR name . -.I Fchown -changes the owner and group of an open file -specified by file descriptor. -Only the super-user may -change the userid of a file. -The owner of a file -may change its groupid -to match the current effective groupid; -any other changes -are restricted to the super-user. -If the file has either -set-userid or set-groupid permission (see -.IR stat (2)) -neither the userid or groupid may be changed. -.SH EXAMPLES -The following sequence, executed by a superuser process with -.BR T_NOCHK -and -.B T_SETPRIV -capabilities, will change the owner of any file, regardless of -privileges and set-id modes -(less Herculean methods usually suffice). -The sequence is illustrative only: it ignores the -possiblility of the file being altered by a hostile superuser -while the file is unprivileged. -Sound security procedures might require the various steps to be done by -different persons, with interspersed vetting similar to that described in -.IR setpriv (8). -.IP -.EX -getflab(file, &savlab); -setflab(file, &nopriv); -stat(file, &savmod); -chmod(file, 0); -chown(file, uid, gid); -chmod(file, savmod.s_mode); -setflab(file, &savlab); -.EE -.SH "SEE ALSO" -.IR chown (8), -.IR chmod (2), -.IR passwd (5) -.SH DIAGNOSTICS -.BR EACCES , -.BR EBADF , -.BR EFAULT , -.BR EIO , -.BR ELAB , -.BR ELOOP , -.BR ENOENT , -.BR ENOTDIR , -.BR EPERM diff --git a/static/v10/man2/close.2 b/static/v10/man2/close.2 deleted file mode 100644 index b5d74fbd..00000000 --- a/static/v10/man2/close.2 +++ /dev/null @@ -1,27 +0,0 @@ -.pa 1 -.he 'CLOSE (II)'3/15/72'CLOSE (II)' -.ti 0 -NAME close -- close a file -.sp -.ti 0 -SYNOPSIS (file descriptor in r0) -.br -sys close / close = 6. -.sp -.ti 0 -DESCRIPTION Given -a file descriptor such as returned from an open or creat call, -close_____ closes the associated file. -A close of all files is automatic on exit, but since -processes are limited to 10 simultaneously open files, -close_____ is necessary for programs which deal with many files. -.sp -.ti 0 -SEE ALSO creat(II), open(II) -.sp -.ti 0 -DIAGNOSTICS The error bit -(c-bit) is set for an unknown file descriptor. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/cq.2 b/static/v10/man2/cq.2 deleted file mode 100644 index 79358604..00000000 --- a/static/v10/man2/cq.2 +++ /dev/null @@ -1,10 +0,0 @@ -../../../tst/cq.c:395: warning: overflow in constant `4294967296' -../../../tst/cq.c:395: warning: overflow in constant `040000000000' -../../../tst/cq.c:395: warning: overflow in constant `0x100000000' -../../../tst/cq.c:396: warning: overflow in constant `68719476735' -../../../tst/cq.c:396: warning: overflow in constant `0777777777777' -../../../tst/cq.c:396: warning: overflow in constant `0xfffffffff' -../../../tst/cq.c:397: warning: overflow in constant `68719476736' -../../../tst/cq.c:397: warning: overflow in constant `01000000000000' -../../../tst/cq.c:397: warning: overflow in constant `0x1000000000' -../../../tst/cq.c:5295: warning: unreachable code diff --git a/static/v10/man2/creat.2 b/static/v10/man2/creat.2 deleted file mode 100644 index 063d7c24..00000000 --- a/static/v10/man2/creat.2 +++ /dev/null @@ -1,74 +0,0 @@ -.TH CREAT 2 -.CT 2 file_inq_creat -.SH NAME -creat, bcreat \(mi create a new file -.SH SYNOPSIS -.nf -.B int creat(name, mode) -.B char *name; -.PP -.B int bcreat(name, mode, name2) -.B char *name, name2[14]; -.fi -.SH DESCRIPTION -.I Creat -creates a new file or prepares to rewrite an existing -file called -.I name, -given as the address of a null-terminated string. -If the file is new, its inode is initialized as follows. -The owner of the file is the effective userid of the creating process. -The group of the file is the group of the containing directory. -The mode of the file is -.IR mode , -as modified by the process's mode mask; see -.IR umask (2). -Setgid is turned off if the effective groupid of -the process differs from the groupid of the file. -See -.IR stat (2) -for the encoding of modes. -.PP -If the file did exist, its mode and owner remain unchanged. -The file is truncated to 0 length unless it is append-only; see -.IR stat (2). -.PP -The file is opened for writing, and its file descriptor -is returned. -.PP -The -.I mode -given is arbitrary; it need not allow -writing. -This feature is used by programs which deal with temporary -files of fixed names. -The file is created with -a mode that forbids writing. -Then if a second -instance of the program attempts a -.I creat, -an error is -returned and the program knows that the name is unusable -for the moment. -.PP -.I Bcreat -performs the function of -.I creat, -and then, if successful, copies the last component of the actual -pathname of the created file as a NUL-padded string into -.I name2. -It is intended for use with blind directories, where new -entries are created under random names; see -.IR mkdir (2). -.PP -It is not possible to create or open for writing -a file with set-userid or set-groupid permission; see -.IR stat (2). -.SH "SEE ALSO" -.IR chmod (2), -.IR close (2), -.IR umask (2), -.IR write (2) -.SH DIAGNOSTICS -.L -EACCES, EBADF, EBUSY, EFAULT, EIO, EISDIR, ELAB, ELOOP, EMFILE, ENFILE, ENOENT, ENOTDIR, EROFS, ETXTBSY diff --git a/static/v10/man2/csw.2 b/static/v10/man2/csw.2 deleted file mode 100644 index d8f1cf50..00000000 --- a/static/v10/man2/csw.2 +++ /dev/null @@ -1,29 +0,0 @@ -.pa 1 -.he 'CSW (II)'7/29/72'CSW (II)' -.ti 0 -NAME csw -- read console switches -.sp -.ti 0 -SYNOPSIS sys csw / csw = 38. not in assembler -.br -(value of csw in r0) -.br -(value of buttons in r1) -.sp -.ti 0 -DESCRIPTION The setting of -the console switches is returned in r0. -The setting of the -external buttons is returned in r1. -.a -The return is synced to -a 30 CPS clock for graphical applications. -.sp -.ti 0 -SEE ALSO -- -.sp -.ti 0 -DIAGNOSTICS none -.sp -.ti 0 -BUGS Currently the buttons are unavailable. diff --git a/static/v10/man2/deprecated.2 b/static/v10/man2/deprecated.2 deleted file mode 100644 index a063c461..00000000 --- a/static/v10/man2/deprecated.2 +++ /dev/null @@ -1,84 +0,0 @@ -.TH DEPRECATED 2 -.CT 2 misc -.SH NAME -reboot, vadvise, vlimit, vswapon, getgroups, -setgroups \(mi system calls to be avoided -.SH SYNOPSIS -.nf -.B int reboot(how) -.PP -.B int vadvise(how) -.PP -.B int vlimit(what, limit) -.PP -.B int vswapon(special) -.B char *special; -.PP -.B #include <sys/param.h> -.PP -.B int getgroups(ngroups, gidset) -.B short *gidset; -.PP -.B setgroups(ngroups, gidset) -.B short *gidset; -.fi -.SH DESCRIPTION -These calls are hangovers from prior versions of the system. -Some exist only for system maintenance purposes; -some depend on the virtual memory implementation. -None should be used except as a last resort. -Most are not included in -.BR /lib/libc.a . -.PP -.I Reboot -finishes any pending I/O -and reboots the system -(if -.I how -is 0) -or puts the system into a tight loop with interrupts disabled -(if -.I how -is 8). -It is restricted to the super-user. -.PP -.I Vadvise -gives the virtual memory system -hints about the paging behavior -of the current process. -.PP -.I Vlimit -sets various resource limits, -such as the amount of memory allowed for text and data, -and the maximum size of core images. -.PP -.I Vswapon -adds -the block device -.I special -to the pool of swap space. -The device must be listed in a table -compiled into the operating system; -.I vswapon -merely enables it. -.PP -.I Getgroups -stores at most -.I ngroups -elements of the group access list of the current process -in the array -.IR gidset . -.PP -.I Setgroups -sets the group access list of the current user process from -.IR gidset . -.I Ngroups -gives the number of entries; it must not exceed -.BR NGROUPS , -defined in -.BR <param.h> . -Only the super-user may add groups to the list. -.SH SEE ALSO -.I -Unix Programmer's Manual, Seventh Edition, Virtual VAX-11 Version, -Volume 1, 1980 (Berkeley) diff --git a/static/v10/man2/dirread.2 b/static/v10/man2/dirread.2 deleted file mode 100644 index 8533bb9f..00000000 --- a/static/v10/man2/dirread.2 +++ /dev/null @@ -1,63 +0,0 @@ -.TH DIRREAD 2 -.CT 2 file_io dirs -.SH NAME -dirread \(mi read from directory, hiding format -.SH SYNOPSIS -.nf -.B int dirread(fildes, buffer, nbytes) -.B char *buffer; -.fi -.SH DESCRIPTION -.I Dirread -reads at most -.I nbytes -bytes of directory information -from the file pointer location -in the directory associated with -.I fildes -into memory at -.IR buffer . -The information is converted into a canonical form, -independent of the format used by the file system in which -the directory resides. -.PP -Each canonicalized entry consists of a decimal ASCII inode number, -a tab character, -a file name, -and an ASCII NUL. -.I Buffer -is filled with as many entries -as will fit; -the number of bytes used is returned. -0 is returned when there are no more entries. -.PP -The file pointer is advanced by -the number of bytes passed over in the directory, -not the number of bytes placed in -.IR buffer . -Ask -.I lseek -for the new pointer; -don't try to compute it. -.SH "SEE ALSO" -.IR open (2), -.IR read (2), -.IR directory (3), -.IR dir (5) -.SH DIAGNOSTICS -.BR EBADF , -.BR ENOSPC -(buffer too small), -.BR ENOTDIR , -.BR EFAULT , -.B EINVAL -.SH BUGS -Not all file system types -support -.IR dirread . -The routines in -.IR directory (3) -know how to cope. -.br -Seeking in directories is dangerous, -because the contents often change under foot. diff --git a/static/v10/man2/dup.2 b/static/v10/man2/dup.2 deleted file mode 100644 index e8c7c8b2..00000000 --- a/static/v10/man2/dup.2 +++ /dev/null @@ -1,54 +0,0 @@ -.pa 1 -.he 'DUP (II)'1/15/73'DUP (II)' -.ti 0 -NAME dup -- duplicate an open file descriptor -.sp -.ti 0 -SYNOPSIS (file descriptor in r0) -.br -sys dup / dup = 41.; not in assembler -.br -(file descriptor in r0) -.sp -.ti 0 -DESCRIPTION Given -a file descriptor returned from -an open or creat call, -dup___ -will allocate another file descriptor -synonymous -with -the original. -The new file descriptor is returned in r0. -.sp -Dup___ -is used more to manipulate the value -of file descriptors -than to genuinely -duplicate a file descriptor. -Since the algorithm to allocate -file descriptors -is known to use the -lowest available -value between 0 and 9, -combinations of dup___ -and close_____ can be -used to -manipulate file descriptors -in a general way. -This is handy for -manipulating standard input and/or -standard output. -.sp -.ti 0 -SEE ALSO creat(II), open(II), close(II) -.sp -.ti 0 -DIAGNOSTICS The -error bit (c-bit) -is set if: -the given file descriptor is invalid; -there are already 10 open files. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/exec.2 b/static/v10/man2/exec.2 deleted file mode 100644 index 7c1d013f..00000000 --- a/static/v10/man2/exec.2 +++ /dev/null @@ -1,288 +0,0 @@ -.TH EXEC 2 -.CT 2 proc_man -.SH NAME -execl, execv, execle, execve, execlp, execvp, exect, environ \(mi execute a file -.SH SYNOPSIS -.nf -.B int "execl(name, arg0, arg1, ..., argn, (char *)0)" -.B char *name, *arg0, *arg1, ..., *argn; -.PP -.B int execv(name, argv) -.B char *name, *argv[]; -.PP -.B "int execle(name, arg0, arg1, ..., argn, (char *)0, envp)" -.B "char *name, *arg0, *arg1, ..., *argn, *envp[];" -.PP -.B int execve(name, argv, envp) -.B char *name, *argv[], *envp[]; -.PP -.B int "execlp(name, arg0, arg1, ..., argn, (char *)0)" -.B char *name, *arg0, *arg1, ..., *argn; -.PP -.B int execvp(name, argv) -.B char *name, *argv[]; -.PP -.B int exect(name, argv, envp) -.B char *name, *argv[], *envp[]; -.PP -.B extern char **environ; -.fi -.SH DESCRIPTION -.I Exec -in all its forms -overlays the calling process with the named file, then -transfers to the -entry point of the image of the file. -There can be no return from a successful -.IR exec ; -the calling image is lost. -.PP -Files remain open across -.I exec -unless explicit arrangement has been made; -see -.IR ioctl (2). -Signals that are caught (see -.IR signal (2)) -are reset -to their default values. -Other signals' behavior is unchanged. -.PP -Each user has a -.I real -userid and groupid and an -.I effective -userid and groupid. -The real userid (groupid) -identifies the person using the system; -the effective userid (groupid) -determines access privileges. -.I Exec -changes the effective userid and groupid to -the owner of the executed file if the file has the set-userid -or set-groupid modes. -The real userid is not affected. -.PP -The security label (see -.IR getflab (2)) -of the process is set as follows. -If any arguments or environment parameters are present, -or if and file descriptor numbers greater than 3 are in use, -the lattice value of the process label -is ascribed to them, otherwise lattice bottom. -This value is ORed with the lattice value of -the executed file to obtain the new lattice value for the process. -If the new lattice value does not dominate the old,ÃÂ -the permission mask (see -.IR umask (2)) -is set to 022. -.PP -Process licenses persist. -In the simplest case, the process obtains from the -file the capabilities -for which the process has licenses; see -.IR getplab (2). -The detailed computation for process capabilities is: -Nominal capabilities are determined -by ANDing the file capabilities with the -capabilities in the file system ceiling (see -.IR mount (2)) -and then ORing with built-in minima. -Nominal licenses are determined by ANDing the file licenses -with the licenses in the file system -ceiling and with built-in maxima. -Process capabilities are set by ORing the -process licenses with the nominal licenses, then ANDing -with the nominal capabilities. -.PP -The builtin minimum file capabilities are all 0. -The builtin maximum file licenses for -.B T_SETPRIV -and -.B T_LOG -are 0; the rest are 1. -.B -.PP -The -.I name -argument -is a pointer to the name of the file -to be executed. -If the first two bytes of that file are the ASCII -characters -.LR #! , -then the first line of the file is taken to be ASCII and -determines the name of the program to execute. -The first nonblank string following -.L #! -in that line is substituted for -.I name. -Any second string, separated from the first by blanks or tabs, -is inserted between -the first two arguments (arguments 0 and 1) passed to the invoked file. -.PP -The argument pointers -.I arg0, arg1, ... -or the pointers in -.I argv -address null-terminated strings. -Conventionally argument 0 -is the name of the -file. -.PP -.I Execl -is useful when a known file with known arguments is -being called; -the arguments to -.I execl -are the character strings -constituting the file and the arguments. -.PP -.I Execv -is useful when the number of arguments is unknown -in advance; -the arguments to -.I execv -are the name of the file to be -executed and a vector of strings containing -the arguments. -The last argument string must be followed -by a 0 -pointer. -.PP -When a C program is executed, -it is called as follows: -.IP -.EX -main(argc, argv, envp) -int argc; -char **argv, **envp; -.EE -.PP -where -.IR argc "" -is the argument count -and -.IR argv "" -is an array of character pointers -to the arguments themselves. -Conventionally -.I argc -is at least 1 -and -.B argv[0] -points to -the name of the file. -.PP -.I Argv -is directly usable in another -.I execv -because -.BR argv[argc]==0 . -.PP -.I Envp -is a pointer to an array of strings that constitute -the -.I environment -of the process. -Each string conventionally consists of a name, an -.LR = , -and a null-terminated value; -or a name, a pair of parentheses -.LR (), -a value bracketed by -.L { -and -.LR } , -and a null character. -The array of pointers is terminated by a null pointer. -The shell -.IR sh (1) -passes an environment entry for each global shell variable -defined when the program is called. -See -.IR environ (5) -for some conventionally -used names. -.PP -The C run-time start-off routine places a copy of -.I envp -in the global cell -.I environ, -which is used -by -.I execv -and -.I execl -to pass the environment to any subprograms executed by the -current program. -The -.I exec -routines use lower-level routines as follows -to pass an environment explicitly: -.IP -.nf -\fLexecve(file, argv, environ); -execle(file, arg0, arg1, . . . , argn, (char *)0, environ);\fP -.fi -.PP -.I Execlp -and -.I execvp -are called with the same arguments as -.I execl -and -.I execv, -but duplicate the shell's actions in searching for an executable -file in a list of directories given in the -.B PATH -environment variable. -.PP -.I Exect -is the same as -.I execve, -except it arranges for a stop to occur on the first instruction -of the new core image for the benefit of tracers, see -.IR proc (4). -.SH FILES -.TF /bin/sh -.TP -.F /bin/sh -shell, invoked if command file found -by -.I execlp -or -.I execvp -.SH "SEE ALSO" -.IR fork (2), -.IR environ (5) -.SH DIAGNOSTICS -.BR E2BIG , -.BR EACCES , -.BR EFAULT , -.BR EIO , -.BR ELAB , -.BR ELOOP , -.BR ENOENT , -.BR ENOEXEC , -.BR ENOMEM , -.BR ENOTDIR , -.BR ENXIO , -.BR EROFS , -.BR ETXTBSY -.SH BUGS -If -.I execvp -is called to execute a file that turns out to be a shell -command file, -and if it is impossible to execute the shell, -some of the values in -.I argv -may be modified before return. -.br -The path search of -.I execlp -and -.I execvp -does not extend to names substituted by -.LR #! . diff --git a/static/v10/man2/exit.2 b/static/v10/man2/exit.2 deleted file mode 100644 index f0013c49..00000000 --- a/static/v10/man2/exit.2 +++ /dev/null @@ -1,126 +0,0 @@ -.TH EXIT 2 -.CT 2 time_man proc_man -.SH NAME -_exit, wait wait3 \(mi terminate process, wait for child to terminate -.SH SYNOPSIS -.nf -.B void _exit(status) -.B int status; -.PP -.B int wait(status) -.B int *status; -.PP -.B int wait((int *)0) -.PP -.B #include <sys/vtimes.h> -.PP -.B wait3(status, options, ch_vt) -.B int *status; -.B struct vtimes *ch_vt; -.fi -.SH DESCRIPTION -.I _exit -closes all the process's files and notifies the parent process -when the parent executes -.IR wait . -The low-order 8 bits of -.I status -are available to the parent process. -The call never returns. -.PP -The function -.IR exit (3), -which is the normal means of terminating a process, -may cause cleanup actions before finally calling -.IR _exit . -Therefore, -.I _exit -should be called to terminate a child -process after a -.IR fork (2) -to avoid flushing buffered output twice. -.PP -.I Wait -delays until a signal is received or until -a child processes terminates or receives signal -.BR SIGSTOP . -There is no delay if any child has died since the last -.I wait, -or if there are no extant children. -The normal return yields the process id -and status of one terminated child. -The status of other children -may be learned from further -.I wait -calls. -.PP -If -.I status -is nonzero, -.I wait -sets -.IR \f5*\fPstatus " = (" s <<8)+ t -where -.I s -is the low 8 bits -of -.I status -from the child's -.IR exit , -if any, -and -.I t -is the termination status of the child. -If the security label of the waiting process does not -dominate that of the exiting process, then nonzero -.BR * status -is always reported as -.BR SIGTERM . -See -.IR signal (2) -for a list of termination statuses (signals); -status 0 indicates normal termination, 0177 -a (restartable) process stopped on -.BR SIGSTOP . -If the 0200 -bit of the termination status -is set, -a core image of the process was produced -by the system. -.PP -.I Wait3 -is similar to -.I wait. -An -.I option -value of 1 prevents waiting for extant, non-stopped children. -If -.I ch_vt -is nonzero, resource usage data for the child are reported -as by -.IR vtimes (2). -.PP -If the parent process terminates without -waiting on its children, -they are inherited by -process 1 -(the initialization process, -.IR init (8)). -.SH "SEE ALSO" -.IR fork (2), -.IR exit (3), -.IR signal (2), -.IR sh (1) -.SH DIAGNOSTICS -.IR wait , -.IR wait3 : -.B ECHILD -.SH BUGS -If the argument to -.I wait -is bogus, the user program gets a memory fault rather than an -.BR EFAULT . -.br -The 0 third argument to -.I wait3 -is a required historical dreg. diff --git a/static/v10/man2/f2c.2 b/static/v10/man2/f2c.2 deleted file mode 100644 index 1e347e2d..00000000 --- a/static/v10/man2/f2c.2 +++ /dev/null @@ -1,333 +0,0 @@ -. \" Definitions of F, L and LR for the benefit of systems -. \" whose -man lacks them... -.de F -.nh -.if n \%\&\\$1 -.if t \%\&\f(CW\\$1\fR -.hy 14 -.. -.de L -.nh -.if n \%`\\$1' -.if t \%\&\f(CW\\$1\fR -.hy 14 -.. -.de LR -.nh -.if n \%`\\$1'\\$2 -.if t \%\&\f(CW\\$1\fR\\$2 -.hy 14 -.. -.TH F2C 1 -.CT 1 prog_other -.SH NAME -f\^2c \(mi Convert Fortran 77 to C or C++ -.SH SYNOPSIS -.B f\^2c -[ -.I option ... -] -.I file ... -.SH DESCRIPTION -.I F2c -converts Fortran 77 source code in -.I files -with names ending in -.L .f -or -.L .F -to C (or C++) source files in the -current directory, with -.L .c -substituted -for the final -.L .f -or -.LR .F . -If no Fortran files are named, -.I f\^2c -reads Fortran from standard input and -writes C on standard output. -.I File -names that end with -.L .p -or -.L .P -are taken to be prototype -files, as produced by option -.LR -P , -and are read first. -.PP -The following options have the same meaning as in -.IR f\^77 (1). -.TP -.B -C -Compile code to check that subscripts are within declared array bounds. -.TP -.B -I2 -Render INTEGER and LOGICAL as short, -INTEGER\(**4 as long int. Assume the default \fIlibF77\fR -and \fIlibI77\fR: allow only INTEGER\(**4 (and no LOGICAL) -variables in INQUIREs. Option -.L -I4 -confirms the default rendering of INTEGER as long int. -.TP -.B -onetrip -Compile DO loops that are performed at least once if reached. -(Fortran 77 DO loops are not performed at all if the upper limit is smaller than the lower limit.) -.TP -.B -U -Honor the case of variable and external names. Fortran keywords must be in -.I -lower -case. -.TP -.B -u -Make the default type of a variable `undefined' rather than using the default Fortran rules. -.TP -.B -w -Suppress all warning messages. -If the option is -.LR -w66 , -only Fortran 66 compatibility warnings are suppressed. -.PP -The following options are peculiar to -.IR f\^2c . -.TP -.B -A -Produce -.SM ANSI -C. -Default is old-style C. -.TP -.B -a -Make local variables automatic rather than static -unless they appear in a -.SM "DATA, EQUIVALENCE, NAMELIST," -or -.SM SAVE -statement. -.TP -.B -C++ -Output C++ code. -.TP -.B -c -Include original Fortran source as comments. -.TP -.B -E -Declare uninitialized -.SM COMMON -to be -.B Extern -(overridably defined in -.F f2c.h -as -.B extern). -.TP -.B -ec -Place uninitialized -.SM COMMON -blocks in separate files: -.B COMMON /ABC/ -appears in file -.BR abc_com.c . -Option -.LR -e1c -bundles the separate files -into the output file, with comments that give an unbundling -.IR sed (1) -script. -.TP -.B -ext -Complain about -.IR f\^77 (1) -extensions. -.TP -.B -f -Assume free-format input: accept text after column 72 and do not -pad lines shorter than 72 characters with blanks. -.TP -.B -72 -Treat text appearing after column 72 as an error. -.TP -.B -g -Include original Fortran line numbers in \f(CW#line\fR lines. -.TP -.B -h -Try to align character strings on word (or, if the option is -.LR -hd , -on double-word) boundaries. -.TP -.B -i2 -Similar to -.BR -I2 , -but assume a modified -.I libF77 -and -.I libI77 -(compiled with -.BR -Df\^2c_i2 ), -so -.SM INTEGER -and -.SM LOGICAL -variables may be assigned by -.SM INQUIRE -and array lengths are stored in short ints. -.TP -.B -kr -Use temporary values to enforce Fortran expression evaluation -where K&R (first edition) parenthesization rules allow rearrangement. -If the option is -.LR -krd , -use double precision temporaries even for single-precision operands. -.TP -.B -P -Write a -.IB file .P -of ANSI (or C++) prototypes -for procedures defined in each input -.IB file .f -or -.IB file .F . -When reading Fortran from standard input, write prototypes -at the beginning of standard output. -Implies -.B -A -unless option -.L -C++ -is present. Option -.B -Ps -implies -.B -P , -and gives exit status 4 if rerunning -.I f\^2c -may change prototypes or declarations. -.TP -.B -p -Supply preprocessor definitions to make common-block members -look like local variables. -.TP -.B -R -Do not promote -.SM REAL -functions and operations to -.SM DOUBLE PRECISION. -Option -.L -!R -confirms the default, which imitates -.IR f\^77 . -.TP -.B -r -Cast values of REAL functions (including intrinsics) to REAL. -.TP -.B -r8 -Promote -.SM REAL -to -.SM DOUBLE PRECISION, COMPLEX -to -.SM DOUBLE COMPLEX. -.TP -.BI -T dir -Put temporary files in directory -.I dir. -.TP -.B -w8 -Suppress warnings when -.SM COMMON -or -.SM EQUIVALENCE -forces odd-word alignment of doubles. -.TP -.BI -W n -Assume -.I n -characters/word (default 4) -when initializing numeric variables with character data. -.TP -.B -z -Do not implicitly recognize -.SM DOUBLE COMPLEX. -.TP -.B -!bs -Do not recognize \fIb\fRack\fIs\fRlash escapes -(\e", \e', \e0, \e\e, \eb, \ef, \en, \er, \et, \ev) in character strings. -.TP -.B -!c -Inhibit C output, but produce -.B -P -output. -.TP -.B -!I -Reject -.B include -statements. -.TP -.B -!it -Don't infer types of untyped -.SM EXTERNAL -procedures from use as parameters to previously defined or prototyped -procedures. -.TP -.B -!P -Do not attempt to infer -.SM ANSI -or C++ -prototypes from usage. -.PP -The resulting C invokes the support routines of -.IR f\^77 ; -object code should be loaded by -.I f\^77 -or with -.IR ld (1) -or -.IR cc (1) -options -.BR "-lF77 -lI77 -lm" . -Calling conventions -are those of -.IR f\&77 : -see the reference below. -.br -.SH FILES -.TP -.IB file .[fF] -input file -.TP -.B *.c -output file -.TP -.F /usr/include/f2c.h -header file -.TP -.F /usr/lib/libF77.a -intrinsic function library -.TP -.F /usr/lib/libI77.a -Fortran I/O library -.TP -.F /lib/libc.a -C library, see section 3 -.SH "SEE ALSO" -S. I. Feldman and -P. J. Weinberger, -`A Portable Fortran 77 Compiler', -\fIUNIX Time Sharing System Programmer's Manual\fR, -Tenth Edition, Volume 2, AT&T Bell Laboratories, 1990. -.SH DIAGNOSTICS -The diagnostics produced by -.I f\^2c -are intended to be -self-explanatory. -.SH BUGS -Floating-point constant expressions are simplified in -the floating-point arithmetic of the machine running -.IR f\^2c , -so they are typically accurate to at most 16 or 17 decimal places. -.br -Untypable -.SM EXTERNAL -functions are declared -.BR int . diff --git a/static/v10/man2/fields.2 b/static/v10/man2/fields.2 deleted file mode 100644 index fc129e0c..00000000 --- a/static/v10/man2/fields.2 +++ /dev/null @@ -1,2 +0,0 @@ -../../../tst/fields.c:6: warning: initializer exceeds bit-field width -../../../tst/fields.c:8: warning: initializer exceeds bit-field width diff --git a/static/v10/man2/fmount.2 b/static/v10/man2/fmount.2 deleted file mode 100644 index f9da4be2..00000000 --- a/static/v10/man2/fmount.2 +++ /dev/null @@ -1,149 +0,0 @@ -.TH FMOUNT 2 -.CT 2 sa -.SH NAME -fmount, funmount \- mount or remove file system -.SH SYNOPSIS -.nf -.B int fmount(type, fildes, name, flag) -.B char *name; -.PP -.B int funmount(name) -.B char *name; -.PP -.B #include <sys/label.h> -.PP -.B int fmount5(type, fildes, name, flag, ceiling) -.B char *name; -.B struct label *ceiling; -.fi -.SH DESCRIPTION -.I Fmount -mounts a file system of the named -.I type -described by the file descriptor -.I fildes -on pathname -.IR name . -The ceiling label, described under -.I fmount5, -is given a default value. -Henceforth, -references to -.I name -(the mount point) -will refer to the root file -on the newly mounted file system. -.PP -.I Name -must already exist. -Its old contents are inaccessible while the -file system is mounted. -.PP -The meaning of -.I flag -varies with the file system type. -.PP -Allowed types are -.TP -.B 0 -Regular (block device) file system. -.I Fildes -should be a block special file. -If -.I flag -is nonzero, -the file system may not be written on; -this must be used with physically write-protected media -or errors will occur when access times are updated, -even if no explicit write is attempted. -The default ceiling label is lattice top with all privileges. -.TP -.B 1 -Obsolete version of the -network file system. -.TP -.B 2 -Process file system, -.IR proc (4). -.I Fildes -is ignored. -.TP -.B 3 -Mounted stream. -.I Fildes -must refer to a stream; -future calls to -.IR open (2) -on -.I name -will reopen the stream. -The mount is undone -if the other end of the stream -is closed or hung up. -.TP -.B 4 -Stream (network) file system. -.I Fildes -is a stream, -whose other end is handled by a file system server, -.IR netfs (8). -The default ceiling label is lattice bottom with no privileges. -.PP -Types 5 and 6 -are used internally -to close off errors -and for pipes; -these types may not be mounted. -.PP -.I Fmount5 -performs the function of -.I fmount -and, on file systems of type 0 or 4, imposes a specified -.I ceiling -label. -No file in the file system can be accessed \- -regardless of privilege \- unless the label of the file -is dominated by the file system ceiling. -Moreover, in determining capabilities during -.IR exec (2), -capability and license bits in the file label are -masked by corresponding bits in the ceiling. -.PP -Ceilings may be used to limit the labels of data -placed in file systems for export to untrusted destinations, -and to limit the acquisition -of privilege by programs in file systems of untrusted origin. -.PP -.I Funmount -removes knowledge of the file system -on which -.I name -resides. -The mount point -reverts to its previous interpretation. -.PP -Anyone may mount or unmount -process file systems -(type 3); -for other types, -these calls are restricted to the -super-user. -All require capability -.BR T_EXTERN ; -see -.IR getplab (2). -.SH SEE ALSO -.IR labmount (2), -.IR mount (8) -.SH DIAGNOSTICS -.BR EBADF , -.BR EBUSY , -.BR EINVAL , -.BR EIO , -.BR ELAB , -.BR ENODEV -.SH BUGS -Although -.I fildes -for type 2 file systems is ignored, -it must be a valid file descriptor. diff --git a/static/v10/man2/fork.2 b/static/v10/man2/fork.2 deleted file mode 100644 index 300c1dec..00000000 --- a/static/v10/man2/fork.2 +++ /dev/null @@ -1,32 +0,0 @@ -.pa 1 -.he 'FORK (II)'3/15/72'FORK (II)' -.ti 0 -NAME fork -- spawn new process -.sp -.ti 0 -SYNOPSIS sys fork / fork = 2. -.br -(new process return) -.br -(old process return) -.sp -.ti 0 -DESCRIPTION fork____ -is the only way new processes are created. -The new process's core image is a copy of -that of the caller of fork____; the only distinction -is the return location and the fact -that r0 in the old process contains the process ID -of the new process. -This process ID is used by wait____. -.sp -.ti 0 -SEE ALSO wait(II), exec(II) -.sp -.ti 0 -DIAGNOSTICS The error bit -(c-bit) is set in the old process if a new process -could not be created because of lack of process space. -.sp -.ti 0 -BUGS See wait(II) for a subtile bug in process destruction. diff --git a/static/v10/man2/fpe.2 b/static/v10/man2/fpe.2 deleted file mode 100644 index 1da99684..00000000 --- a/static/v10/man2/fpe.2 +++ /dev/null @@ -1,34 +0,0 @@ -.pa 1 -.he 'FPE (II)'9/2/72'FPE (II)' -.ti 0 -NAME fpe -- set floating exception handling -.sp -.ti 0 -SYNOPSIS sys fpe; arg / fpe = 40. not in assembler -.sp -.ti 0 -DESCRIPTION This call -allows one to catch traps resulting from -floating point exceptions. -Arg___ is a location within the program; floating exception traps -are sent to that location. -The normal effect of floating exception traps may be restored by giving -an arg___ equal to 0. -.sp -To return after catching the -fpe___ -trap, execute the rti___ instruction. -.sp -.ti 0 -SEE ALSO -- -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS The -floating point exception (FEC) register -is not saved per process. -Examining this register for possible -remedial action after a floating point -exception trap is not guaranteed to work. diff --git a/static/v10/man2/front.2 b/static/v10/man2/front.2 deleted file mode 100644 index b44ff1ce..00000000 --- a/static/v10/man2/front.2 +++ /dev/null @@ -1,12 +0,0 @@ -../../../tst/front.c:20: type error in argument 1 to `s'; found `pointer to struct D' expected `pointer to incomplete struct D defined at ../../../tst/front.c:14' -../../../tst/front.c:36: operands of = have illegal types `pointer to int' and `pointer to const int' -../../../tst/front.c:69: warning: inconsistent linkage for `yy' previously declared at ../../../tst/front.c:68 -../../../tst/front.c:71: invalid storage class `static' for `int function goo' -../../../tst/front.c:71: warning: declaration of `goo' does not match previous declaration at ../../../tst/front.c:70 -../../../tst/front.c:74: warning: declaration of `xr' does not match previous declaration at ../../../tst/front.c:72 -../../../tst/front.c:82: warning: declaration of `ss2' does not match previous declaration at ../../../tst/front.c:81 -../../../tst/front.c:84: warning: inconsistent linkage for `ss5' previously declared at ../../../tst/front.c:80 -../../../tst/front.c:92: type error in argument 1 to `gx1'; found `pointer to double' expected `double' -../../../tst/front.c:95: redeclaration of `hx1' previously declared at ../../../tst/front.c:94 -../../../tst/front.c:101: conflicting argument declarations for function `gg1' -../../../tst/front.c:112: type error in argument 4 to `qsort'; found `pointer to int function(pointer to pointer to char,pointer to pointer to char)' expected `pointer to int function(pointer to const void,pointer to const void)' diff --git a/static/v10/man2/fstat.2 b/static/v10/man2/fstat.2 deleted file mode 100644 index d731f755..00000000 --- a/static/v10/man2/fstat.2 +++ /dev/null @@ -1,27 +0,0 @@ -.pa 1 -.he 'FSTAT (II)'3/15/72'FSTAT (II)' -.ti 0 -NAME fstat -- get status of open file -.sp -.ti 0 -SYNOPSIS (file descriptor in r0) -.br -sys fstat; buf / fstat = 28. -.sp -.ti 0 -DESCRIPTION This -call is identical to stat____, except that it operates -on open files instead of files given by name. -It is most often used to get the status -of the standard input and output files, whose names -are unknown. -.sp -.ti 0 -SEE ALSO stat(II) -.sp -.ti 0 -DIAGNOSTICS The error bit -(c-bit) is set if the file descriptor is unknown. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/getflab.2 b/static/v10/man2/getflab.2 deleted file mode 100644 index dc4e1f6f..00000000 --- a/static/v10/man2/getflab.2 +++ /dev/null @@ -1,238 +0,0 @@ -.TH GETFLAB 2 -.SH NAME -getflab, fgetflab, setflab, fsetflab \- get or set -file security label and privilege -.SH SYNOPSIS -.B #include <sys/label.h> -.PP -.B getflab(name, labp) -.br -.B char *name; -.br -.B struct label *labp; -.PP -.B fgetflab(fildes, labp) -.br -.B struct label *labp; -.PP -.B setflab(name, labp) -.br -.B char *name; -.br -.B struct label *labp; -.PP -.B fsetflab(fildes, labp) -.br -.B struct label *labp; -.SH DESCRIPTION -.I Getflab -copies the security label from the the named file into the -structure pointed to by -.IR labp . -.I Fgetlab -copies the security label from an open file specified by -file descriptor. -The field -.B lb_junk -is always zero. -.PP -The structure of a security label as defined in -.BR <sys/label.h> -is -.LP -.EX -.ta \w'#define 'u +\w'struct labpriv 'u +\w'lb_flag 'u -#define LABSIZ 60 -struct labpriv { - unsigned int lp_junk : 16, /* poison level, see syslog(2) */ - lp_flag : 2, - lp_fix : 2, /* fixity */ - lp_t : 6, /* capabilities */ - lp_u : 6; /* licenses */ -}; -struct label { - struct labpriv lb_priv; - unsigned char lb_bits[LABSIZ]; -# define lb_junk lb_priv.lp_junk -# define lb_flag lb_priv.lp_flag -# define lb_t lb_priv.lp_t -# define lb_u lb_priv.lp_u -# define lb_fix lb_priv.lp_fix -}; - /* codes in lb_flag */ -#define L_YES 1 -#define L_NO 2 -#define L_BITS 3 - /* codes in lb_fix */ -#define F_LOOSE 0 -#define F_FROZEN 1 -#define F_RIGID 2 -#define F_CONST 3 - /* bits of lb_t and lb_u */ -#define T_SETPRIV 001 /* may set file privilege */ -#define T_SETLIC 002 /* may change process license */ -#define T_NOCHK 004 /* exempt from label checking */ -#define T_EXTERN 010 /* may introduce foreign data */ -#define T_UAREA 020 /* may write in u area */ -#define T_LOG 040 /* may execute syslog() call */ -.EE -.PP -Three types of labels are distinguished by the -.B lb_flag -field: -.TF L_BITS -.PD -.TP -.B L_YES -The file -can be read or modified without regard to label. -Its inode data (see -.IR stat (2)) -have permanent conventional values. -.IR Null (4), -.IR log (4), -and -.IR fd (4) -are labeled -.BR L_YES . -.TP -.B L_NO -The the file and its inode cannot be -read or written except by processes with capability -.BR T_NOCHK . -A -.BR L_NO -label may be changed by processes with capability -.BR T_EXTERN , -unless prevented by -.BR F_CONST -described below. -.TP -.B L_BITS -The label has a `lattice value', given by -.BR lb_bits -and so called because the values form a mathematical lattice with -bitwise AND as the meet operation and OR as the join. -.PP -Each process and each file has a label. -Normally data may only flow `up' the lattice. -The destination of a read, write, inode -query, or inode change must have a lattice value that -dominates (bitwise) the lattice value of the source, unless -the process concerned has capability -.BR T_NOCHK . -.PP -To assure upward flow, a -.IR read (2) -or an inode query (e.g.\& -.IR stat (2)) -normally causes the file label to be OR-ed into the process label. -Similarly a -.IR write (2) -or an inode change (as by -.IR chmod (2) -or -.IR link (2)) -causes the process label to be OR-ed into the file label. -However such side-effect changes in a file or process label -may happen only if the label is loose -(see below) and the new label is dominated by the process ceiling; -see -.IR getplab (2). -Otherwise the system call terminates with error -.BR ELAB . -.PP -Security checks are independent of, and made prior to, the -permission checks described in -.IR access (2). -Super-user processes are subject to security checks. -.PP -.I Setflab -replaces the security label of the named file with the -contents of the structure pointed to by -.I labp. -.I Fsetflab -replaces the security label of an open file specified by -file descriptor. -If the new label has flag -.BR L_BITS , -the new lattice value must dominate the old one, -dominate the process label, and be dominated -by the process ceiling. -If the new label has flag -.BR L_NO , -the old label must be dominated by the process ceiling. -Flag -.B L_YES -is an error. -The field -.B lb_junk -is ignored. -.PP -The field -.B lb_t -contains `capability' bits; -.B lb_u -contains corresponding `license' bits; their meanings -are described in -.IR getplab (2) -and -.IR exec (2). -The two fields together are known as `privileges'. -Any file that has nonzero privileges is called `trusted' -and cannot be changed, in contents or in inode, except by -processes with capability -.BR T_SETPRIV . -.PP -Aside from considerations of trustedness, -a label can be changed with more or less freedom according to -its `fixity', -.BR lb_fix : -.TF F_FROZEN -.PD -.TP -.B F_LOOSE -Any process can change the lattice value of a -loose file label implicitly as a side effect -as described above or (up to the process ceiling) explicitly with -.I setflab -or -.I fsetflab. -The file owner or the super-user can change the fixity. -.TP -.B F_FROZEN -The lattice value of a frozen label cannot change. -The fixity can be changed by the file owner or the super-user. -.TP -.B F_RIGID -Only processes with capability -.BR T_EXTERN -can change a rigid label; see -.IR getplab (2). -The labels of external media, such as terminals, tapes or -disks, are automatically rigid. -A loose or frozen label on a stream -(see -.IR stream (4)) -can be changed to rigid. -This facility allows filters, such as -.IR mux (9.1), -to make pipes behave like external devices. -The fixity of a rigid label cannot change. -.TP -.B F_CONST -A constant label may not be changed. -The labels of certain special files, such as -.F /dev/null -and -.FR /dev/mem , -are automatically constant; no other labels may become constant. -.SH SEE ALSO -.IR getplab (2), -.IR getlab (1), -.IR labLE (3), -.IR setlab (8), -.IR unsafe (2), -.IR signal (2) -.SH DIAGNOSTICS -.B "EFAULT, EIO, ELAB, ELOOP, ENOENT, ENOTDIR diff --git a/static/v10/man2/getgid.2 b/static/v10/man2/getgid.2 deleted file mode 100644 index d8d3b829..00000000 --- a/static/v10/man2/getgid.2 +++ /dev/null @@ -1,25 +0,0 @@ -.th GETGID II 8/5/73 -.sh NAME -getgid \*- get group identification -.sh SYNOPSIS -(getgid = 47.; not in assembler) -.br -.ft B -sys getgid -.s3 -getgid( ) -.ft R -.sh DESCRIPTION -.it Getgid -returns -the real group ID of -the current process. -The real group ID identifies the group of the person who is logged in, -in contradistinction to the effective group ID, which -determines his access permission at the moment. -It is thus useful to programs which operate using -the ``set group ID'' mode, to find out who invoked them. -.sh "SEE ALSO" -setgid(II) -.sh DIAGNOSTICS -\*- diff --git a/static/v10/man2/getplab.2 b/static/v10/man2/getplab.2 deleted file mode 100644 index 0bb97663..00000000 --- a/static/v10/man2/getplab.2 +++ /dev/null @@ -1,137 +0,0 @@ -.TH GETPLAB 2 -.SH NAME -getplab, setplab \- get or set process security -label and privilege -.SH SYNOPSIS -.B #include <sys/label.h> -.PP -.B getplab(labp, ceilp) -.br -.B struct label *labp, *ceilp; -.PP -.B setplab(labp, ceilp) -.br -.B struct label *labp, *ceilp; -.SH DESCRIPTION -.I Getplab -copies the security label and the ceiling label, -usually simply called `the ceiling', -of the current process -into the structures pointed to by -.IR labp -and -.IR ceilp. -No copy happens for a zero pointer. -The structure and meaning of labels are described in -.IR getflab (2). -The ceiling is a security lid; -the process can only access files with labels dominated -by the ceiling. -.PP -A process may have special security `capabilities', in which case -it is called `trusted'. -The capabilities are obtained from the file it is executing, usually -as `licensed' from its parent process; see -.IR exec (2). -The capabilities and corresponding licenses -are given by bits in the fields -.IB labp ->lb_t -and -.IB labp ->lb_u -respectively. -The bits are defined by the masks -.TF T_SETPRIV -.PD -.TP -.B T_SETPRIV -The process can change the privileges of files; see -.IR getflab (2). -.TP -.B T_SETLIC -The process can increase its own licenses; see below. -.TP -.B T_EXTERN -The process can bring new data sources into -view by mounting file systems or setting labels -of (open) special files; see -.IR getflab (2). -.TP -.B T_NOCHK -Ordinary checks and changes of lattice values are not made -when reading or writing files or inodes or when setting the -process label. -.TP -.B T_UAREA -The process can change certain information that -may be accessed by descendent processes without label checks; see -.IR setuid (2) -and -.IR stream (4). -.TP -.B T_LOG -The process can change logging status; see -.IR syslog (2). -.PP -.I Setplab -copies the structures pointed to by -.IR labp -and -.IR ceilp -into the process label and the ceiling label. -Unless the process has capability -.BR T_NOCHK , -the new lattice value of the process label must dominate the -old and the old lattice value of the ceiling must dominate the new. -.PP -The new label flag must be -.BR L_BITS , -and the lattice value of the new ceiling label must dominate the -lattice value of the new process label. -.PP -Capabilities -may not increase. -Licenses -may increase only if the process has capability -.BR T_SETLIC . -.PP -The fixity, -.BR lb_fix , -of a process may be set only to -.B F_LOOSE -or -.BR F_FROZEN . -In the latter case the process label can not change -as a side effect of label checking. -.PP -The bits of the ceiling pointer are themselves labeled as -if they were a minifile. -When the ceiling is set by -.I setplab, -the minifile label is set to the old value of the process label, -unless the process has capability -.BR T_SETLIC , -in which the minifile label is set to bottom. -When the ceiling is read by -.I getplab, -the minifile label is checked as if read by -.IR read (2). -.SH DIAGNOSTICS -.BR EFAULT , -.BR ELAB , -.BR EPRIV -.br -If -.I getplab -cannot raise the process label to dominate the minifile label, -the requested labels are filled in, with the ceiling being censored -to flag -.B L_NO , -and -.B ELAB -is returned. -.SH SEE ALSO -.IR getflab (2), -.IR unsafe (2), -.IR exec (2), -.IR session (1), -.IR setlab (8) diff --git a/static/v10/man2/getuid.2 b/static/v10/man2/getuid.2 deleted file mode 100644 index eb3a3dd8..00000000 --- a/static/v10/man2/getuid.2 +++ /dev/null @@ -1,29 +0,0 @@ -.pa 1 -.he 'GETUID (II)'3/15/72'GETUID (II)' -.ti 0 -NAME getuid -- get user identification -.sp -.ti 0 -SYNOPSIS sys getuid / getuid = 24. -.br -(user ID in r0) -.sp -.ti 0 -DESCRIPTION getuid______ returns -the real user ID of -the current process. -The real user ID identifies the person who is logged in, -in contradistinction to the effective user ID, which -determines his access permission at each moment. -It is thus useful to programs which operate using -the "set user ID" mode, to find out who invoked them. -.sp -.ti 0 -.ti 0 -SEE ALSO setuid(II) -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/gtty.2 b/static/v10/man2/gtty.2 deleted file mode 100644 index 0f265f64..00000000 --- a/static/v10/man2/gtty.2 +++ /dev/null @@ -1,31 +0,0 @@ -.pa 1 -.he 'GTTY (II)'3/15/72'GTTY (II)' -.ti 0 -NAME gtty -- get typewriter status -.sp -.ti 0 -SYNOPSIS (file descriptor in r0) -.br -sys gtty; arg / gtty = 32. -.br -.li -... -.ti -5 -arg: .=.+6 -.sp -.ti 0 -DESCRIPTION gtty____ -stores in the three words addressed by arg___ the status -of the typewriter whose file descriptor is given in r0. -The format is the same as that passed by stty____. -.sp -.ti 0 -SEE ALSO stty(II) -.sp -.ti 0 -DIAGNOSTICS Error bit -(c-bit) is set if the file descriptor does not refer -to a typewriter. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/ilgins.2 b/static/v10/man2/ilgins.2 deleted file mode 100644 index 5ced8f87..00000000 --- a/static/v10/man2/ilgins.2 +++ /dev/null @@ -1,34 +0,0 @@ -.pa 1 -.he 'ILGINS (II)'3/15/72'ILGINS (II)' -.ti 0 -NAME ilgins -- catch illegal instruction trap -.sp -.ti 0 -SYNOPSIS sys ilgins; arg / ilgins = 33. -.sp -.ti 0 -DESCRIPTION ilgins______ -allows a program to catch illegal instruction traps. -If arg___ -is zero, the normal instruction trap handling is done: -the process is terminated and a core image is produced. -If arg___ -is a location within the program, control -is passed to arg___ when the trap occurs. -.sp -This call is used to implement the floating point simulator, -which catches and interprets 11/45 floating point -instructions. -.sp -To return after catching the -ilgins______ -trap, execute the rti___ instruction. -.sp -.ti 0 -SEE ALSO PDP-11 manual -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/indir.2 b/static/v10/man2/indir.2 deleted file mode 100644 index 74146e35..00000000 --- a/static/v10/man2/indir.2 +++ /dev/null @@ -1,32 +0,0 @@ -.th INDIR II 8/5/73 -.sh NAME -indir \*- indirect system call -.sh SYNOPSIS -(indir = 0.; not in assembler) -.br -.ft B -sys indir; syscall -.ft R -.sh DESCRIPTION -The system call at the location -.it syscall -is executed. -Execution resumes after the -.it indir -call. -.s3 -The main purpose of -.it indir -is to allow a program to -store arguments in system calls and execute them -out of line in the data segment. -This preserves the purity of the text segment. -.s3 -If -.it indir -is executed indirectly, -it is a no-op. -.sh "SEE ALSO" -\*- -.sh DIAGNOSTICS -\*- diff --git a/static/v10/man2/intr.2 b/static/v10/man2/intr.2 deleted file mode 100644 index 0cf8a064..00000000 --- a/static/v10/man2/intr.2 +++ /dev/null @@ -1,31 +0,0 @@ -.pa 1 -.he 'INTR (II)'3/15/72'INTR (II)' -.ti 0 -NAME intr -- set interrupt handling -.sp -.ti 0 -SYNOPSIS sys intr; arg / intr = 27. -.sp -.ti 0 -DESCRIPTION When arg___ is 0, -interrupts (ASCII DELETE) are ignored. -When arg___ is 1, -interrupts cause their normal result, that is, force an exit____. -When arg___ is a location within the program, control is -transferred to that location when an interrupt occurs. -.sp -After an interrupt is caught, it is possible to resume -execution by means of an rti___ instruction; however, great -care must be exercised, since -all I/O is terminated abruptly upon an interrupt. -In particular, reads of the typewriter tend to return -with 0 characters read, thus simulating an end of file. -.sp -.ti 0 -SEE ALSO quit(II) -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/intro.2 b/static/v10/man2/intro.2 deleted file mode 100644 index 9313ccfd..00000000 --- a/static/v10/man2/intro.2 +++ /dev/null @@ -1,271 +0,0 @@ -.TH INTRO 2 -.de en -.HP -\\$1 \\fL\\$2\\fP \\$3 -.br -.. -.SH NAME -intro, errno \(mi introduction to system calls and error numbers -.SH SYNOPSIS -.B #include <errno.h> -.SH DESCRIPTION -Section 2 -describes the entries into the kernel. -.PP -Calls that deal with file systems refer to directory entries by name. -In order to -.I read -or -.IR write (2) -data on a file, the file must be opened -.RI ( open, -.I pipe, -.IR creat (2)); -an open file is known by a integer called a -.IR "file descriptor" . -Certain open files admit control operations that alter their behavior; -see in particular -.IR ioctl (2), -.IR stream (4), -and -.IR ttyld (4). -.PP -Besides ordinary file systems, which are passive repositories of data, -organized in a hierarchical directory structure, -there are -special file systems \(em virtual constructs with an interface -that mimics an ordinary file system. -In particular, access to files on remote computers is -mediated by the special file system -.IR netfs (8). -Other special file systems support -.IR proc (4) -and -.IR faced (9.5). -.SH SEE ALSO -.IR intro (3) -.SH DIAGNOSTICS -A `Diagnostics' paragraph appears below for each system call -that has an error return. -Unless otherwise stated, the error value is the integer \-1, -and the success value is 0. -Upon an error return, -an error number is assigned to -the external variable -.IR errno . -.I Errno -is not cleared on successful calls, so it should be tested only -after an error has occurred. -.PP -There is a table of messages that describe the errors -and a routine for printing them; -see -.IR perror (3). -The list below gives -the number, the name (as defined in -.BR <errno.h> ), -and the -.I perror -message for each error type. -The reasons for error returns are explained in general terms; -further explanations for less obvious error returns -appear in the writeups of individual system calls. -.en 0 \h'\w'EIO'u' "Error 0 -No error has occurred. -.en 1 EPERM "Not owner -An attempt was made to modify a file in some way forbidden -except to its owner or the super-user, -or an ordinary user attempted to do something -allowed only to the super-user. -.en 2 ENOENT "No such file or directory -A file name was specified -and the file should exist but doesn't, or one -of the directories in a path name does not exist. -.en 3 ESRCH "No such process -The process whose number was given to -.I kill -does not exist, or is already dead. -.en 4 EINTR "Interrupted system call -An asynchronous signal (such as interrupt or quit), -which the user has elected to catch, -occurred during a system call. -If execution is resumed -after processing the signal, -it will appear as if the interrupted system call -returned this error condition. -.en 5 EIO "I/O error -A physical I/O error or timeout occurred during -.IR read , -.I write, -or -.I ioctl. -This error may in some cases be returned -on a call following the one to which it actually applies. -.en 6 ENXIO "No such device or address -I/O on a special file refers to a subdevice which does not -exist, -or beyond the limits of the device. -It may also occur when, for example, a tape drive -is off line or no disk pack is loaded on a drive. -.en 7 E2BIG "Arg list too long -An argument list longer than 16384 bytes -was presented to -.IR exec . -.en 8 ENOEXEC "Exec format error -A request was made to execute a file -which, although it has the appropriate permissions, -does not start with a valid magic number, see -.IR a.out (5). -.en 9 EBADF "Bad file number -A file descriptor referred to no -open file, -or a read (resp. write) request was made to -a file which is open only for writing (resp. reading). -.en 10 ECHILD "No children -In a -.IR wait , -the process had no -living or unwaited-for children. -.en 11 EAGAIN "No more processes -In a -.IR fork , -the system's process table was full -or the user is not allowed to create any more -processes. -.en 12 ENOMEM "Not enough memory -During an -.I exec -or -.I brk, -a program asked for more memory or swap space -than the system is able to supply. -.en 13 EACCES "Permission denied -An attempt was made to access a file in a way forbidden -by the protection system. -.en 14 EFAULT "Bad address -The system encountered a hardware fault in attempting to -access the arguments of a system call. -.en 15 EHASF "Directory not empty -An attempt was made to remove a nonempty directory. -.en 16 EBUSY "In use -An attempt was made to mount a device that was already mounted -(or crashed or was copied in mounted state), -to dismount a device -on which there is an active file -(open file, current directory, mounted-on file, active text segment), -or to remove the current directory of some process. -.en 17 EEXIST "File exists -An existing file was mentioned in an inappropriate context, -e.g. -.IR link . -.en 18 EXDEV "Cross-device link -A link to a file on another device -was attempted. -.en 19 ENODEV "No such device -An attempt was made to apply an inappropriate -system call to a device; -e.g. read a write-only device. -.en 20 ENOTDIR "Not a directory -A non-directory was specified where a directory -is required, -for example in a path name or -as an argument to -.IR chdir . -.en 21 EISDIR "Is a directory -An attempt to write on a directory. -.en 22 EINVAL "Invalid argument -Some invalid argument: -dismounting a non-mounted -device, -mentioning an unknown signal in -.IR signal , -reading or writing a file for which -.I lseek -has generated a negative pointer. -Also set by math functions, see -.IR intro (3). -.en 23 ENFILE "File table overflow -The system's table of open files is full, -and temporarily no more -.I opens -can be accepted. -.en 24 EMFILE "Too many open files -The limit is 128 per process. -.en 25 ENOTTY "Illegal ioctl -The function code mentioned in -.I ioctl -does not apply to the file or device. -.en 26 ETXTBSY "Text file busy -An attempt to execute a pure-procedure -program which is currently open. -Also an attempt to open for writing a pure-procedure -program that is being executed. -.en 27 EFBIG "File too large -The size of a file exceeded the maximum (about -.if t 10\u\s-29\s+2\d -.if n 1.0E9 -bytes). -.en 28 ENOSPC "No space left on device -During a -.I write -to an ordinary file, -there was no free space left on the device. -.en 29 ESPIPE "Illegal seek -An -.I lseek -was issued to a pipe or -other non-seekable device. -.en 30 EROFS "Read-only file system -An attempt to modify a file or directory -was made -on a device mounted read-only. -.en 31 EMLINK "Too many links -An attempt to make more than 32767 links to a file. -.en 32 EPIPE "Broken pipe -A write on a pipe for which there is no process -to read the data, or on a file with insufficient -security clearance. -This condition normally generates a signal; -the error is returned if the signal is ignored. -.en 33 EDOM "Math argument -The argument of a function in the math package (3M) -is out of the domain of the function. -.en 34 ERANGE "Result too large -The value of a function in the math package (3M) -is unrepresentable within machine precision. -.en 35 ELOOP "Link loop -An endless cycle of symbolic links was encountered. -.en 36 ECONC "Concurrency violation -The open was in violation of the concurrent access specified -for the file, -or an attempted IO operation violated a process exclusive (pex) lock. -.en 37 EGREG "It's all Greg's fault -Something went wrong. -.en 38 ELAB "Security label violation -An action which would, if completed, break security rules; see -.IR getplab (2). -.en 39 ENOSYS "No such system call -An attempt to execute a nonexistent or unsupported system call. -.en 40 ENLAB "Out of security labels -A system table for security labels is full: -a trouble similar to -.BR ENFILE . -.en 41 EPRIV "Insufficient privilege -An attempt was made to execute a priviledged system call, or -exercise a privileged feature of a regular system call. -.SH SEE ALSO -.IR perror (3) -.SH BUGS -Device drivers and special file systems may use error codes in -unexpected or unconventional ways; -it is infeasible to list them all. -For example, the crash of a remote computer or the -failure of a communication protocol can produce -.L ENOENT -(no such file or directory) in response to -an attempt to open a file through the network file system. -.br -To avoid publishing duplicates of trivially changed manual pages, -.L ELAB -is not recorded among diagnostics when that would be the only -difference from v9. diff --git a/static/v10/man2/ioctl.2 b/static/v10/man2/ioctl.2 deleted file mode 100644 index 97e3a682..00000000 --- a/static/v10/man2/ioctl.2 +++ /dev/null @@ -1,73 +0,0 @@ -.TH IOCTL 2 -.CT 2 file_io file_inq_creat -.SH NAME -ioctl \(mi miscellaneous control operations -.SH SYNOPSIS -.nf -.B #include <sgtty.h> -.PP -.B int ioctl(fildes, request, argp) -.B struct sgttyb *argp; -.fi -.SH DESCRIPTION -.I Ioctl -performs a variety of functions -on special files and streams. -The writeups of various devices -in section 4 discuss how -.I ioctl -applies to them. -.PP -Some calls, however, apply to any open file, -including -the process-exclusive calls -.BR FIOPX, -.BR FIONPX, -and -.BR FIOQX -(see -.IR pex (4)), -as well as -the following two standard calls, -.IP -.L -ioctl(fildes, FIOCLEX, (void *)0); -.br -.L -ioctl(fildes, FIONCLEX, (void *)0); -.LP -The first causes the file to be closed automatically upon -a successful -.IR exec (2); -the second causes the file to be left open. -.SH "SEE ALSO" -.IR stty (1), -.IR exec (2), -.IR proc (4), -.IR ttyld (4) -.SH DIAGNOSTICS -.BR EBADF , -.BR EFAULT , -.BR EIO , -.BR ELAB , -.BR ENODEV , -.BR ENOTTY -.SH BUGS -Strictly speaking, -since -.I ioctl -may be extended in different ways to devices with -different properties, -.I argp -should have an open-ended declaration like -.IP -.L -union { struct sgttyb ...; ... } *argp; -.PP -The important thing is that the size is at least -.B sizeof(struct -.BR sgttyb) . -.br -.I Ioctl -requests vary among UNIX systems; -undisciplined use is likely to compromise portability. diff --git a/static/v10/man2/kill.2 b/static/v10/man2/kill.2 deleted file mode 100644 index e59642b3..00000000 --- a/static/v10/man2/kill.2 +++ /dev/null @@ -1,29 +0,0 @@ -.pa 1 -.he 'KILL (II)'6/12/72'KILL (II)' -.ti 0 -NAME kill -- destroy process -.sp -.ti 0 -SYNOPSIS (process number in r0) -.br -sys kill / kill = 37.; not in assembler -.sp -.ti 0 -DESCRIPTION kill____ -destroys a process, given its process number. -The process leaves a core image. - -This call is restricted to the super-user, -and is intended only to kill an otherwise -unstoppable process. -.sp -.ti 0 -SEE ALSO -- -.sp -.ti 0 -DIAGNOSTICS c-bit set -if user is not the super-user, or if process does not exist. -.sp -.ti 0 -BUGS Under -strange circumstances, kill____ is ineffective. diff --git a/static/v10/man2/labmount.2 b/static/v10/man2/labmount.2 deleted file mode 100644 index 309bbece..00000000 --- a/static/v10/man2/labmount.2 +++ /dev/null @@ -1,25 +0,0 @@ -.TH LABMOUNT 2 -.SH NAME -labmount \- return file system ceiling label -.SH SYNOPSIS -.B int labmount(fd, lp) -.br -.B struct label *lp; -.SH DESCRIPTION -If the file with descriptor -.I fd -resides in a file system, -.I labmount -copies the ceiling label of that file system into -the place pointed to by -.I lp. -If the file does not reside in a file system, the -ceiling is reported to be -.BR L_YES ; -see -.IR getflab (2). -.SH SEE ALSO -.IR fmount (2) -.SH DIAGNOSTICS -.L -EBADF, EFAULT, EIO, ELOOP, ENOENT, ENOTDIR diff --git a/static/v10/man2/limits.2 b/static/v10/man2/limits.2 deleted file mode 100644 index fa69e8b2..00000000 --- a/static/v10/man2/limits.2 +++ /dev/null @@ -1,145 +0,0 @@ -.TH LIMITS 2 SHARE-deprecated -.SH NAME -limits \- return or set limits structure -.SH SYNOPSIS -.B #include <sys/types.h> -.br -.B #include <sys/lnode.h> -.br -.B #include <sys/retlim.h> -.br -.B #include <sys/share.h> -.P -.B limits(address, function) -.br -.B struct lnode *address; -.br -.B int function; -.SH DESCRIPTION -This system call manipulates a kernel limits structure -according to the value of -.IR function . -Except where indicated below, -.I address -points to an -.I lnode -or an array of -.IR lnodes . -.LP -.RS 2 -.nf -.ta \w'\s-1L_DEADGROUP\s0XX'u +\w'ValueXX'u -Function Value Meaning -\s-1L_MYLIM\s0 0 Get user's own limits structure. -\s-1L_OTHLIM\s0 1 Get limits associated with uid in lnode. -\s-1L_ALLLIM\s0 2 All active limits structures are returned. -\s-1L_SETLIM\s0 3* Connect to a new limits structure. -\s-1L_DEADLIM\s0 4 Wait for dead limits belonging to child. -\s-1L_CHNGLIM\s0 5* Changes limits fields in existing limits. -\s-1L_DEADGROUP\s0 6* Pick up a dead limits structure. -\s-1L_GETCOSTS\s0 7 Get contents of system ``shconsts'' table. -\s-1L_SETCOSTS\s0 8* Set contents of system ``shconsts'' table. -\s-1L_MYKN\s0 9 Get user's own ``kern_lnode'' structure. -\s-1L_OTHKN\s0 10 Get structure associated with uid. -\s-1L_ALLKN\s0 11 All active structures are returned. -.fi -.RE -.P -The starred functions in the list are super\-user only. -.P -For -.SM L_MYKN, -.SM L_OTHKN, -and -.SM L_ALLKN -.I address -should point to a ``struct kern_lnode'' -defined in -.IR <sys/lnode.h> . -For -.SM L_SETCOSTS -and -.SM L_GETCOSTS -.I address -should point to a ``struct shconsts'' -defined in -.IR <sys/share.h> . -For -.SM L_DEADLIM -.I address -should point to a ``struct retlim'' defined in -.IR <sys/retlim.h> . -.P -.SM L_OTHLIM -and -.SM L_CHNGLIM -require that the lnode pointed to by -.I address -contains the correct uid. -.SM L_OTHKN -requires that the kern_lnode pointed to by -.I address -contains the correct uid. -.SM L_MYLIM, -.SM L_MYKN, -.SM L_OTHLIM, -and -.SM L_OTHKN -all return the number of processes currently attached to the node. -.SM L_ALLLIM -and -.SM L_ALLKN -both return the number of active nodes returned. -.P -.SM L_SETLIM -initialises a new limits structure with the passed lnode, -and attaches the calling process to it. -All children of that process will inherit the new structure. -.P -.SM L_DEADGROUP -looks for a dead limits structure, -removes it from the list of active limits, -and returns the lnode. -.P -.SM L_DEADLIM -performs a -.IR wait (2) -system call, -then returns a structure containing both the limits and process zombie structures. -The value returned is the number of processes still attached to the node. -.P -.SM L_SETCOST -and -.SM L_GETCOST -deal with the constants structure for the scheduling algorithm. -.P -Any other function is illegal, and will return an error of EINVAL. -Unless otherwise specified the -call returns the number of limits structures returned. -.SH DIAGNOSTICS -.B ESRCH -can be returned in -.I errno -by functions -.SM L_DEADGROUP, -.SM L_OTHKN, -.SM L_OTHLIM -and -.SM L_CHNGLIM -to indicate that -the desired limits structure does not exist. -.B ESRCH -can also be returned by -.SM L_SETLIM -to indicate that this lnode's group has not been set-up. -.P -.B ETOOMANYU -is returned in errno for -.SM L_SETLIM -if there is no space left in the kernel limits table. -.P -Any error causes a \-1 to be returned. -.SH "SEE ALSO" -setlimits(3), -lnode(5), -share(5). diff --git a/static/v10/man2/link.2 b/static/v10/man2/link.2 deleted file mode 100644 index bea93604..00000000 --- a/static/v10/man2/link.2 +++ /dev/null @@ -1,26 +0,0 @@ -.pa 1 -.he 'LINK (II)'3/15/72'LINK (II)' -.ti 0 -NAME link -- link to a file -.sp -.ti 0 -SYNOPSIS sys link; name\d1\u; name\d2\u / link = 9. -.sp -.ti 0 -DESCRIPTION A link -to name____\d1\u is created; the link has name name____\d2\u. -Either name may be an arbitrary path name. -.sp -.ti 0 -SEE ALSO link(I), unlink(II) -.sp -.ti 0 -DIAGNOSTICS The error bit -(c-bit) is set when name____\d1\u -cannot be found; when name____\d2\u -already exists; when the directory of name____\d2\u -cannot be written; when -an attempt is made to link to a directory by a user other than the super-user. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/lseek.2 b/static/v10/man2/lseek.2 deleted file mode 100644 index ff982262..00000000 --- a/static/v10/man2/lseek.2 +++ /dev/null @@ -1,47 +0,0 @@ -.TH LSEEK 2 -.CT 2 file_io -.SH NAME -lseek \(mi seek, move read/write pointer -.SH SYNOPSIS -.nf -.B long lseek(fildes, offset, whence) -.B long offset; -.fi -.SH DESCRIPTION -.I Lseek -sets the file pointer for the file -associated with -.I fildes -as follows: -.IP -If -.I whence -is 0, the pointer is set to -.I offset -bytes. -.IP -If -.I whence -is 1, the pointer is set to its current location plus -.IR offset . -.IP -If -.I whence -is 2, the pointer is set to the size of the -file plus -.IR offset . -.PP -The new file pointer value is returned. -.PP -Seeking far beyond the end of a file, then writing, -creates a gap or `hole,' which occupies no -physical space and reads as zeros. -.SH "SEE ALSO" -.IR open (2), -.IR fseek (3) -.SH DIAGNOSTICS -.BR EBADF , -.BR ESPIPE -.SH BUGS -.I Lseek -doesn't affect some special files. diff --git a/static/v10/man2/m.2 b/static/v10/man2/m.2 deleted file mode 100644 index a7a8918b..00000000 --- a/static/v10/man2/m.2 +++ /dev/null @@ -1,57 +0,0 @@ -nCC alloc.c: -"alloc.c", line 55: warning: operator new() first argument should be size_t -cc -c -O alloc.i /usr/lib/nlibC.a -nCC dcl.c: -cc -c -O dcl.i /usr/lib/nlibC.a -nCC dcl2.c: -cc -c -O dcl2.i /usr/lib/nlibC.a -nCC dcl3.c: -cc -c -O dcl3.i /usr/lib/nlibC.a -nCC dcl4.c: -cc -c -O dcl4.i /usr/lib/nlibC.a -nCC del.c: -cc -c -O del.i /usr/lib/nlibC.a -nCC error.c: -cc -c -O error.i /usr/lib/nlibC.a -nCC expand.c: -cc -c -O expand.i /usr/lib/nlibC.a -nCC expr.c: -cc -c -O expr.i /usr/lib/nlibC.a -nCC expr2.c: -cc -c -O expr2.i /usr/lib/nlibC.a -nCC expr3.c: -cc -c -O expr3.i /usr/lib/nlibC.a -nCC find.c: -cc -c -O find.i /usr/lib/nlibC.a -nCC lalex.c: -cc -c -O lalex.i /usr/lib/nlibC.a -nCC lex.c: -cc -c -O lex.i /usr/lib/nlibC.a -nCC main.c: -cc -c -O main.i /usr/lib/nlibC.a -nCC norm.c: -cc -c -O norm.i /usr/lib/nlibC.a -nCC norm2.c: -cc -c -O norm2.i /usr/lib/nlibC.a -nCC print.c: -cc -c -O print.i /usr/lib/nlibC.a -nCC print2.c: -cc -c -O print2.i /usr/lib/nlibC.a -nCC repr.c: -cc -c -O repr.i /usr/lib/nlibC.a -nCC simpl.c: -cc -c -O simpl.i /usr/lib/nlibC.a -nCC simpl2.c: -cc -c -O simpl2.i /usr/lib/nlibC.a -nCC size.c: -cc -c -O size.i /usr/lib/nlibC.a -nCC table.c: -cc -c -O table.i /usr/lib/nlibC.a -nCC typ.c: -cc -c -O typ.i /usr/lib/nlibC.a -nCC typ2.c: -cc -c -O typ2.i /usr/lib/nlibC.a -nCC y.tab.c: -"gram.y", line 2337: warning: label yyerrlab not used -cc -c -O y.tab.i /usr/lib/nlibC.a -cc -o cfront -O alloc.o dcl.o dcl2.o dcl3.o dcl4.o del.o error.o expand.o expr.o expr2.o expr3.o find.o lalex.o lex.o main.o norm.o norm2.o print.o print2.o repr.o simpl.o simpl2.o size.o table.o typ.o typ2.o y.tab.o /usr/lib/nlibC.a diff --git a/static/v10/man2/makdir.2 b/static/v10/man2/makdir.2 deleted file mode 100644 index bd145d6c..00000000 --- a/static/v10/man2/makdir.2 +++ /dev/null @@ -1,27 +0,0 @@ -.pa 1 -.he 'MAKDIR (II)'3/15/72'MAKDIR (II)' -.ti 0 -NAME makdir -- make a directory -.sp -.ti 0 -SYNOPSIS sys makdir; name; mode / makdir = 14. -.sp -.ti 0 -DESCRIPTION makdir______ creates an empty directory -whose name is the null-terminated string pointed -to by name____. -The mode of the directory is mode____. -The special entries "." and ".." are not present. -.sp -makdir______ may be invoked only by the super-user. -.sp -.ti 0 -SEE ALSO mkdir(I) -.sp -.ti 0 -DIAGNOSTICS Error bit (c-bit) -is set if the directory already exists -or if the user is not the super-user. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/mdate.2 b/static/v10/man2/mdate.2 deleted file mode 100644 index a6331f6e..00000000 --- a/static/v10/man2/mdate.2 +++ /dev/null @@ -1,31 +0,0 @@ -.pa 1 -.he 'MDATE (II)'3/15/72'MDATE (II)' -.ti 0 -NAME mdate -- set modified date on file -.sp -.ti 0 -SYNOPSIS (time to r0-r1) -.br -.nf -sys mdate; file / mdate = 30. -.fi -.sp -.ti 0 -DESCRIPTION File____ -is the address of a null-terminated string giving the -name of a file. -The modified time of the file is set to the time given in -the r0-r1 registers. -.sp -This call is allowed only to the super-user -or to the owner of the file. -.sp -.ti 0 -SEE ALSO -- -.sp -.ti 0 -DIAGNOSTICS Error bit -is set if the user is neither the owner nor the super-user or if the file cannot be found. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/mkdir.2 b/static/v10/man2/mkdir.2 deleted file mode 100644 index 5af01904..00000000 --- a/static/v10/man2/mkdir.2 +++ /dev/null @@ -1,68 +0,0 @@ -.TH MKDIR 2 -.CT 2 dirs -.SH NAME -mkdir, rmdir \(mi make or remove a directory -.SH SYNOPSIS -.nf -.B int mkdir(name, mode) -.B char *name; -.sp -.B int rmdir(name) -.B char *name; -.fi -.SH DESCRIPTION -.I Mkdir -creates a new directory -whose name is the null-terminated string -pointed to by -.IR name . -The mode of the directory -is set to -.IR mode , -as modified by the process's mode mask (see -.IR stat (2) -and -.IR umask (2)). -The directory initially contains two entries: -.B . -(a link to the directory itself) and -.B .. -(a link to the parent directory). -.PP -If the -.I mode -includes -.BR S_IBLIND , -the directory is `blind'. -A blind directory cannot be read, and -its security label is not checked when the -directory is searched. -.PP -.I Rmdir -removes the directory -.IR name , -which must only have the entries -.L \&. -and -.LR \&.. . -.SH "SEE ALSO -.IR mkdir (1), -.IR rm (1), -.IR mknod (2) -.SH DIAGNOSTICS -.B EEXIST -.RI ( mkdir -only), -.BR EFAULT , -.B EHASF -.RI ( rmdir -only), -.B EINVAL -.RI ( rmdir -only), -.BR EIO , -.BR ELAB , -.BR ELOOP , -.BR ENOENT , -.BR ENOTDIR , -.BR EROFS diff --git a/static/v10/man2/mknod.2 b/static/v10/man2/mknod.2 deleted file mode 100644 index 74dead4a..00000000 --- a/static/v10/man2/mknod.2 +++ /dev/null @@ -1,42 +0,0 @@ -.th MKNOD II 8/5/73 -.sh NAME -mknod \*- make a directory or a special file -.sh SYNOPSIS -(mknod = 14.; not in assembler) -.br -.ft B -sys mknod; name; mode; addr -.s3 -mknod(name, mode, addr) -.br -char *name; -.ft R -.sh DESCRIPTION -.it Mknod -creates a new file -whose name is the null-terminated string pointed -to by -.it name. -The mode of the new file -(including directory and special file bits) -is initialized from -.it mode. -The first physical address of the file -is initialized from -.it addr. -Note that in the case of a directory, -.it addr -should be zero. -In the case of a special file, -.it addr -specifies which special file. -.s3 -.it Mknod -may be invoked only by the super-user. -.sh "SEE ALSO" -mkdir(I), mknod(I), fs(V) -.sh DIAGNOSTICS -Error bit (c-bit) -is set if the file already exists -or if the user is not the super-user. -From C, a \*-1 value indicates an error. diff --git a/static/v10/man2/mount.2 b/static/v10/man2/mount.2 deleted file mode 100644 index 7f0a9e0e..00000000 --- a/static/v10/man2/mount.2 +++ /dev/null @@ -1,38 +0,0 @@ -.pa 1 -.he 'MOUNT (II)'3/15/72'MOUNT (II)' -.ti 0 -NAME mount -- mount file system -.sp -.ti 0 -.nf -SYNOPSIS sys mount; special; name / mount = 21. -.fi -.sp -.ti 0 -DESCRIPTION mount_____ -announces to the system that a removable file system has -been mounted on special file special_______; -from now on, references to file name____ will refer to -the root file on the newly mounted file system. -Special_______ and name____ are pointers to null-terminated strings -containing the appropriate path names. - -Name____ must exist already. If it had contents, -they are inaccessible while the file system -is mounted. -.sp -.ti 0 -SEE ALSO mount(I), umount(II) -.sp -.ti 0 -DIAGNOSTICS Error bit -(c-bit) set if: special_______ is inaccessible; name____ -does not exist; -special_______ is already mounted; -name____ is not on the RF; -there are already four special files mounted. -.sp -.ti 0 -BUGS At most -four removable devices can be mounted at a time. -This call should be restricted to the super-used. diff --git a/static/v10/man2/mpx.2 b/static/v10/man2/mpx.2 deleted file mode 100644 index 188a3f30..00000000 --- a/static/v10/man2/mpx.2 +++ /dev/null @@ -1,503 +0,0 @@ -.TH MPX 2 -.UC 4 -.SH NAME -mpx \- create and manipulate multiplexed files -.SH SYNOPSIS -.nf -.B mpx(name, access) -.B char *name; -.PP -.B join(fd, xd) -.PP -.B chan(xd) -.PP -.B extract(i, xd) -.PP -.B attach(i, xd) -.PP -.B detach(i, xd) -.PP -.B connect(fd, cd, end) -.PP -.B npgrp(i, xd, pgrp) -.PP -.B ckill(i, xd, signal) -.PP -.B #include <sys/mx.h> -.B mpxcall(cmd, vec) -.B int *vec; -.fi -.SH DESCRIPTION -.PP -.B mpxcall(cmd, vec) -is the system call shared by the -library routines described below. -.I Cmd -selects a command using values -defined in -.IR <sys/mx.h> . -.I Vec -is the address of a -structure containing the arguments -for the command. -.PP -.B mpx(name, access) -.PP -.I Mpx -creates and opens the file -.I name -with access permission -.I access -(see -.IR creat (2)) -and returns a file descriptor available for -reading and writing. -A \-1 is returned if the file cannot be created, -if -.I name -already exists, or -if the file table or other operating system -data structures are full. -The file descriptor is required for use -with other routines. -.PP -If -.I name -is 0, -a file descriptor is returned as described -but no entry is created in the file system. -.PP -Once created an mpx file may be opened -(see -.IR open (2)) -by any process. -This provides a form of interprocess communication -whereby a process B can `call' process A -by opening an mpx file -created by A. -To B, the file is ordinary with one exception: -the -.I connect -primitive could be applied to it. -Otherwise the functions -described below are used only in process A -and descendants that inherit the open mpx file. -.PP -When a process opens an mpx file, the owner of the -file receives a control message when the file is next read. -The method for `answering' -this kind of call involves -using -.I attach -and -.I detach -as described in more detail below. -.PP -Once B has opened A's mpx file -it is said to have a -.I channel -to A. -A channel is a pair of data streams: -in this case, one from B to A and the -other from A to B. -Several processes may open the same mpx file -yielding multiple channels within the one mpx file. -By accessing the appropriate channel, -A can communicate with B and any others. -When A reads (see -.IR read (2)) -from the mpx file -data written to A by the other processes appears -in A's buffer using a record format -described in -.IR mpxio (5). -When A writes (see -.IR write (2)) -on its mpx file the data must be formatted in a similar way. -.PP -The following commands -are used to manipulate mpx files and channels. -.IP -.IR join \- -adds a new channel on an mpx file to an open file F. -I/O on the new channel is I/O on F. -.br -.IR chan \- -creates a new channel. -.br -.IR extract \- -file descriptor maintenance. -.br -.IR connect \- -similar to join except that the open file F is connected -to an existing channel. -.br -.I attach -and -.IR detach \- -used with call protocol. -.br -.IR npgrp \- -manipulates process group numbers so that a channel -can act as a control terminal (see -.IR tty (4)). -.br -.IR ckill \- -send signal (see -.IR signal (2)) -to process group through channel. -.PP -A maximum of 15 channels may be connected to an -mpx file. -They are numbered 0 through 14. -.I Join -may be used to make one mpx file appear as a channel -on another mpx file. -A hierarchy or tree of mpx files may be set up in this way. -In this case -one of the mpx files must be the root of a tree -where the other mpx files are interior nodes. -The maximum depth of such a tree -is 4. -.PP -An -.I index -is a 16-bit value -that denotes a location -in an mpx tree other than the root: -the path through mpx `nodes' from the root -to the location is expressed as a sequence of -4-bit nibbles. -The branch taken at the root is represented by -the low-order 4-bits of an index. -Each succeeding branch is specified by the next -higher-order nibble. -If the length of a path to be expressed -is less than 4, -then the illegal channel number, 15, -must be used to terminate the sequence. -This is not strictly necessary for the -simple case of a tree consisting of -only a root node: its channels -can be expressed by the numbers -0 through 14. -An index -.I i -and file descriptor -.I xd -for the root of an mpx tree are -required as arguments to most -of the commands described below. -Indices also serve as channel identifiers -in the record formats given in -.IR mpxio (5). -Since \-1 is not a valid index, -it can be returned as a error indication -by subroutines that normally return -indices. -.PP -The operating system informs the process managing an mpx file -of changes in the status of channels attached to the file -by generating messages that -are read along with data from the channels. -The form and content of these messages is described -in -.IR mpxio (5). -.PP -.B join(fd, xd) -establishes a connection (channel) between an mpx file -and another object. -.I Fd -is an open file descriptor for a character device -or an mpx file and -.I xd -is the file descriptor of an -mpx file. -.I Join -returns the index for the new channel -if the operation succeeds and \-1 -if it does not. -.PP -Following join, -.I fd -may still be used in any system call that would -have been meaningful before the join operation. -Thus -a process can read and write directly to -.I fd -as well as access it via -.I xd. -If the number of channels -required for a tree of mpx files -exceeds the number of open files -permitted a process by the operating system, -some of the file descriptors can be released using -the standard -.IR close (2) -call. -Following a close on an active file descriptor for a channel -or internal mpx node, -that object may still be accessed through the root of the -tree. -.PP -.B chan(xd) -allocates a channel and connects -one end of it to the mpx file -represented by file descriptor -.I xd. -.I Chan -returns the index of the new channel or -a \-1 indicating failure. -The -.I extract -primitive can be used to get a non-multiplexed -file descriptor for the free end of a channel -created by -.I chan. -.PP -Both -.I chan -and -.I join -operate on the mpx file specified by -.IR xd . -File descriptors for interior nodes of an -mpx tree must be preserved or reconstructed with -.I extract -for use with -.I join -or -.IR chan . -For the remaining commands described here, -.I xd -denotes the file descriptor for the -root of an mpx tree. -.PP -.B extract(i, xd) -returns a file descriptor for the object with -index -.I i -on the mpx tree with root file descriptor -.I xd. -A \-1 is returned by extract if a file descriptor is not available -or if the arguments do not refer to an existing -channel and mpx file. -.PP -.B attach(i, xd) -.br -.BR "detach(i, xd)" . -If a process A has created an mpx file represented -by file descriptor -.I xd, -then a process B -can open (see -.IR open (2)) -the mpx file. -The purpose is to establish a channel between -A and B through the mpx file. -.I Attach -and -.I Detach -are used by A to respond to -such opens. -.PP -An open request by B fails immediately if a -new channel cannot be allocated on the mpx file, -if the mpx file does not exist, -or if it does exist -but there is no process (A) -with a multiplexed file descriptor -for the mpx file -(i.e. -.I xd -as returned by -.IR mpx (2)). -Otherwise a channel -with index number -.I i -is allocated. -The next time A reads on file descriptor -.IR xd , -the WATCH control message -(see -.IR mpxio (5)) -will be delivered on channel -.I i. -A responds to this message with -.I attach -or -.I detach. -The former causes the open to complete and -return a file descriptor to B. -The latter deallocates channel -.I i -and causes the open to fail. -.PP -One mpx file may be placed in `listener' mode. -This is done by writing -.I "ioctl(xd, MXLSTN, 0)" -where -.I xd -is an mpx file descriptor -and MXLSTN is defined in -.IR /usr/include/sgtty.h . -The semantics of listener mode are that -all file names discovered by -.IR open (2) -to have -the syntax -.I "system!pathname" -(see -.IR uucp (1)) -are treated as opens on the mpx file. -The operating system sends the listener process -an OPEN message (see -.IR mpxio (5)) -which includes the file name being opened. -.I Attach -and -.I detach -then apply as described above. -.PP -.I Detach -has two other uses: -it closes and releases the resources -of any active channel it is applied to, -and should be used to respond to -a CLOSE message (see -.IR mpxio (5)) -on a channel so the channel may be reused. -.PP -.BR "connect(fd, cd, end)" . -.I Fd -is a character file descriptor and -.I cd -is a file descriptor for a channel, -such as might be obtained via -.I "extract( chan(xd), xd)" -or by -.IR open (2) -followed by -.I attach. -.I Connect -splices the two streams together. -If -.I end -is negative, only -the output of -.I fd -is spliced to the input of -.I cd. -If -.I end -is positive, the output of -.I cd -is spliced to the input of -.I fd. -If -.I end -is zero, then both splices are made. -.PP -.BR "npgrp(i, xd, pgrp)" . -If -.I xd -is negative -.I npgrp -applies to the process executing it, -otherwise -.I i -and -.I xd -are interpreted as a channel index and -mpx file descriptor -and -.I npgrp -is applied to the process on the -non-multiplexed end of the channel. -If -.I pgrp -is zero, the process group number of the indicated process -is set to the process number of that process, -otherwise the value of -.I pgrp -is used as the process group number. -.PP -.I Npgrp -normally returns the new process group number. -If -.I i -and -.I xd -specify a nonexistent channel, -.I npgrp -returns \-1. -.PP -.B ckill(i, xd, signal) -sends the specified signal (see -.IR signal (2)) -through the channel specified by -.I i -and -.I xd. -If the channel is connected to anything other -than a process, -.I ckill -is a null operation. -If there is a process at the other end of the channel, -the process group will be interrupted (see -.IR signal (2), -.IR kill (2)). -.I Ckill -normally returns -.I signal. -If -.I ch -and -.I xd -specify a nonexistent channel, -.I ckill -returns \-1. -.SH FILES -/usr/include/sys/mx.h -.br -/usr/include/sgtty.h -.SH "SEE ALSO" -mpxio(5) -.SH BUGS -.PP -Mpx files are an experimental part of the operating -system more subject to change and prone to bugs -than other parts. -.PP -Maintenance programs, e.g. -.IR icheck (1), -diagnose mpx files as an illegal mode. -.PP -Channels may only be connected to objects in the operating -system that are accessible through the line discipline -mechanism. -.PP -Higher performance line disciplines are needed. -.PP -The maximum tree depth restriction is not really checked. -.PP -A non-destructive -.I disconnect -primitive (inverse of -.IR connect ) -is not provided. -.PP -A non-blocking flow control strategy -based on messages defined in -.IR mpxio (5) -should not be attempted by novices; -the enabling -.I ioctl -command should be protected. -.PP -The -.I join -operation could be subsumed by -.I connect. -A mechanism is needed for moving a channel from one -location in an mpx tree to another. diff --git a/static/v10/man2/nice.2 b/static/v10/man2/nice.2 deleted file mode 100644 index a4fe2bae..00000000 --- a/static/v10/man2/nice.2 +++ /dev/null @@ -1,27 +0,0 @@ -.pa 1 -.he 'NICE (II)'3/15/72'NICE (II)' -.ti 0 -NAME nice -- set program in low priority -.sp -.ti 0 -SYNOPSIS sys nice / nice = 34. -.sp -.ti 0 -DESCRIPTION The -currently executing process is set into -the lowest priority execution queue. -Background jobs that execute a very long -time should do this. -Once done, -there is no way to restore -a process to normal -priority. -.sp -.ti 0 -SEE ALSO formerly known as "hog" -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/nochk.2 b/static/v10/man2/nochk.2 deleted file mode 100644 index 33aadfea..00000000 --- a/static/v10/man2/nochk.2 +++ /dev/null @@ -1,32 +0,0 @@ -.TH NOCHK 2 -.SH NAME -nochk \- control security checking by file -.SH SYNOPSIS -.B nochk(fd, onoff); -.SH DESCRIPTION -.I Nochk -modifies file security checks in processes that have capability -.BR T_NOCHK . -If -.I onoff -is 1, file descriptor -.I fd -becomes exempt from security checks; this is the default state. -If -.I onoff -is 0, the file descriptor will be checked as if the process -did not have capability -.BR T_NOCHK . -.PP -The return value is the previous checking state. -.SH SEE ALSO -.IR getplab (2) -.SH DIAGNOSTICS -.B EBADF -.SH BUGS -It would have been wise to let 0 be the default state, -but this would have required modifying standard -utilities, such as -.IR fsck (8), -which must be run with privilege -.BR T_NOCHK . diff --git a/static/v10/man2/open.2 b/static/v10/man2/open.2 deleted file mode 100644 index 3f295f90..00000000 --- a/static/v10/man2/open.2 +++ /dev/null @@ -1,61 +0,0 @@ -.TH OPEN 2 -.CT 2 file_io -.SH NAME -open \(mi open for reading or writing -.SH SYNOPSIS -.nf -.B int open(name, rwmode) -.B char *name; -.fi -.SH DESCRIPTION -.I Open -opens the file -.I name -for reading -(if -.I rwmode -is 0), -writing (if -.I rwmode -is 1) -or for both reading and writing -(if -.I rwmode -is 2) -and returns an associated file descriptor. -.I Name -is a null-terminated string representing -a path name. -.PP -The file pointer is set to 0. -.PP -It is not possible to open for writing a file with set-userid -or set-groupid permission; see -.IR stat (2). -.SH "SEE ALSO" -.IR close (2), -.IR creat (2), -.IR dup (2), -.IR read (2), -.IR write (2) -.SH DIAGNOSTICS -.BR EACCES , -.BR EBUSY , -.BR ECONC , -.BR EFAULT , -.BR EINTR , -.BR EIO , -.BR EISDIR , -.BR ELAB , -.BR ELOOP , -.BR EMFILE , -.BR ENFILE , -.BR ENOENT , -.BR ENOTDIR , -.BR EROFS , -.BR ETXTBSY -.SH BUGS -It should be possible to open files for writing with exclusive use, -and to call -.I open -without the necessity of waiting for carrier on communication lines. diff --git a/static/v10/man2/pipe.2 b/static/v10/man2/pipe.2 deleted file mode 100644 index 7c161316..00000000 --- a/static/v10/man2/pipe.2 +++ /dev/null @@ -1,51 +0,0 @@ -.pa 1 -.he 'PIPE (II)'1/15/73'PIPE (II)' -.ti 0 -NAME pipe -- create a pipe -.sp -.ti 0 -SYNOPSIS sys pipe / pipe = 42.; not in assembler -.br -(file descriptor in r0) -.sp -.ti 0 -DESCRIPTION The -pipe____ -system call -creates an I/O mechanism called a pipe. -The file descriptor returned can -be used in both read and write operations. -When the pipe is written, -the data is buffered up to 504 bytes -at which time the writing process is suspended. -A read on the pipe will pick up the buffered data. -.sp -It is assumed that after the -pipe____ has been set up, -two (or more) -cooperating processes -(created by subsequent fork____ calls) -will pass data through the -pipe with read____ and write_____ calls. - -The shell has a syntax -to set up a linear array of processes -connected by pipes. -.sp -Read calls on an empty -pipe (no buffered data) with only one end -(no synonymous file -descriptors resulting from fork____ or dup___) -return an end-of-file. -Write calls under similar conditions are ignored. - -.ti 0 -SEE ALSO sh(I), read(II), write(II), fork(II) -.sp -.ti 0 -DIAGNOSTICS The error -bit (c-bit) is set if -10 files are already open. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/profil.2 b/static/v10/man2/profil.2 deleted file mode 100644 index b19df5fa..00000000 --- a/static/v10/man2/profil.2 +++ /dev/null @@ -1,40 +0,0 @@ -.pa 1 -.he 'PROFIL (II)'3/7/73'PROFIL (II)' -.ti 0 -NAME profil -- execution time profile -.s3 -.ti 0 -SYNOPSIS profil = 44. / not in assembler -.br -sys profil; buff; bufsiz; offset; scale -.s3 -.ti 0 -DESCRIPTION buff____ -points to an area of core whose length (in bytes) is given by -bufsiz______. -After this call, the user's program counter (pc) -is examined each clock tick (60th second); -offset______ is subtracted from it, and the result multiplied by -scale_____. -If the resulting number corresponds to a word -inside buff____, that word is incremented. -.s3 -The scale is interpreted as an unsigned, -fixed-point fraction with binary point at the -left: 177777(8) gives a 1-1 mapping of pc's to words -in buff____; 77777(8) maps each pair of instruction words -together. -2(8) maps all instructions onto the beginning of -buff____ (producing a non-interrupting core clock). -.s3 -Profiling is turned off by giving a scale_____ of 0 or 1. -It is rendered -inffective by giving a bufsiz______ of 0. -.s3 -.ti 0 -SEE ALSO [profiling subroutines] -.s3 -.ti 0 -BUGS Profiling must be turned off before -an exec____(II), since incrementation of -the buffer is not automatically stopped. diff --git a/static/v10/man2/quit.2 b/static/v10/man2/quit.2 deleted file mode 100644 index 9fe46fc9..00000000 --- a/static/v10/man2/quit.2 +++ /dev/null @@ -1,24 +0,0 @@ -.pa 1 -.he 'QUIT (II)'3/15/72'QUIT (II)' -.ti 0 -NAME quit -- turn off quit signal -.sp -.ti 0 -SYNOPSIS sys quit; flag / quit = 26. -.sp -.ti 0 -DESCRIPTION When flag____ is 0, this call disables -quit signals from the typewriter (ASCII FS). -When flag____ is non-zero, quits are re-enabled, -and cause execution to cease and a core image to be produced. -.sp -Quits should be turned off only with due consideration. -.sp -.ti 0 -SEE ALSO intr(II) -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/read.2 b/static/v10/man2/read.2 deleted file mode 100644 index e06998f4..00000000 --- a/static/v10/man2/read.2 +++ /dev/null @@ -1,42 +0,0 @@ -.pa 1 -.he 'READ (II)'3/15/72'READ (II)' -.ti 0 -NAME read -- read from file -.sp -.ti 0 -SYNOPSIS (file descriptor in r0) -.br -sys read; buffer; nbytes / read = 3. -.br -(nread in r0) -.sp -.ti 0 -DESCRIPTION A file descriptor is a word -returned from a successful open____ or creat_____ call. -.sp -Buffer______ is the location of nbytes______ contiguous -bytes into which the input will be placed. It is not guaranteed -that all nbytes______ bytes will be read; for example -if the file refers to a typewriter at most one line -will be returned. -In any event the number of characters read is returned -in r0. -.sp -If r0 returns with value 0, then -end-of-file has been reached. -.sp -.ti 0 -SEE ALSO open(II), creat(II) -.sp -.ti 0 -DIAGNOSTICS As mentioned, -r0 is 0 on return when the end of the file has been reached. -If the read was otherwise unsuccessful -the error bit (c-bit) is set. Many conditions, -can generate an error: -physical I/O errors, bad buffer address, -preposterous nbytes______, file descriptor not that of -an input file. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/rele.2 b/static/v10/man2/rele.2 deleted file mode 100644 index 357e92b4..00000000 --- a/static/v10/man2/rele.2 +++ /dev/null @@ -1,26 +0,0 @@ -.pa 1 -.he 'RELE (II)'3/15/72'RELE (II)' -.ti 0 -NAME rele -- release processor -.sp -.ti 0 -SYNOPSIS sys rele / rele = 0; not in assembler -.sp -.ti 0 -DESCRIPTION This call -causes the process to be swapped out immediately if -another process wants to run. -Its main reason for being is internal -to the system, namely to implement timer-runout swaps. -However, it can be used beneficially by programs -which wish to loop for some reason without -consuming more processor time than necessary. -.sp -.ti 0 -SEE ALSO -- -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/seek.2 b/static/v10/man2/seek.2 deleted file mode 100644 index 303b50c0..00000000 --- a/static/v10/man2/seek.2 +++ /dev/null @@ -1,83 +0,0 @@ -.TH SEEK 2 -.CT 2 file_io -.SH NAME -seek, tell, lseek, llseek \(mi manipulate read/write pointer -.SH SYNOPSIS -.B int seek(fildes, offset, whence) -.br -.B long offset -.PP -.B long tell(fildes) -.PP -.B long lseek(fildes, offset, whence) -.B long offset; -.PP -.B Long llseek(fildes, offset, whence) -.br -.B Long offset; -.SH DESCRIPTION -.I Seek -sets the file pointer for the file -associated with -.I fildes -as follows: -.IP -If -.I whence -is 0, the pointer is set to -.I offset -bytes. -.IP -If -.I whence -is 1, the pointer is set to its current location plus -.IR offset . -.IP -If -.I whence -is 2, the pointer is set to the size of the -file plus -.IR offset . -.PP -.I Tell -returns the value of the file pointer associated with -.I fildes. -.PP -.I Lseek -is equivalent to -.I seek -followed by -.I tell. -.PP -.I Llseek -is like -.I lseek, -but handles -.CW Long , -i.e. 64-bit, file pointers. -.PP -Seeking far beyond the end of a file, then writing, -creates a gap or `hole,' which occupies no -physical space and reads as zeros. -.PP -File pointers have security labels separate from files. -For security-label calculations, -.I seek -is understood to `write' the pointer, -.I tell -to `read' it. -If -.I whence -is 0 on -.I seek, -the new value of the file pointer does not depend on -the old value. -.SH "SEE ALSO" -.IR open (2), -.IR fseek (3) -.SH DIAGNOSTICS -.BR EBADF , -.BR ESPIPE -.SH BUGS -.I Lseek -doesn't affect some special files. diff --git a/static/v10/man2/select.2 b/static/v10/man2/select.2 deleted file mode 100644 index e6e38230..00000000 --- a/static/v10/man2/select.2 +++ /dev/null @@ -1,130 +0,0 @@ -.TH SELECT 2 -.CT 2 file_io comm_proc -.SH NAME -select \(mi synchronous input/output multiplexing -.SH SYNOPSIS -.nf -.B #include <sys/types.h> -.PP -.B int select(nfds, readfds, writefds, milli); -.B fd_set *readfds, *writefds; -.fi -.SH DESCRIPTION -.I Select -examines a set of file descriptors -to see if they will block if read or written. -.I Readfds -points to an object of type -.BR fd_set , -which contains a set of descriptors to be checked for reading; -.I writefds -similarly for writing. -Only descriptors -0 through -.IR nfds \-1 -are considered. -The number of ready descriptors is returned, -and the -.B fd_set -pointed to by -.I readfds -.RI ( writefds ) -is overwritten with a set of descriptors -ready to be read -(written). -The call waits until at least one descriptor is ready, -or until -.I milli -milliseconds have passed. -.PP -Either -.I readfds -or -.I writefds -may be 0 -if no descriptors are interesting. -.PP -The -.BR fd_set -type looks like -.RS -.EX -typedef struct { - unsigned int fds_bits[FDWORDS]; -} fd_set; -.EE -.RE -.B FDWORDS -is sufficient to contain as many file descriptors as the system will allow -(currently 128). -If there are -.I B -bits in an -.BR "unsigned int" , -file descriptor -.I n -is represented by -.BI "1<<((" n % B )-1) -in word -.BI fds_bits[ n / B ]\c -\&. -.PP -These macros should be used -to manipulate the contents -of an -.BR fd_set : -.TF FD_ISSET(n,\0s) -.TP -.PD 0 -.B FD_ZERO(s) -clear all bits -in set -.I s -.TP -.B "FD_SET(n, s) -set bit for file descriptor -.I n -in set -.I s -.TP -.B "FD_CLR(n, s) -clear bit for file descriptor -.I n -in s -.TP -.B "FD_ISSET(n, s) -return a value of 1 -if bit for file descriptor -.I n -is set in -.IR s , -0 otherwise -.PD -.SH EXAMPLES -.EX -int p[2]; -fd_set wfs; -pipe(p); -do { - FD_SET(p[1], wfs); - write(p[1], ".", 1); - i++; -} while(select(p[1]+1, (fd_set*)0, wfs, 0) == 1); -printf("Pipe capacity = %d\en", i); -.EE -.SH "SEE ALSO" -.IR read (2) -.SH DIAGNOSTICS -.BR EBADF , -.BR EFAULT , -.BR EINTR -.SH BUGS -.I Milli -is rounded up to the nearest second. -.br -.I Select -is intended for use with streams; -file descriptors referring to ordinary files -or to non-stream special files -always appear ready. -This is a lie for some special files. diff --git a/static/v10/man2/setgid.2 b/static/v10/man2/setgid.2 deleted file mode 100644 index 870d5d99..00000000 --- a/static/v10/man2/setgid.2 +++ /dev/null @@ -1,25 +0,0 @@ -.th SETGID II 8/5/73 -.sh NAME -setgid \*- set process group ID -.sh SYNOPSIS -(setgid = 46.; not in assembler) -.br -(group ID in r0) -.ft B -.br -sys setgid -.s3 -setgid(gid) -.ft R -.sh DESCRIPTION -The group ID of the current process is set to -the argument. -Both the effective and the real group ID are set. -This call is only permitted to the super-user -or if the argument is the real group ID. -.sh "SEE ALSO" -getgid(II) -.sh DIAGNOSTICS -Error bit -(c-bit) is set as indicated; -from C, a \*-1 value is returned. diff --git a/static/v10/man2/setuid.2 b/static/v10/man2/setuid.2 deleted file mode 100644 index 80bf9121..00000000 --- a/static/v10/man2/setuid.2 +++ /dev/null @@ -1,50 +0,0 @@ -.TH SETUID 2 -.CT 2 sa secur -.SH NAME -setuid, setgid, setruid, setlogname \(mi set userid and groupid -.SH SYNOPSIS -.nf -.B int setuid(uid) -.PP -.B int setgid(gid) -.PP -.B int setruid(uid) -.PP -.B int setlogname(buf) -.B char buf[8]; -.fi -.SH DESCRIPTION -.I Setuid -.RI ( setgid ) -sets the effective and real userid (groupid) of the current process to -.I uid -.RI ( gid ). -Both the effective and the real userid (groupid) are set. -.I Setruid -only sets the real userid. -These calls are only permitted to the super-user -or if the argument is the real or effective userid. -.I Setruid -may only be used by the super-user. -.PP -.I Setlogname -sets the login name -returned by -.IR getlogname . -Only the super-user may use this call. -For all of these calls, capability -.B T_UAREA -is required whenever superuser status is required; see -.IR getplab (2). -.PP -Certain ids have predefined uses: -.IP -uid 0 superuser -.br -gid \-1 automatically assigned to /proc files -.SH "SEE ALSO" -.IR getuid (2) -.SH DIAGNOSTICS -.B EFAULT -.RI ( "setlogname " only), -.B EPERM diff --git a/static/v10/man2/signal.2 b/static/v10/man2/signal.2 deleted file mode 100644 index 132c8eb1..00000000 --- a/static/v10/man2/signal.2 +++ /dev/null @@ -1,220 +0,0 @@ -.TH SIGNAL 2 -.CT 2 proc_man -.SH NAME -signal, kill \(mi receive and send signals -.SH SYNOPSIS -.nf -.B #include <signal.h> -.PP -.B SIG_TYP (*signal(sig, func))() -.B SIG_TYP (*func)(); -.PP -.B int kill(pid, sig) -.fi -.SH DESCRIPTION -A signal -is generated by some abnormal event -initiated by a user at a terminal (quit, interrupt), -by a program error (bus error, etc.), -or by -.I kill -in another process. -Normally, most signals -cause termination of the receiving process, -but -.I signal -allows them either to be ignored -or to be caught by interrupting to a specified function. -The following signal names are defined in -.FR <signal.h> : -.LP -.nf -.ta \w'SIGMMMM 'u +\w'15* 'u -\fLSIGHUP\fP 1 hangup -\fLSIGINT\fP 2 interrupt -\fLSIGQUIT\fP 3* quit -\fLSIGILL\fP 4* illegal instruction (not reset when caught) -\fLSIGTRAP\fP 5* trace trap (not reset when caught) -\fLSIGIOT\fP 6* IOT instruction -\fLSIGEMT\fP 7* EMT instruction -\fLSIGFPE\fP 8* floating point exception -\fLSIGKILL\fP 9 kill (cannot be caught or ignored) -\fLSIGBUS\fP 10* bus error -\fLSIGSEGV\fP 11* segmentation violation -\fLSIGSYS\fP 12* bad argument to system call -\fLSIGPIPE\fP 13 write on a pipe with no one to read it -\fLSIGALRM\fP 14 alarm clock -\fLSIGTERM\fP 15 software termination signal - 16 unassigned -\fLSIGSTOP\fP 17+ stop (cannot be caught or ignored) -\fLSIGCONT\fP 19# continue a stopped process -\fLSIGCHLD\fP 20# child has stopped or exited -\fLSIGLAB\fP 26# file descriptor label change (not reset when caught) -.sp -.fi -* places core image in file -.B core -if not caught or ignored -.br -+ suspends process until -.B SIGCONT -or -.BR PIOCRUN ; -see -.IR proc (4) -.br -# ignored if not caught -.PP -Signals 1 through -.BR NSIG -1, -defined in the include file, exist. -Those not listed above have -no conventional meaning in this system. -(Berkeley systems use 1-15 and 17-25.) -.PP -.I Signal -specifies how signal -.I sig -will be handled. -If -.I func -is -.BR SIG_DFL , -the default action listed above is reinstated. -If -.I func -is -.BR SIG_IGN , -the signal will be ignored. -Otherwise the signal will be caught; when the signal occurs, -the function pointed to by -.IR func , -say -.IR catcher (), -defined thus, -.EX -.L - int catcher(sig) { ... } -.EE -will be called with the -signal number as argument. -A return from the function will -continue the process at the point it was interrupted. -.PP -Except as indicated, a signal is reset to -.B SIG_DFL -after being caught. -Thus if it is desired to catch every such signal, -the catching routine must issue another -.I signal -call. -.PP -When a caught signal occurs -during certain system calls, the call terminates prematurely. -In particular this can occur during -.IR read -or -.IR write (2) -on a slow device (like a typewriter, but not a disc); -and during -.I pause -and -.IR wait (2). -The interrupted system call will return error -.BR EINTR . -The user's program may then, if it wishes, re-execute the call. -.PP -Core images are made exactly as if by -.IR creat (2) -and -.IR write (2). -However, no core image will be made for a process -that ever had capability -.BR T_NOCHK -or for a child of such a process until the child -successfully performs -.IR exec (2). -.PP -.I Signal -returns the previous (or initial) -value of -.I func -for the particular signal. -.PP -After a -.IR fork (2) -the child inherits all signal settings. -.IR Exec (2) -resets all caught signals to default action. -.PP -.I Kill -sends signal -.I sig -to the process specified by process id -.I pid. -Signal 0 -has no effect on the target process and may be used to -test the existence of a process. -The success of sending a signal is independent of how the receiving -process treats the signal. -.PP -The effective userid of the sending process must be either 0 -or the effective userid of the receiving process. -.PP -If -.I pid -is 0, the signal is sent to all other processes in the -sender's process group; see -.IR stream (4). -.PP -If -.I pid -is \-1, and the user is the super-user, -the signal is broadcast universally -except to processes 0 (scheduler), -1 (initialization) -and 2 (pageout); see -.IR init (8). -If -.I pid -is less than \-1, -it is negated -and taken as a process group -whose members should receive the signal. -.PP -Processes may send signals to themselves. -.SH FILES -.F core -.SH "SEE ALSO" -.IR kill (1), -.IR setjmp (3) -.SH DIAGNOSTICS -.IR signal : -.B EINVAL -.br -.IR kill : -.BR EINVAL , -.BR EPERM , -.BR ESRCH -.SH BUGS -Unadvertised and unsupported -.I func -and -.I sig -arguments can radically and permanently change the -behavior of signals. -.br -The reason for a trap should be distinguishable by extra arguments -to the signal handler. -.br -If a repeated signal arrives before the last one can be reset, -there is no chance to catch it. -.br -For historical reasons, the return value of -a catcher function is -.BR int ; -it is -.B void -in -.SM ANSI -standard C. diff --git a/static/v10/man2/sleep.2 b/static/v10/man2/sleep.2 deleted file mode 100644 index d74b8f20..00000000 --- a/static/v10/man2/sleep.2 +++ /dev/null @@ -1,31 +0,0 @@ -.pa 1 -.he 'SLEEP (II)'9/4/72'SLEEP (II)' -.ti 0 -NAME sleep -- stop execution for interval -.sp -.ti 0 -SYNOPSIS (seconds in r0) -.br -sys sleep / sleep = 35.; not in assembler -.sp -.ti 0 -DESCRIPTION The -current process is suspended from execution -for the number of seconds specified -by the contents of register 0. -.sp -.ti 0 -SEE ALSO -- -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS Due to the -implementation, -the sleep interval is only -accurate to 256 60ths of a -second (4.26 sec). -Even then, the process is placed -on a low priority queue and must be -scheduled. diff --git a/static/v10/man2/stat.2 b/static/v10/man2/stat.2 deleted file mode 100644 index 03d25626..00000000 --- a/static/v10/man2/stat.2 +++ /dev/null @@ -1,128 +0,0 @@ -.TH STAT 2 -.CT 2 file_inq_creat -.SH NAME -stat, lstat, fstat \(mi get file status -.SH SYNOPSIS -.nf -.B #include <sys/types.h> -.B #include <sys/stat.h> -.PP -.B int stat(name, buf) -.B char *name; -.B struct stat *buf; -.PP -.B int lstat(name, buf) -.B char *name; -.B struct stat *buf; -.PP -.B int fstat(fildes, buf) -.B struct stat *buf; -.fi -.SH DESCRIPTION -.I Stat -puts detailed information about the file -.I name -in a structure whose address is -.IR buf . -.I Lstat -does the same except when -.I name -is a symbolic -link (see -.IR link (2)), -in which case it -supplies information about the link itself. -.I Fstat -does the same for an open file -known by a file descriptor. -.PP -It is unnecessary to have any -permissions at all with respect to -.IR name , -but all directories -leading to the file must be searchable. -.nf -.ta \w'\fLnnnnnnnn\fP'u +\w'\fLunsigned short st_mode; \fP'u -\fLstruct stat -{ - \fLdev_t st_dev;\fR major/minor device numbers for the inode - \fLino_t st_ino;\fP inode number - \fLunsigned short st_mode;\fP file mode encoded as below - \fLshort st_nlink;\fP number of links (not symbolic links) - \fLshort st_uid;\fP uid of owner - \fLshort st_gid;\fP gid of owner - \fLdev_t st_rdev;\fP if special, the major/minor device numbers - \fLoff_t st_size;\fP size in bytes - \fLtime_t st_atime;\fP time file was last read or created - \fLtime_t st_mtime;\fP time file was last written or created - \fLtime_t st_ctime;\fP time file or inode was last written or created -\fL};\fP -.fi -.PP -For reasons of efficiency, -.B st_atime -is not set when a directory -is searched, although this might be more logical. -.PP -The bits in -.B st_mode -are defined by -.nf -.ft L -.ta 12n 22n -.ft P -\fLS_IFMT 0170000\fP file type -\fLS_IFDIR 0040000\fP directory -\fLS_IFCHR 0020000\fP special character device -\fLS_IFBLK 0060000\fP special block device -\fLS_IFREG 0100000\fP regular file -\fLS_IFLNK 0120000\fP symbolic link -\fLS_ISUID 0004000\fP set userid on execution -\fLS_ISGID 0002000\fP set groupid on execution -\fLS_ICCTYP 0007000\fP type of concurrency control -\fLS_ISYNC 0001000\fP 1 writer and n readers (synchronized access) -\fLS_IEXCL 0003000\fP 1 writer or n readers (exclusive access) -\fLS_IAPPEND 0005000\fP append-only file -\fLS_IBLIND 0007000\fP blind directory -\fL 0000400\fP read by owner -\fL 0000200\fP write by owner -\fL 0000100\fP execute (search on directory) by owner -\fL 0000070\fP read, write, execute (search) by group -\fL 0000007\fP read, write, execute (search) by others -.fi -.PP -.B S_IFMT -and -.B S_ICCTYP -are field masks; the other constants encode modes. -Codes contained in the -.B S_IFMT -field are mutually exclusive. -Codes containing bit 01000 are incompatible with other -codes contained in the -.B S_ICCTYP -field. -.PP -.I Fstat, -which reads the inode, -and -.IR write (2) -can be performed on the same file descriptor only if -the security labels of file and process reach the same value -or if the process has capability -.BR T_NOCHK . -.SH "SEE ALSO" -.IR chmod (1), -.IR ls (1), -.IR stat (1), -.IR chmod (2), -.IR filsys (5) -.SH DIAGNOSTICS -.BR EACCES , -.BR EBADF , -.BR EFAULT , -.BR EIO , -.BR ELAB , -.BR ELOOP , -.BR ENOENT , -.BR ENOTDIR diff --git a/static/v10/man2/stime.2 b/static/v10/man2/stime.2 deleted file mode 100644 index c9b521d3..00000000 --- a/static/v10/man2/stime.2 +++ /dev/null @@ -1,24 +0,0 @@ -.pa 1 -.he 'STIME (II)'3/15/72'STIME (II)' -.ti 0 -NAME stime -- set time -.sp -.ti 0 -SYNOPSIS (time in r0-r1) -.br -sys stime / stime = 25. -.sp -.ti 0 -DESCRIPTION stime_____ -sets the system's idea of the time and date. -Only the super-user may use this call. -.sp -.ti 0 -SEE ALSO date(I), time(II) -.sp -.ti 0 -DIAGNOSTICS Error bit (c-bit) -set if user is not the super-user. -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/stty.2 b/static/v10/man2/stty.2 deleted file mode 100644 index eafb34a5..00000000 --- a/static/v10/man2/stty.2 +++ /dev/null @@ -1,94 +0,0 @@ -.pa 1 -.he 'STTY (II)'6/12/72'STTY (II)' -.tr | -.ti 0 -NAME stty -- set mode of typewriter -.sp -.ti 0 -SYNOPSIS (file descriptor in r0) -.br -sys stty; arg / stty = 31. -.br -.li -... -.ti -6 -arg: dcrsr; dctsr; mode -.sp -.ti 0 -DESCRIPTION stty____ -sets mode bits for a typewriter whose file descriptor -is passed in r0. -First, the system delays until the typewriter is quiescent. -Then, the argument dcrsr_____ is placed into the typewriter's -receiver control and status register, -and dctsr_____ is placed in the transmitter control and status register. -The DC-11 manual must be consulted for the format of these -words. -For the purpose of this call, the most important ro^le of -these arguments is to adjust to the speed of the typewriter. -.sp -The mode____ argument contains several bits which determine the -system's treatment of the typewriter: -.sp -.in +3 -.nf -200 even parity allowed on input (e. g. for M37s) -100 odd parity allowed on input -040 raw mode: wake up on all characters -020 map CR into LF; echo LF or CR as LF-CR -010 echo (full duplex) -004 map upper case to lower on input (e. g. M33) -002 echo and print tabs as spaces -001 inhibit all function delays (e. g. CRTs) -.fi -.in -3 -.sp -.fi -Characters with the wrong parity, as determined by bits 200 and -100, are ignored. -.sp -In raw mode, every character is passed back immediately -to the program. No erase or kill processing is done; -the end-of-file character (EOT), the interrupt character -(DELETE) and the quit character (FS) are not treated specially. -.sp -Mode 020 causes input carriage returns to be turned into -new-lines; -input of either CR or LF causes LF-CR both to -be echoed -(used for GE TermiNet 300's and other terminals without the newline function). -.sp -Additional bits in the high order byte of the mode argument -are used to indicate that the terminal is an IBM|2741 -and to specify 2741 modes. -These mode bits are: -.sp -.in+8 -.ll+6 -.ti-6 -|400 terminal is an IBM|2741 -.ti-6 -1000 the 2741 has the transmit interrupt feature (currently ignored) -.ti-6 -2000 use correspondence code conversion on output -.ti-6 -4000 use correspondence code conversion on input (currently ignored) -.sp -.in -8 -.ll-6 -Normal input and output code conversion -for 2741s is EBCDIC (e. g. 963 ball and corresponding keyboard). -The presence of the transmit interrupt feature permits -the system to do read-ahead while no output is in progress. -In 2741 mode, the low order bits 331 are ignored. -.ti0 -.sp -SEE ALSO stty(I), gtty(II) -.sp -.ti 0 -DIAGNOSTICS The error bit -(c-bit) is set if the file descriptor does not refer to a typewriter. -.sp -.ti 0 -BUGS This call should be used with care. -.tr || diff --git a/static/v10/man2/sync.2 b/static/v10/man2/sync.2 deleted file mode 100644 index 6a06efb6..00000000 --- a/static/v10/man2/sync.2 +++ /dev/null @@ -1,27 +0,0 @@ -.pa 1 -.he 'SYNC (II)'6/12/72'SYNC (II)' -.ti 0 -NAME sync -- update super-block -.sp -.ti 0 -SYNOPSIS sys sync / sync = 36.; not in assembler -.sp -.ti 0 -DESCRIPTION sync____ -causes the super block for all file systems to be written out. -It is only necessary on systems in which -this writing may be delayed -for a long time, i.e., those which -incorporate hardware protection facilities. - -It should be used by programs which examine a file system, -for example check, df, tm, etc. -.sp -.ti 0 -SEE ALSO -- -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/syscall.2 b/static/v10/man2/syscall.2 deleted file mode 100644 index c0c895ff..00000000 --- a/static/v10/man2/syscall.2 +++ /dev/null @@ -1,17 +0,0 @@ -.TH SYSCALL 2 -.CT 2 misc -.SH NAME -syscall \(mi indirect system call -.SH SYNOPSIS -.B "int syscall(number, arg, ... )" -.SH DESCRIPTION -.I Syscall -performs the system call with the specified -.I number -and arguments and returns its result. -The numbers may be found in the system source. -.SH BUGS -The simulation fails for system calls -such as -.IR pipe (2), -which return multiple values. diff --git a/static/v10/man2/syslog.2 b/static/v10/man2/syslog.2 deleted file mode 100644 index 0ebc2f4a..00000000 --- a/static/v10/man2/syslog.2 +++ /dev/null @@ -1,113 +0,0 @@ -.TH SYSLOG 2 -.CT 2 file_inq_creat dirs secur -.SH NAME -syslog \- security logging -.SH SYNOPSIS -.B #include <sys/log.h> -.PP -.B int syslog(command, arg2, arg3) -.SH DESCRIPTION -.I Syslog -controls security logging. -The -.I command -argument determines -the meaning of the other arguments. -.LP -Logging is done by writing on special files, described in -.IR log (4). -One of these files is the `system log file' where -the kernel records certain events automatically. -Each process has an `audit mask' that determines which events -cause logging records; mask items are -defined in -.BR <sys/log.h> ; -see -.IR log (5). -Each file has a `poison class' -with value 0, 1, 2, or 3. -The kernel has a table of four corresponding `poison masks' -and a global audit mask. -When a system call mentions a file in a pathname, -the poison mask -corresponding to the file's poison level -is ORed into the process audit mask; -when a process executes a file, the global log mask is -ORed into the process audit mask. -.LP -The forms of the several -.I syslog -commands follow. -Arguments shown as -.BR 0 -are ignored. -.TP -.BI "syslog(LOGON, " " fd ", " x ) -Turn logging on; nominate file descriptor -.I fd -as repository for log file with minor device number -.I x. -.I Fd -must be open -for writing. -Logging will persist after -.I fd -is closed. -.PD0 -.TP -.BI "syslog(LOGOFF, 0, "x" ) -Turn logging off on minor device number -.I x. -.TP -.BI "syslog(LOGGET, " n ", 0) -Return the value of the -.IR n th -poison mask; -.IR n =4 -designates the global audit mask. -.TP -.BI "syslog(LOGSET, " n ", " x ) -Set the -.IR n th -poison mask to -.I x. -.TP -.BI "syslog(LOGFGET, " fd ", 0) -Return the poison level of the file associated with file descriptor -.IR fd , -which may be open for reading or writing. -.TP -.BI "syslog(LOGFSET, " fd ", " x ) -Set the poison level of the file associated with file descriptor -.IR fd , -(which may be open for reading or writing) -to -.I x. -The poison level is stored in field -.B di_label.lb_junk -of the file's inode; see -.IR inode (5). -.TP -.BI "syslog(LOGPGET, " pid ", 0) -Return the audit mask of process -.I pid. -.TP -.BI "syslog(LOGPSET, " pid ", " x ) -Set the audit mask of process -.I pid -to -.I x. -.PD -.PP -.I Syslog -works only in processes with capability -.BR T_LOG ; -see -.IR getplab (2). -.SH "SEE ALSO" -.IR log (4), -.IR log (5), -.IR syslog (8) -.SH DIAGNOSTICS -.L -EBADF, EFAULT, EINVAL, EIO diff --git a/static/v10/man2/time.2 b/static/v10/man2/time.2 deleted file mode 100644 index ca41e35e..00000000 --- a/static/v10/man2/time.2 +++ /dev/null @@ -1,28 +0,0 @@ -.pa 1 -.he 'TIME (II)'3/15/72'TIME (II)' -.ti 0 -NAME time -- get time of year -.sp -.ti 0 -SYNOPSIS sys time / time = 13. -.br -(time r0-r1) -.sp -.ti 0 -DESCRIPTION time____ -returns the time since 00:00:00, Jan. 1, 1972, measured -in sixtieths of a second. -The high order word is in the r0 register and the low order -is in the r1. -.sp -.ti 0 -SEE ALSO date(I), mdate(II) -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS The time -is stored in 32 bits. -This guarantees a crisis every -2.26 years. diff --git a/static/v10/man2/times.2 b/static/v10/man2/times.2 deleted file mode 100644 index 0f8cefe8..00000000 --- a/static/v10/man2/times.2 +++ /dev/null @@ -1,68 +0,0 @@ -.pa 1 -.he 'TIMES(II)'2/10/73'TIMES(II)' -.ti 0 -NAME times -- get process times -.sp -.ti 0 -.nf -SYNOPSIS sys times; buffer / times = 43.; not in assembler -.br -.fi -.li -... -.ti -8 -buffer: .=.+[24.*3] -.sp -.ti 0 -DESCRIPTION times_____ -returns time-accounting information -for the system as a whole, for the current process, -and for the terminated child processes -of the current process. -All the times are 2-word (32-bit) numbers, and the -unit of measurement is 1/60 second. - -After the call, the buffer will appear as follows: - -buffer: -.br -system: - .=.+4 / absolute time - .=.+4 / total system time - .=.+4 / total swap time - .=.+4 / other I/O wait time - .=.+4 / idle time - .=.+4 / total user time - -process: - .=.+4 / (ignore) - .=.+4 / time in system - .=.+4 / (ignore) - .=.+4 / I/O wait time - .=.+4 / (ignore) - .=.+4 / processor time - -child: - .=.+24. - -The format of the "child" times is the same as -that for the process times; the numbers are -the sum of the times for all terminated direct -or indirect descendants of the current process. - -The "absolute" time returned is the same as that -given by time(II). -The "total system times" are times since the last cold -boot. -.sp -.ti 0 -FILES -- -.sp -.ti 0 -SEE ALSO time(II), time(I) -.sp -.ti 0 -DIAGNOSTICS -- -.sp -.ti 0 -BUGS -- diff --git a/static/v10/man2/udbuf.2 b/static/v10/man2/udbuf.2 deleted file mode 100644 index d965be35..00000000 --- a/static/v10/man2/udbuf.2 +++ /dev/null @@ -1,48 +0,0 @@ -.TH UDBUF 2 -.CT 2 file_io file_inq_creat -.SH NAME -udbuf \(mi fetch file name component -.SH SYNOPSIS -.nf -.B #include <sys/types.h> -.B #include <sys/dir.h> -.PP -.B int udbuf(name) -.B char name[DIRSIZ]; -.fi -.SH DESCRIPTION -.I Udbuf -copies the current contents of the user's -.B u.u_dbuf -array into the array -.I name. -This is the most recent filename component decoded by the -kernel subroutine -.BR namei . -It is usually the last component of the filename which was -most -recently presented by the user process to a system call. -If that file name, however, -refered to an entry in a `blind directory' (see -.IR bl (4)) -the kernel may have randomized the name before using it. -.SH "SEE ALSO" -.IR bl (4), -.IR mkunique (3) -.SH DIAGNOSTICS -.L -EFAULT -.SH BUGS -Ill named. -On a VAX the -.I u. -area is in user space, and -the same effect may be had by: -.EX -#include <sys/types.h> -#include <sys/dir.h> -#include <sys/user.h> - -struct user *ua = (struct user *)(0x80000000 - UPAGES*NBPG); -strncpy(name, ua->u_dbuf, DIRSIZ); -.EE diff --git a/static/v10/man2/umask.2 b/static/v10/man2/umask.2 deleted file mode 100644 index 70d9a9f5..00000000 --- a/static/v10/man2/umask.2 +++ /dev/null @@ -1,38 +0,0 @@ -.TH UMASK 2 -.CT 2 file_inq_creat -.SH NAME -umask \(mi set file creation mode mask -.SH SYNOPSIS -.B int umask(complmode) -.SH DESCRIPTION -.I Umask -sets the process mode mask. -The mask modifies the -.I mode -argument of -.IR creat -(see -.IR open (2)), -.IR mkdir (2), -and -.IR mknod (2) -thus: -.L - mode &= (07777 & ~(complmode & 0777)) -.br -In other words, the mask specifies permission bits to be turned off -when files are created. -.PP -The previous value of the mask is returned by the call. -The initial value is set by -.IR login (8), -and may be modified by the -.I umask -command of -.IR sh (1). -The mask is inherited by child processes. -.SH SEE ALSO -.IR open (2), -.IR mkdir (2), -.IR mknod (2), -.IR stat (2) diff --git a/static/v10/man2/umount.2 b/static/v10/man2/umount.2 deleted file mode 100644 index 6a2e6aa6..00000000 --- a/static/v10/man2/umount.2 +++ /dev/null @@ -1,34 +0,0 @@ -.pa 1 -.he 'UMOUNT (II)'3/15/72'UMOUNT (II)' -.ti 0 -NAME umount -- dismount file system -.sp -.ti 0 -.nf -SYNOPSIS sys umount; special / umount = 22. -.fi -.sp -.ti 0 -DESCRIPTION umount______ -announces to the system that special -file special_______ is no longer to contain -a removable file system. -The file associated with the special -file reverts to its ordinary interpretation (see mount_____). - -The user must take -care that all activity on the file system has ceased. -.sp -.ti 0 -SEE ALSO umount(I), mount(II) -.sp -.ti 0 -DIAGNOSTICS Error bit -(c-bit) set if -no -file system was mounted on the special file. -.sp -.ti 0 -BUGS Use -of this call should -be restricted to the super-user. diff --git a/static/v10/man2/unlink.2 b/static/v10/man2/unlink.2 deleted file mode 100644 index 0fc7b023..00000000 --- a/static/v10/man2/unlink.2 +++ /dev/null @@ -1,40 +0,0 @@ -.TH UNLINK 2 -.CT 2 file_inq_creat -.SH NAME -unlink \(mi remove directory entry -.SH SYNOPSIS -.nf -.B int unlink(name) -.B char *name; -.fi -.SH DESCRIPTION -.I Unlink -removes the entry for the file pointed to by -.I name -from its directory. -If this entry was the last link to the file, -the contents of the file are freed and the file is destroyed. -If, however, the file was open in any process, the actual -destruction is delayed until it is closed, even though -the directory entry has disappeared. -.PP -Only the file's owner can unlink -a file in a blind directory -.RI ( stat (2)). -Only the super-user can -.I unlink -a directory, but see -.I rmdir -in -.IR mkdir (2). -.SH "SEE ALSO" -.IR rm (1), -.IR link (2), -.IR mkdir (2) -.SH DIAGNOSTICS -.BR EFAULT , -.BR EIO , -.BR ELOOP , -.BR ENOENT , -.BR ENOTDIR , -.BR EROFS diff --git a/static/v10/man2/unsafe.2 b/static/v10/man2/unsafe.2 deleted file mode 100644 index e458e65e..00000000 --- a/static/v10/man2/unsafe.2 +++ /dev/null @@ -1,59 +0,0 @@ -.TH UNSAFE 2 -.SH NAME -unsafe \- detect potential file security violations -.SH SYNOPSIS -.B #include <sys/types.h> -.PP -.B unsafe(nfd, readfds, writefds) -.br -.B fd_set *readfds, *writefds; -.SH DESCRIPTION -.I Unsafe -examines file descriptors 0 through -.I nfd\-1 -and sets the corresponding bits of the masks in -.I readfds -and -.I writefds -to indicate files that are not known to be safe (i.e. to satisfy -security label rules) for reading or writing respectively. -The bit masks are indexed and manipulated as described in -.IR select (2). -.PP -At the same time, if the process has capability -.BR T_NOCHK -(see -.IR getplab (2)), -all file descriptors indicated by ones among the first -.I nfd -bits of the previous values of -.I readfds -and -.I writefds -are marked safe to read or write respectively. -.PP -Potentially unsafe situations arise from changes in file label caused -by this or other processes, -changes in process label, and file opening. -.PP -To prevent unintended violations of security policy, -programs with capability -.B NOCHK -must monitor label changes. -For this purpose the process label may be frozen (see -.IR getplab (2)) -to prevent unintended automatic label changes. -.B SIGLAB -may be used to detect changes in file labels -(see -.IR signal (2)), -and -.I unsafe -to pinpoint them. -.SH DIAGNOSTICS -.B EFAULT -.SH SEE ALSO -.IR getflab (2), -.IR getplab (2), -.IR signal (2), -.IR select (2) diff --git a/static/v10/man2/vtimes.2 b/static/v10/man2/vtimes.2 deleted file mode 100644 index 5fc5a48f..00000000 --- a/static/v10/man2/vtimes.2 +++ /dev/null @@ -1,51 +0,0 @@ -.TH VTIMES 2 -.CT 2 time_man -.SH NAME -vtimes \- get usage of time, space, and paging resources -.SH SYNOPSIS -.B #include <sys/vtimes.h> -.PP -.B vtimes(par_vm, ch_vm) -.br -.B struct vtimes *par_vm, *ch_vm; -.SH DESCRIPTION -.I Vtimes -places accounting information for the current process in the -area pointed to by -.I par_vm -and for its terminated children in the -area pointed to by -.I ch_vm. -If either pointer -is 0, the corresponding information is omitted. -.PP -After the call, each area contains information in the form -.PP -.EX -.ta \w'struct 'u +\w'unsigned 'u +\w'vm_utime; 'u -struct vtimes { - int vm_utime; /* user time */ - int vm_stime; /* system time */ - /* rss = resident storage size in 512-byte pages */ - unsigned vm_idsrss; /* rss time integral, data+stack */ - unsigned vm_ixrss; /* rss time integral, text */ - int vm_maxrss; /* maximum rss */ - int vm_majflt; /* major page faults */ - int vm_minflt; /* minor page faults */ - int vm_nswap; /* number of swaps */ - int vm_inblk; /* block reads */ - int vm_oublk; /* block writes */ -}; -.EE -.PP -Times are expressed in clock ticks of 1/60 (or 1/50) second. -The time integrals are computed by cumulating the number -of 512-byte pages in use at each clock tick. -.PP -A major page fault involves a disk transfer; a minor -fault gathers page-reference information. -Block reads and writes are file system disk transfers; -blocks found in the buffer pool are not counted. -.SH SEE ALSO -.IR time (2), -.IR exit (2) diff --git a/static/v10/man2/wait.2 b/static/v10/man2/wait.2 deleted file mode 100644 index 1c76ef1a..00000000 --- a/static/v10/man2/wait.2 +++ /dev/null @@ -1,59 +0,0 @@ -.pa 1 -.he 'WAIT (II)'9/4/72'WAIT (II)' -.ti 0 -NAME wait -- wait for process to die -.sp -.ti 0 -SYNOPSIS sys wait / wait = 7. -.br -(process ID in r0) -.br -(termination status/user status in r1) -.sp -.ti 0 -DESCRIPTION wait____ -causes its caller to delay until one of its child -processes terminates. -If any child has died since the last wait____, return is immediate; -if there are no children, return is immediate with -the error bit set. -In the case of several children several wait____s are needed -to learn of all the deaths. -.sp -If the error bit is not set on return, -the r1 high byte contains the low byte of the -child process r0 when it terminated. -The r1 low byte contains the termination status -of the process from the following list: -.sp - 0 exit - 1 bus error - 2 illegal instruction - 3 trace trap - 4 IOT trap - 5 power fail trap - 6 EMT trap - 7 bad system call - 8 PIR interrupt - 9 floating point exception - 10 memory violation - 11 quit - 12 interrupt - 13 kill (see kill(II)) - 14 User I/O (not currently possible) - +16 core image produced -.sp -.ti 0 -SEE ALSO exit(II), fork(II) -.sp -.ti 0 -DIAGNOSTICS error bit -(c-bit) on if no children not previously waited for. -.sp -.ti 0 -BUGS A child -which dies, but is never -waited for consumes -a slot in the process table. -When this table is full, -the system is effectively hung. diff --git a/static/v10/man2/write.2 b/static/v10/man2/write.2 deleted file mode 100644 index 26e8277d..00000000 --- a/static/v10/man2/write.2 +++ /dev/null @@ -1,54 +0,0 @@ -.TH WRITE 2 -.CT 2 file_io comm_proc -.SH NAME -write \(mi write on a file -.SH SYNOPSIS -.nf -.B int write(fildes, buffer, nbytes) -.B char *buffer; -.fi -.SH DESCRIPTION -.I Write -writes -.I nbytes -bytes of data starting at -.I buffer -to the file associated with -.I fildes -at the file pointer location. -The file pointer is advanced by the number of bytes written. -.PP -The number of characters actually written is returned. -It should be regarded as an error -if this is not the same as requested. -.PP -If -.IR fildes -refers to an append-only file (see -.IR stat (2)), -the file pointer is set to the end of the -file before writing. -.PP -Writes which are aligned with file system blocks -are more efficient than others; see -.IR filsys (5). -.SH "SEE ALSO" -.IR creat (2), -.IR open (2), -.IR pipe (2), -.IR select (2) -.SH DIAGNOSTICS -.BR EBADF , -.BR EFAULT , -.BR EINTR , -.BR EINVAL , -.BR EIO , -.BR ELAB , -.BR ENXIO , -.BR EPIPE , -.BR EROFS -.SH BUGS -A -.I write -call may fail because of a prior call to -.IR lseek . |
