Return to putc.3 CVS log

Up to [Research Unix] / researchv10dc / dist / man / v4 / man3

Annotation of researchv10dc/dist/man/v4/man3/putc.3, revision 1.1

1.1     ! root        1: .th PUTC III 6/12/72
        !             2: .sh NAME
        !             3: putc  \*-  buffered output
        !             4: .sh SYNOPSIS
        !             5: .ft B
        !             6: .nf
        !             7: mov    $filename,r0
        !             8: jsr    r5,fcreat; iobuf
        !             9: .s3
        !            10: fcreat(file, iobuf)
        !            11: char *file;
        !            12: struct buf *iobuf;
        !            13: .s3
        !            14: .ft R
        !            15: (get byte in r0)
        !            16: .ft B
        !            17: jsr    r5,putc; iobuf
        !            18: .s3
        !            19: putc(c, iobuf)
        !            20: int c;
        !            21: struct buf *iobuf;
        !            22: .s3
        !            23: .ft R
        !            24: (get word in r0)
        !            25: .ft B
        !            26: jsr    r5,putw; iobuf
        !            27: .s3
        !            28: [putw not available from C]
        !            29: .s3
        !            30: jsr    r5,flush; iobuf
        !            31: .s3
        !            32: fflush(iobuf)
        !            33: struct buf *iobuf;
        !            34: .fi
        !            35: .ft R
        !            36: .sh DESCRIPTION
        !            37: .it Fcreat
        !            38: creates
        !            39: the given file (mode 666) and sets up the buffer
        !            40: .it iobuf
        !            41: (size 518 bytes);
        !            42: .it putc
        !            43: and
        !            44: .it putw
        !            45: write a byte or word respectively
        !            46: onto the file;
        !            47: .it flush
        !            48: forces the contents of the buffer to be written, but
        !            49: does not close the file.
        !            50: The format of the buffer is:
        !            51: .s3
        !            52: .nf
        !            53: .ft B
        !            54: iobuf: .=.+2           / file descriptor
        !            55:        .=.+2           / characters unused in buffer
        !            56:        .=.+2           / ptr to next free character
        !            57:        .=.+512.        / buffer
        !            58: .ft R
        !            59: .s3
        !            60: Or in C,
        !            61: .s3
        !            62: .ft B
        !            63: .nf
        !            64: struct buf {
        !            65:        int fildes;
        !            66:        int nunused;
        !            67:        char *nxtfree;
        !            68:        char buff[512];
        !            69: };
        !            70: .ft R
        !            71: .fi
        !            72: .s3
        !            73: .it Fcreat
        !            74: sets the error bit (c-bit) if the 
        !            75: file creation failed (from C, returns \*-1); none of the other routines
        !            76: returns error information.
        !            77: .s3
        !            78: Before terminating, a program should call
        !            79: .it flush
        !            80: to force out the last of the output
        !            81: .it (fflush
        !            82: from C).
        !            83: .s3
        !            84: The user must supply
        !            85: .it iobuf,
        !            86: which should begin on a word boundary.
        !            87: .s3
        !            88: To write a new file using the same buffer, it
        !            89: suffices to call
        !            90: .it [f]flush,
        !            91: close the file,
        !            92: and
        !            93: call
        !            94: .it fcreat
        !            95: again.
        !            96: .sh "SEE ALSO"
        !            97: creat(II), write(II), getc(III)
        !            98: .sh DIAGNOSTICS
        !            99: error bit possible 
        !           100: on
        !           101: .it fcreat
        !           102: call.
        !           103: .sh BUGS

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.