diff options
Diffstat (limited to 'static/v10/man3/salloc.3')
| -rw-r--r-- | static/v10/man3/salloc.3 | 160 |
1 files changed, 0 insertions, 160 deletions
diff --git a/static/v10/man3/salloc.3 b/static/v10/man3/salloc.3 deleted file mode 100644 index 39f9ff6d..00000000 --- a/static/v10/man3/salloc.3 +++ /dev/null @@ -1,160 +0,0 @@ -.pa 1 -.he 'SALLOC (III)'6/15/72'SALLOC (III)' -.ti 0 -.nf -NAME salloc -- string manipulation routines -.fi -.sp -.ti 0 -.nf -SYNOPSIS (get size in r0) -.br -jsr pc,allocate -.sp -(get source pointer in r0, -destination pointer in r1) -jsr pc,copy -.sp -jsr pc,wc -.sp -(all following instructions assume r1 contains pointer) - -jsr pc,release - -(get character in r0) -jsr pc,putchar -.sp -jsr pc,lookchar -(character in r0) - -jsr pc,getchar -(character in r0) - -(get character in r0) -jsr pc,alterchar - -(get position in r0) -jsr pc,seekchar - -jsr pc,backspace -(character in r0) - -(get word in r0) -jsr pc,putword - -jsr pc,lookword -(word in r0) - -jsr pc,getword -(word in r0) - -(get word in r0) -jsr pc,alterword - -jsr pc,backword -(word in r0) - -jsr pc,length -(length in r0) - -jsr pc,position -(position in r0) - -jsr pc,rewind - -jsr pc,create - -jsr pc,fsfile - -jsr pc,zero - -.fi -.ti 0 -DESCRIPTION This package is a complete set of routines -for dealing with almost arbitrary -length strings of words and bytes. -The strings are stored on a disk file, so the sum of -their lengths can be considerably larger than -the available core. - -For each string there is a header of four words, namely -a write pointer, a read pointer and pointers to the beginning and end of -the block containing the string. -Initially the read and write pointers point to the beginning of the string. -All routines that refer to a string require the header address in r1. -Unless the string is destroyed by the call, -upon return r1 will point to the same string, although -the string may have grown to the extent that it had to be -be moved. - -.ul -allocate -obtains a string of the requested size and returns -a pointer to its header in r1. -.sp -release_______ releases a string back to free storage. -.sp -putchar_______ and putword_______ write a byte or word respectively into the string -and advance the write pointer. - -.ul -lookchar -and -.ul -lookword -read -a byte or word respectively from the string but do not advance the read pointer. - -getchar_______ and getword_______ read a byte or word respectively from the string and advance the read pointer. - -alterchar_________ and alterword_________ write a byte or word respectively into the string where the read pointer -is pointing and advance the read pointer. - -backspace_________ and backword________ read the last byte or word written and decrement the write pointer. - -All write operations will automatically get a larger block if the current block is exceeded. -All read operations return with the error bit set if attempting to read beyond the write pointer. -.sp -seekchar________ moves the read pointer to the offset specified in r0. - -length______ returns the current length of the string (beginning pointer to write pointer) in r0. - -position________ returns the current offset of the read pointer in r0. - -rewind______ moves the read pointer to the beginning of the string. - -create______ returns the read and write pointers to the beginning of the string. - -fsfile______ moves the read pointer to the current position of the write pointer. - -zero____ zeros the whole string and sets the write pointer to the beginning of the string. - -copy____ copies the string whose header pointer is in r0 to the string whose header pointer is in -r1. -Care should be taken in using the copy instruction since r1 will be changed if the contents of the source string -is bigger than the destination string. - -wc__ forces the contents of the internal buffers and the header blocks to be written on disc. -.sp -.ti 0 -FILES The allocator is in -/lib/libs.a; -the -s__ option to ld__ will link edit -references to the allocator. - -alloc.d is the temporary file used to contain -the strings. - -.ti 0 -SEE ALSO -- -.sp -.ti 0 -DIAGNOSTICS "error in copy" if a disk write error occurs during the execution of the copy instruction. -"error in allocator" if any routine is called with a bad header pointer. -"Cannot open output file" if file alloc.d cannot be created or opened. -"Out of space" if there's no available block of the requested size or no headers available for a new block. -.sp -.fi -.in16 -.ti 0 -BUGS -- |