(Abbreviated) README file from MBONE utility "sd"

Richard Smith (cu-seeme-l@cornell.edu)
Tue, 4 Oct 1994 14:39:53 -0400


v1.0beta Sat Nov 14 23:15:03 PST 1992
Van Jacobson, van@ee.lbl.gov

This is the first release of the LBL "Session Directory" (sd).

Sd provides:

- A dynamically updated list of available sessions (e.g., vat
audio conferences, nv or ivs video conferences,
LBL whiteboard conferences).

- An easy way to join any available session(s).

- An easy way to create and advertise new session(s).

USING SD
--------
To use sd, just type "sd &" (i.e., run it in the background).
You should see an X window with two panes & some buttons across the
bottom. If you leave sd running, the top pane should slowly fill
with session names (session announcements are made infrequently so
announcements won't take up all the available network bandwidth).
If you click on a session name, information about the session
will appear in the bottom pane. If you double click on the name
(or click on the "open" button), sd will start up the appropriate
tools for the session (vat, nv, ivs and/or wb).

NOTE: There are two versions of the sd binary in the distribution
tar file: "sd" is a dynamically linked sparc executable and
"sd.static" is a statically linked sparc executable. If
you have any trouble with "sd", try "sd.static".

CREATING A NEW SESSION
----------------------

NOTE: You *must* type a carriage return to terminate typing input --
just clicking the cursor on a button or in a different box
will not work. (We agree that you shouldn't have to type
the return but this is a beta version of the program &
we haven't had time to fix that part of it yet. Soon.)

If you want to create a new session, click on the "New" button.
A dialog box with a lot of blanks to fill in will pop up.
Click in the "Name" box and type a session name then hit carriage
return (the cursor should move to the "Description" box), type
in a description of the new session and hit carriage return.
The "Create" button should light up & the bell will ring.
This means sd has enough info to create the session. If you
hit "Create" now, a new multicast audio session will be created.
However, before hitting "Create", you might want to modify some
defaults that sd has picked for the new session.

By default, sd chooses a unique, non-conflicting multicast address,
port and conference ID for the session. (These are selected when
you open the new session window.) If you would rather use your
own address, port or conference ID, click in the appropriate box
and type it in (the automatically assigned address will disappear
as soon as you click). The address can be either an IP address
or DNS name. Port and ID must be integers in the range 1 to 65535.

By default, only "audio" media is selected for the session.
If you want to announce that the conference contains video and/or
a whiteboard, click on the checkbox to the left of the media name.
If you click on the media name (as opposed to the check box) a
menu will pop up that lets you select media "attributes" (e.g.,
pcm/gsm/lpc audio encoding, ivs/nv video).

The box marked "Scope" lets you select the "scope" (multicast ttl)
of the session. "Site" is a ttl of 16, "Region" is a ttl of 32
and "World" is a ttl of 127. If you want to use some other ttl,
click on the bottommost scope button & type in a number between
0 and 255.

--------

That should be enough to get you started. Please let van@ee.lbl.gov
know of any problems, suggestions, etc. Thanks.

- Van Jacobson