Return to jx.1 CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1

Annotation of researchv10dc/630/man/src/u_man/man1/jx.1, revision 1.1

1.1     ! root        1: .ds ZZ DEVELOPMENT PACKAGE
        !             2: .TH JX 1 "630 MTG"
        !             3: .SH NAME
        !             4: jx \- 630 MTG execution and stdio interpreter
        !             5: .SH SYNOPSIS
        !             6: .B jx
        !             7: [\fB \-d \fR] [\fB \-p \fR] [\fB \-z \fR] [ \fB\-f\fR ] [ \fB\-Z\fR n ] [ \fB\-n\fR ] file
        !             8: .br
        !             9: [ command line arguments]
        !            10: .SH DESCRIPTION
        !            11: The
        !            12: .I jx
        !            13: utility
        !            14: downloads the program in
        !            15: .I file
        !            16: to the 630 MTG
        !            17: and runs it there, simulating most of the standard I/O library
        !            18: functions.
        !            19: This gives application programs downloaded into the 630 MTG the ability
        !            20: to perform operations such as file I/O to files resident on the host
        !            21: computer, using the same interface as programs
        !            22: written for execution on the host computer.
        !            23: .PP
        !            24: The jx utility calls 
        !            25: .I dmdld 
        !            26: to do the download into the terminal. Therefore, the 
        !            27: \f2-d\f1, \f2-p\f1, \f2-z\f1, \f2-f\f1, \f2-Z\f1, and \f2-n\f1 
        !            28: options are available for use with \f2jx\f1. See the 
        !            29: .I dmdld(1) 
        !            30: manual page for information on these options.
        !            31: .PP
        !            32: \fIStdin\fR directed to the host portion of \f2jx\f1, either through the \f2jx\f1
        !            33: command line or with the \fIpopen\fR function, is properly redirected.
        !            34: Note that input from the 630 MTG keyboard is not translated to \fIstdin\fR
        !            35: to the host portion of \f2jx\f1. Rather, programs wishing to read from the
        !            36: keyboard should use \fIkbdchar\fR(3R).
        !            37: .PP
        !            38: .I Stdout
        !            39: and \fIstderr\fR, written to by the below library functions,
        !            40: will be stored in a buffer during execution.
        !            41: After the terminal program has
        !            42: been rebooted,
        !            43: .I stdout
        !            44: and
        !            45: .I stdin
        !            46: will be redirected to the terminal.
        !            47: .PP
        !            48: Programs intended for use by
        !            49: .I jx
        !            50: should include \f3<dmd.h>\f1 and <\f3dmdio.h\f1>
        !            51: and call \fIexit\fR(3R) upon termination.  \fIExit\fR() returns control to
        !            52: the shell and causes a reboot of
        !            53: the default terminal emulator.
        !            54: .PP
        !            55: What follows is a list of
        !            56: stdio library functions available under \fIjx\fR.
        !            57: These functions are called
        !            58: from an application downloaded into the 630 MTG
        !            59: by \f2jx\f1. The \f2jx\f1 library routines in the terminal then
        !            60: translate the call into a message which is sent to the host portion
        !            61: of \f2jx\f1 for processing.
        !            62: .sp
        !            63: .TS
        !            64: center;
        !            65: l l l l.
        !            66: getc   getchar fgets   fflush
        !            67: .sp
        !            68: putc   putchar puts    fputs
        !            69: .sp
        !            70: fopen  freopen fclose  access
        !            71: .sp
        !            72: popen  pclose  fread   fwrite
        !            73: .sp
        !            74: printf Printf  fprintf Fprintf
        !            75: .TE
        !            76: .sp
        !            77: The functions fprintf and printf are stripped down versions of
        !            78: those on UNIX. The functions that start with an upper case
        !            79: letter are identical to those on UNIX. See printf(3L) for more
        !            80: details.
        !            81: .bp
        !            82: .SH FILES
        !            83: .nf
        !            84: $DMD/include/dmdio.h
        !            85: 
        !            86: $DMD/lib/sysint                host portion of \f2jx\f1 after download is complete
        !            87: 
        !            88: $HOME/.jxout                   saved standard output
        !            89: 
        !            90: $HOME/.jxerr                   saved standard diagnostic output
        !            91: .fi
        !            92: .SH SEE ALSO
        !            93: dmdld(1), exit(3R), kbdchar(3R), printf(3L).
        !            94: .br
        !            95: access(2),
        !            96: fopen(3S),
        !            97: fread(3S),
        !            98: getc(3S),
        !            99: popen(3S),
        !           100: printf(3S),
        !           101: putc(3S),
        !           102: puts(3S) in the
        !           103: \f2UNIX System V Programmer's Reference Manual\f1.
        !           104: .SH WARNING
        !           105: .P
        !           106: Because 630 MTG keyboard data is not sent to the \f2stdin\f1 of the
        !           107: host component of \f2jx\f1, applications running under \f2jx\f1 which read
        !           108: from the \f2stdin\f1 will hang if their \f2stdin\f1 is not redirected.
        !           109: .P
        !           110: The \f2stdin\f1 can be redirected either from the command line or by
        !           111: function calls inside the application process running on the
        !           112: 630 MTG terminal.
        !           113: .SH BUGS
        !           114: .I Jx
        !           115: does not work when su'ed to another user.
        !           116: .P
        !           117: .I Jx
        !           118: does not work in the nonlayers environment.
        !           119: .P
        !           120: \fIJx\fR does not work with application cached with
        !           121: \fBA_SHARED\fR, \fBA_BSS\fR or \fBA_DATA\fR.
        !           122: .P
        !           123: \fIStderr\fR is buffered. Use fflush (stderr) if this is a
        !           124: problem.
        !           125: .P
        !           126: \fIgetc(), getchar(), putc()\fR, and \fIputchar()\fR are not
        !           127: macros as described in \fIgetc(3S)\fR and \fIputc(3S)\fR.
        !           128: .P
        !           129: The \fIfopen()\fR routine does not support the following
        !           130: modes: r+, w+, a+.

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