.TH solicit 1 "Mar 2014" "plc-utils-2.1.6" "Qualcomm Atheros Powerline Toolkit"

.SH NAME
solicit - Qualcomm Atheros Network Solicitor

.SH SYNOPSIS
.BR solicit
.RI [ options ] 

.SH DESCRIPTION
Solicit topology information from powerline network responders.
This is a proof-of-concept program that does nothing useful, as it stands.
It is maintained in case there is a need, in the future, to make it do something useful.
It requires one or more instances of program respond to demonstrate the concept.
The underlying protocol is essentially LLDP.

.PP
This program is part of the Qualcomm Atheros Powerline Toolkit.
See the \fBplc\fR man page for an overview and installation instructions.

.SH OPTIONS

.TP
.RB - i
Select the host Ethernet interface.
All requests are sent via this host interface and only reponses received via this host interface are recognized.
The default interface is \fBeth1\fR because most people use \fBeth0\fR as their principle network connection; however, if environment string "PLC" is defined then it takes precedence over the default interface.
This option then takes precedence over either default.

.TP
.RB - q
Enter quiet mode.
Progress messages are suppressed.

.TP
.RB - v 
Enter verbose mode.
All Etherenet frames sent or received by the program are displayed on stdout.

.TP
-\fBw \fImilliseconds\fR
Wakeup frequency in milliseconds.
This is the time between solicitation messages.
During this time, the program listens for responder announcements.
Values range from 0 through UINT_MAX.
The default is forever.

.TP
-\fB?\fR, --\fBhelp\fR
Print program help summary on stdout.
This option takes precedence over other options on the command line.

.TP
-\fB!\fR, --\fBversion\fR
Print program version information on stdout.
This option takes precedence over other options on the command line.
Use this option when sending screen dumps to Atheros Technical Support so that they know exactly which version of the Linux Toolkit you are using.

.SH REFERENCES
See the Qualcomm Atheros Simple Network Discovery Protocol for more information about \fBsolicitors\fR, \fBresponders\fR and \fBTLVs\fR.

.SH EXAMPLES
The following example starts a solicitor on interface \fBeth0\fR.

.PP
   # solicit -i eth0

.SH SEE ALSO
.BR plc ( 1 ),
.BR respond ( 1 ),

.SH CREDITS
 Charles Maier <cmaier@qca.qualcomm.com>