Return to sendchar.3r CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / p_man / man3

Annotation of researchv10dc/630/man/src/p_man/man3/sendchar.3r, revision 1.1.1.1

1.1       root        1: .ds ZZ DEVELOPMENT PACKAGE
                      2: .TH SENDCHAR 3R "630 MTG"
                      3: .XE "sendchar()"
                      4: .XE "sendnchars()"
                      5: .SH NAME
                      6: sendchar, sendnchars \- send character(s) to host
                      7: .SH SYNOPSIS
                      8: \f3
                      9: int sendchar (c)
                     10: .br
                     11: char c;
                     12: .sp
                     13: void sendnchars (n, p)
                     14: .br
                     15: int n;
                     16: .br
                     17: char \(**p;
                     18: \fR
                     19: .SH DESCRIPTION
                     20: The
                     21: .I sendchar
                     22: function
                     23: sends a single byte to the host
                     24: which will normally be read on the standard input of the host process.
                     25: The bytes sent will be processed as though they were typed on the
                     26: keyboard by the user.
                     27: .PP
                     28: Since local programs have no host connection, a call to
                     29: .I sendchar
                     30: by a local program will always return -1.
                     31: Sendchar will always return 1 for non-local programs.
                     32: .PP
                     33: The
                     34: .I sendnchars
                     35: function is similar to 
                     36: .I sendchar
                     37: except
                     38: .I n
                     39: characters pointed to by
                     40: .I p
                     41: are sent to the host.
                     42: .PP
                     43: A call to
                     44: .I sendchar
                     45: or 
                     46: .I sendnchars
                     47: by an application program causes the bytes to be sent to the host computer to
                     48: be placed into a buffer in the terminal. The terminal will then send the bytes
                     49: in the buffer to the host as fast
                     50: as the communication line to the host is able to transmit.
                     51: An application program is generally able to queue requests to
                     52: send bytes to the host much faster than the terminal is able
                     53: to actually send the bytes over the communication line to the host.
                     54: So, if an application rapidly sends many bytes to the host,
                     55: internal terminal buffers eventually fill up. When this happens,
                     56: the
                     57: .I sendchar
                     58: and
                     59: .I sendnchars
                     60: routines will call
                     61: .I wait
                     62: to block the calling process until internal buffers are no longer full.
                     63: This whole process is transparent to applications, but application program
                     64: writers may want to be aware that a call to
                     65: .I sendchar
                     66: or 
                     67: .I sendnchars
                     68: may not return immediately.
                     69: .SH EXAMPLE
                     70: The following program will send a
                     71: .I ls
                     72: command to the host and display its output.
                     73: Typing a 'q' on the keyboard will cause the program to exit.
                     74: .PP
                     75: .RS 3
                     76: .nf
                     77: .ft CM
                     78: #include <dmd.h>
                     79: 
                     80: main()
                     81: {
                     82:        int c;
                     83: 
                     84:        request(SEND|RCV|KBD);
                     85:        sendnchars(3, "ls\er");
                     86:        do {
                     87:                wait(RCV|KBD);
                     88:                while( (c=rcvchar()) != -1 )
                     89:                        lputchar(c);
                     90:        } while(kbdchar() != 'q');
                     91: }
                     92: \fR
                     93: .fi
                     94: .RE
                     95: .SH SEE ALSO
                     96: local(3R), rcvchar(3R), resources(3R).

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