Return to peel.3r CVS log

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

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

1.1       root        1: .ds ZZ DEVELOPMENT PACKAGE
                      2: .TH PEEL 3R "630 MTG"
                      3: .XE "peel()"
                      4: .SH NAME
                      5: peel \- make process local and create new process
                      6: .SH SYNOPSIS
                      7: .B #include <dmd.h>
                      8: .sp
                      9: .B Proc \(**peel (dstrect, flag)
                     10: .br
                     11: .B Rectangle dstrect;
                     12: .br
                     13: .B int flag;
                     14: .SH DESCRIPTION
                     15: .PP
                     16: The \fIpeel\fP function is an uncommon feature that allows a process
                     17: to be made local and reshaped (or moved). The  \f2peel\f1
                     18: function then creates a new
                     19: process that uses the previous process's window and host connection.
                     20: The rectangle \fIdstrect\fP defines the new window (display) to be used by
                     21: the peeled local process.  The
                     22: remaining window is associated with a new process that takes on the
                     23: status of the connection of the previous process.
                     24: .PP
                     25: If argument \f2flag\f1 is zero, the terminal's default process
                     26: is started in the old window.
                     27: If argument \f2flag\f1 has a non-zero value, the process that is
                     28: used to replace the peeled process is another invocation of
                     29: the same process. 
                     30: The process must be cached to do this.
                     31: .PP
                     32: The peeled process will have its \fIP->state\fP variable updated.
                     33: If the \fIdstrect\fP rectangle is the same size
                     34: as the original window, both the MOVED and RESHAPED bits
                     35: will be set; otherwise, just the RESHAPED bit is set.  If the MOVED bit
                     36: is set, the new window will have the contents of the old window
                     37: copied into it.
                     38: Otherwise, it is the responsibility of the peeled process to draw the new window's
                     39: contents.
                     40: The old window is always cleared.
                     41: .PP
                     42: The function will return -1 if it failed due to a lack of memory.
                     43: It will return 0 if it failed because dstrect is smaller than 32x32.
                     44: Otherwise, it will return a pointer to the newly created process
                     45: running in the old window.
                     46: .SH EXAMPLE
                     47: .PP
                     48: The following example shows how a process can peel itself and
                     49: leave behind the default terminal process.
                     50: The rectangle \fIdstrect\fP is specified through the mouse interface
                     51: that allows the user to position or sweep out a rectangle using a
                     52: default size as specified by the rectangle of the window or a new size
                     53: using the mouse and button 2.
                     54: .PP
                     55: .RS 3
                     56: .nf
                     57: .ft CM
                     58: #include <dmd.h>
                     59: Proc *peel();
                     60: Rectangle newrect();
                     61: 
                     62: int
                     63: peelme()
                     64: {
                     65:    Proc *p;
                     66: 
                     67:    p = peel(newrect(2, display.rect), 0);
                     68:    if(p == (Proc *)-1)
                     69:       msgbox("no memory", (char *)0);
                     70:    else if(p == (Proc *)0)
                     71:       msgbox("swept window too small", (char *)0);
                     72:    return((long)p > 0);
                     73: }
                     74: \fR
                     75: .fi
                     76: .RE
                     77: \s+1
                     78: .SH SEE ALSO
                     79: cache(3L), local(3R), state(3R).

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