Return to Subprocess.h CVS log

Up to [NeXTSTEP 3.3 examples] / Examples / UNIX / Subprocess

Annotation of Examples/UNIX/Subprocess/Subprocess.h, revision 1.1.1.1

1.1       root        1: /*
                      2:        Subprocess.h    (v10)
                      3:        by Charles L. Oei
                      4:        pty support by Joe Freeman
                      5:        with encouragement from Kristofer Younger
                      6:        Subprocess Example, Release 2.0
                      7:        NeXT Computer, Inc.
                      8: 
                      9:        You may freely copy, distribute and reuse the code in this example.
                     10:        NeXT disclaims any warranty of any kind, expressed or implied, as to
                     11:        its fitness for any particular use.
                     12: */
                     13: 
                     14: #import <objc/Object.h>
                     15: #import <stdio.h>
                     16: 
                     17: /*
                     18:     This subprocess object sends/receives data to/from any UNIX
                     19:     subprocess asynchronously (via vfork/pipe).
                     20:     Its delegate, if any, will receive the following messages:
                     21: 
                     22:        - subprocessDone;
                     23:            // sent when the subprocess exits
                     24:     
                     25:        - subprocessOutput:(char *)buffer;
                     26:            // sent whenever there is data on the standard output pipe;
                     27:            // buffer is only valid until next call
                     28:        
                     29:        - subprocessError:(const char *)errorString;
                     30:            // sent when an error occurs;
                     31:            // if it ever happens, it's usually only at startup time
                     32: */
                     33: 
                     34: 
                     35: #define BUFFERSIZE 2048
                     36: 
                     37: @interface Subprocess:Object
                     38: {
                     39:     FILE *fpToChild;
                     40:     int fromChild;
                     41:     int childPid;
                     42:     id delegate;
                     43:     int masterPty;     // file descriptor for master/slave pty
                     44:     int slavePty;
                     45:     int bufferCount;
                     46:     char outputBuffer[BUFFERSIZE];
                     47: }
                     48: 
                     49: - init:(const char *)subprocessString;
                     50:     // a cover for the below withDelegate:nil, andPtySupport:NO, andStdErr:YES
                     51: 
                     52: - init:(const char *)subprocessString
                     53:     withDelegate:theDelegate
                     54:     andPtySupport:(BOOL)wantsPty
                     55:     andStdErr:(BOOL)wantsStdErr;
                     56:     // optional requests for pseudo terminal support and
                     57:     // redirecting the standard error stream thru standard output
                     58: 
                     59: - send:(const char *)string withNewline:(BOOL)wantNewline;
                     60:     // send the string optionally followed by a new line
                     61: - send:(const char *)string;
                     62:     // sends the string followed by a new line
                     63:     // shorthand for above withNewline:YES
                     64: - terminateInput;
                     65:     // sends an end-of-file (EOF) to the subprocess
                     66:     // (and closes input pipe to child)
                     67: - terminate:sender;
                     68:     // forces the subprocess to terminate (w/ SIGTERM)
                     69: 
                     70: - setDelegate:anObject;
                     71: - delegate;
                     72: 
                     73: @end

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