You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@qpid.apache.org by "Pavel Moravec (JIRA)" <ji...@apache.org> on 2011/08/22 10:13:29 UTC

[jira] [Updated] (QPID-3437) qpid-config address option confusing in help

     [ https://issues.apache.org/jira/browse/QPID-3437?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Pavel Moravec updated QPID-3437:
--------------------------------

           Component/s: Documentation
                Labels: patch  (was: )
           Description: 
qpid-config --help prints confusing / ambiguity information how to use address
option (-a user/password@broker). On first place it is specified without -a
option (wrong), second place is not descriptive about address syntax:

qpid-config --help
Usage:  qpid-config [OPTIONS]
..
ADDRESS syntax:

      [username/password@] hostname [:<port>]
      [username/password@] ip-address [:<port>]
..
  General Options:
..
    -a <address>, --broker-addr=<address>
                        Address of qpidd broker

Proposed patch removes the ADDRESS syntax part and adds the address syntax to -a option (to follow structure of the help).


  was:
Different qpid-* tools use different command line options for authentication. E.g.:

qpid-perftest	--username guest --password passwd -b broker --mechanism MECH
qpid-config	-a guest/passwd@broker --sasl-mechanism=MECH
qpid-stat	guest/passwd@broker -sasl-mechanism=MECH

Further to that, some tools (i.e. qpid-tool) don't have an option to set up SASL mechanism at all.

It makes sense to unify these options, plus add missing where desired.

See attached table with list of tools, their options and some further comments (some minor bugs found as well).

    Remaining Estimate: 1h
     Original Estimate: 1h
               Summary: qpid-config address option confusing in help  (was: Unify credentials options in qpid tools)

> qpid-config address option confusing in help
> --------------------------------------------
>
>                 Key: QPID-3437
>                 URL: https://issues.apache.org/jira/browse/QPID-3437
>             Project: Qpid
>          Issue Type: Improvement
>          Components: Documentation, Tools
>    Affects Versions: 0.10
>            Reporter: Pavel Moravec
>            Priority: Minor
>              Labels: patch
>         Attachments: qpid_tools_authentication.ods
>
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> qpid-config --help prints confusing / ambiguity information how to use address
> option (-a user/password@broker). On first place it is specified without -a
> option (wrong), second place is not descriptive about address syntax:
> qpid-config --help
> Usage:  qpid-config [OPTIONS]
> ..
> ADDRESS syntax:
>       [username/password@] hostname [:<port>]
>       [username/password@] ip-address [:<port>]
> ..
>   General Options:
> ..
>     -a <address>, --broker-addr=<address>
>                         Address of qpidd broker
> Proposed patch removes the ADDRESS syntax part and adds the address syntax to -a option (to follow structure of the help).

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:dev-subscribe@qpid.apache.org