Initial checkin

This commit is contained in:
gdr 1996-02-10 17:08:10 +00:00
parent d23148604d
commit 9da81eb718
3 changed files with 125 additions and 0 deletions

27
usr.bin/launch/launch.1 Normal file
View File

@ -0,0 +1,27 @@
.TH LAUNCH 1
.SH NAME
launch \- adds application to the GS/OS quit stack
.SH DESCRIPTION
.B launch
programs that are not fully compatible wth GNO, such as ProSEL 16 and ProDOS 8 applications.
.LP
Once it's added to the quit stack, you can execute the program by
.BR "exit" " if you ran gsh straight from initrc. If you are using init,"
.RB "type " "init 5" ". "
You will probably want to make aliases for them in gshrc for convenience.
.SH SYNOPSIS
.BR launch " [-n] <filename>"
.LP
.BR filename " is the full path name of program -- no namespace."
.LP
.BR -n " do not add GNO to the quit stack; upon exiting the launched"
application, you will return to the application that launched GNO.
.SH EXAMPLES
alias pt 'launch /diskname/proterm/pt3.system;exit'
.br
alias pt 'launch /diskname/proterm/pt3.system;init 5'
.SH AUTHOR
.LP
.nf
Jawaid Bazyar (bazyar@cs.uiuc.edu)
.fi

27
usr.man/man1/launch.1 Normal file
View File

@ -0,0 +1,27 @@
.TH LAUNCH 1
.SH NAME
launch \- adds application to the GS/OS quit stack
.SH DESCRIPTION
.B launch
programs that are not fully compatible wth GNO, such as ProSEL 16 and ProDOS 8 applications.
.LP
Once it's added to the quit stack, you can execute the program by
.BR "exit" " if you ran gsh straight from initrc. If you are using init,"
.RB "type " "init 5" ". "
You will probably want to make aliases for them in gshrc for convenience.
.SH SYNOPSIS
.BR launch " [-n] <filename>"
.LP
.BR filename " is the full path name of program -- no namespace."
.LP
.BR -n " do not add GNO to the quit stack; upon exiting the launched"
application, you will return to the application that launched GNO.
.SH EXAMPLES
alias pt 'launch /diskname/proterm/pt3.system;exit'
.br
alias pt 'launch /diskname/proterm/pt3.system;init 5'
.SH AUTHOR
.LP
.nf
Jawaid Bazyar (bazyar@cs.uiuc.edu)
.fi

71
usr.man/man2/fork2.2 Normal file
View File

@ -0,0 +1,71 @@
.TH FORK2 2
.SH NAME
fork2 \- start a new process from inside the current application
.SH SYNOPSIS
#include <unistd.h>
.sp 1
int
.BR fork2
.RI " (void *" proc ,
word
.IR stack ,
word
.IR prio ", char *" procname ,
word
.IR numargs ", ...);"
.SH DESCRIPTION
.B fork2
is similar to
.BR fork (2),
except that it allows more parameters to be passed than just function
which the child process will execute.
.LP
.I proc
is the name of the function at which the child process will begin execution.
.I stack
is the number of bytes of stack to allocate to the proess. If
.I stack
is not a multiple of 256, then it
is rounded up to the next highest multiple of 256 bytes.
.I prio
is the priority to assign to the process. Priorities are not currently
implemented, and you should pass 0 for this argument.
.I procname
is a string you can have associated with the process when viewing
the process table (See
.BR ps (1)).
.I numargs
is the number of
.B words
of arguments which follow, not the
number of arguments.
Any arguments following
.I numargs
are passed as parameters to the child's procedure.
.SH EXAMPLE
.nf
int main (int argc, char **argv) {
...
pid = fork2(proc1,1024,0,"sub-process",3,argc,argv);
...
return 0;
}
void proc1(int argc, char *argv[])
{
...
}
.fi
.SH "RETURN VALUE"
.BR fork2
returns to the parent the process ID of the new process on success.
On failure, -1 is returned and
.B errno
is set.
.SH HISTORY
.B fork2
first appeared in XINU.