JXTA in a Nutshell

Name

join — Joins a peergroup

Synopsis

join [-r] [-c credential] (-d adv | name)

Description

The join command is used to join a peergroup that was created with a mkpgrp command or was previously discovered with the groups -r command. If no argument is given, join lists all the existing groups, their status (joined, unjoined), and the current group on the local peer. After a group is successfully joined, the PG@ group name environment variable is created. This variable holds the group information.

Joining a group makes it the current peergroup. The current peergroup can be changed to a previously joined group with the chpgrp command.

When joining a new peergroup, the new peergroup is advertised in the NetPeerGroup. No hierarchy of peergroups is supported by the shell.

After joining the peergroup, depending on the membership authentication required, the user will be asked for the identity she wants to have in the peergroup. Identities assign credentials to users when accessing peergroup resources. Each peergroup can define its own set of identities. The identities available for a peergroup can be found in the service section of the peergroup advertisement with the cat command:

 <Svc>
  <MCID>urn:jxta:uuid-DEADBEEFDEAFBABAFEEDBABE0000000505</MCID>
  <Parm>
   <login>myjxtauser:PAQ:</login>
   <login>myjxtasuperuser:PAXXQ:</login>
  </Parm>
  </Svc>

The preceding shows that the two identities myjxtauser and myjxtasuperuser are allowed in this peergroup. These identities require a password. ...