![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to jx.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1|
Return to jx.1 CVS log | Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1 |
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.