JXTA in a Nutshell

Name

groups — Discovers peergroups

Synopsis

groups [-p peerid 
                  name 
                  attribute] | [-n n] | [-r] | [-l] | [-a] | [-v] | [-f]

Description

This command discovers peergroups by broadcast or at a specified peer location. By default, groups lists all the peergroups known (cached) by the local peer. The -r option is used to send a propagate request to find new peergroups.

groups stores results of the propagate request in the local cache and inserts advertisements into the environment using the default naming: group X, in which X is a growing integer number.

Options

-p peerid

Discovers groups at the given peer location.

-r

Discovers groups by propagation.

-l

Displays all known group IDs as a hex string.

-a

Specifies an attribute name to limit discovery. Peergroups must contain an attribute with the given name.

-v

Specifies an attribute value to limit discovery. Peergroups must contain an attribute with the given value. This option is used in conjunction with the -a option.

-n

Limits the number of responses to n from a single peer.

-f

Flushes all group advertisements from the local cache.

Example

JXTA>groups -r

discovers all groups.

JXTA>groups -r -a
                  Name
                   -vsocce*

discovers all groups with an attribute named Name that has a value that begins with “socce.”

JXTA>groups -r -a
                  Name
                   -v*occer

discovers all groups with an attribute named Name that has a value that ends with “occer.”

See Also

whoami , chpgrp , join , peers