KIBITZ(1) UNIX System V (19 October 1994) KIBITZ(1)
NAME
kibitz - allow two people to interact with one shell
SYNOPSIS
kibitz [ kibitz-args ] user [ program program-args... ]
kibitz [ kibitz-args ] user@host [ program program-args... ]
INTRODUCTION
kibitz allows two (or more) people to interact with one
shell (or any arbitrary program). Uses include:
o A novice user can ask an expert user for help.
Using kibitz, the expert can see what the user is
doing, and offer advice or show how to do it right.
o By running kibitz and then starting a full-screen
editor, people may carry out a conversation,
retaining the ability to scroll backwards, save the
entire conversation, or even edit it while in
progress.
o People can team up on games, document editing, or
other cooperative tasks where each person has
strengths and weaknesses that complement one
another.
USAGE
To start kibitz, user1 runs kibitz with the argument of the
user to kibitz. For example:
kibitz user2
kibitz starts a new shell (or another program, if given on
the command line), while prompting user2 to run kibitz. If
user2 runs kibitz as directed, the keystrokes of both users
become the input of the shell. Similarly, both users
receive the output from the shell.
To terminate kibitz it suffices to terminate the shell
itself. For example, if either user types ^D (and the shell
accepts this to be EOF), the shell terminates followed by
kibitz.
Normally, all characters are passed uninterpreted. However,
if the escape character (described when kibitz starts) is
issued, the user may talk directly to the kibitz
interpreter. Any Expect(1) or Tcl(3) commands may be given.
Also, job control may be used while in the interpreter, to,
for example, suspend or restart kibitz.
Various processes can provide various effects. For example,
you can emulate a two-way write(1) session with the command:
Page 1 (printed 12/23/98)
KIBITZ(1) UNIX System V (19 October 1994) KIBITZ(1)kibitz user2 sleep 1000000
ARGUMENTS
kibitz takes arguments, these should also be separated by
whitespace.
The -noproc flag runs kibitz with no process underneath.
Characters are passed to the other kibitz. This is
particularly useful for connecting multiple interactive
processes together. In this mode, characters are not echoed
back to the typist.
-noescape disables the escape character.
-escape char sets the escape character. The default escape
character is ^].
-silent turns off informational messages describing what
kibitz is doing to initiate a connection.
-tty ttyname defines the tty to which the invitation should
be sent.
If you start kibitz to user2 on a remote computer, kibitz
performs a rlogin to the remote computer with your current
username. The flag -proxy username causes rlogin to use
username for the remote login (e.g. if your account on the
remote computer has a different username). If the -proxy
flag is not given, kibitz tries to determine your current
username by (in that order) inspecting the environment
variables USER and LOGNAME, then by using the commands
whoami and logname.
The arguments -noescape and -escape can also be given by
user2 when prompted to run kibitz.
MORE THAN TWO USERS
The current implementation of kibitz explicitly understands
only two users, however, it is nonetheless possible to have
a three (or more) -way kibitz, by kibitzing another kibitz.
For example, the following command runs kibitz with the
current user, user2, and user3:
% kibitz user2 kibitz user3
Additional users may be added by simply appending more
"kibitz user" commands.
The xkibitz script is similar to kibitz but supports the
ability to add additional users (and drop them) dynamically.
Page 2 (printed 12/23/98)
KIBITZ(1) UNIX System V (19 October 1994) KIBITZ(1)
CAVEATS
kibitz assumes the 2nd user has the same terminal type and
size as the 1st user. If this assumption is incorrect,
graphical programs may display oddly.
kibitz handles character graphics, but cannot handle
bitmapped graphics. Thus,
% xterm -ekibitz will work
% kibitz xterm will not work
However, you can get the effect of the latter command by
using xkibitz (see SEE ALSO below). kibitz uses the same
permissions as used by rlogin, rsh, etc. Thus, you can only
kibitz to users at hosts for which you can rlogin.
Similarly, kibitz will prompt for a password on the remote
host if rlogin would.
If you kibitz to users at remote hosts, kibitz needs to
distinguish your prompt from other things that may precede
it during login. (Ideally, the end of it is preferred but
any part should suffice.) If you have an unusual prompt,
set the environment variable EXPECT_PROMPT to an egrep(1)-
style regular expression. Brackets should be preceded with
one backslash in ranges, and three backslashes for literal
brackets. The default prompt r.e. is "($|%|#) ".
kibitz requires the kibitz program on both hosts. kibitz
requires expect(1).
By comparison, the xkibitz script uses the X authorization
mechanism for inter-host communication so it does not need
to login, recognize your prompt, or require kibitz on the
remote host. It does however need permission to access the
other X servers.
BUGS
An early version of Sun's tmpfs had a bug in it that causes
kibitz to blow up. If kibitz reports "error flushing ...:
Is a directory" ask Sun for patch #100174.
If your Expect is not compiled with multiple-process support
(i.e., you do not have a working select or poll), you will
not be able to run kibitz.
ENVIRONMENT
The environment variable SHELL is used to determine the
shell to start, if no other program is given on the command
line.
If the environment variable EXPECT_PROMPT exists, it is
taken as a regular expression which matches the end of your
Page 3 (printed 12/23/98)
KIBITZ(1) UNIX System V (19 October 1994) KIBITZ(1)
login prompt (but does not otherwise occur while logging
in). See also CAVEATS above.
If the environment variables USER or LOGNAME are defined,
they are used to determine the current user name for a
kibitz to a remote computer. See description of the -proxy
option in ARGUMENTS above.
SEE ALSO
Tcl(3), libexpect(3), xkibitz(1)
"Exploring Expect: A Tcl-Based Toolkit for Automating
Interactive Programs" by Don Libes, O'Reilly and Associates,
January 1995.
"Kibitz - Connecting Multiple Interactive Programs
Together", by Don Libes, Software - Practice & Experience,
John Wiley & Sons, West Sussex, England, Vol. 23, No. 5,
May, 1993.
AUTHOR
Don Libes, National Institute of Standards and Technology
kibitz is in the public domain. NIST and I would appreciate
credit if this program or parts of it are used.
Page 4 (printed 12/23/98)
