[GLASSFISH-9954] Improve create-transport man page (was: remove the not frequently used options in create-transport) Created: 02/Oct/09  Updated: 06/Mar/12

Status: Open
Project: glassfish
Component/s: docs
Affects Version/s: V3
Fix Version/s: not determined

Type: Improvement Priority: Major
Reporter: sankarpn Assignee: Mike Fitch
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Operating System: All
Platform: PC

Issuezilla Id: 9,954
Tags: 3_1-exclude


All the parameters used in transport is put as options in create-transport
command. We shouldn't have put all the attributes available as a command options
which makes the command more complex to type and use.

Like create-protocol command the minimal set of frequently used options must be
part of the command , rest of them can be omitted and put as defaults in config.

If one wants to modify those they can always to get/set

Usage: asadmin [asadmin-utility-options] create-transport [--acceptorthreads -1]
[--buffersizebytes 8192] [--bytebuffertype HEAP] [--classname
com.sun.grizzly.TCPSelectorHandler] [--displayconfiguration false]
[--enablesnoop false] [--idlekeytimeoutseconds 30] [--maxconnectionscount 4096]
[--readtimeoutmillis 30000] [--writetimeoutmillis 30000] [--selectionkeyhandler
<selectionkeyhandler>] [--selectorpolltimeoutmillis <selectorpolltimeoutmillis>]
[--tcpnodelay <tcpnodelay>] [-?|--help=false] transportname

Usage: asadmin [asadmin-utility-options] create-protocol [--securityenabled
<securityenabled>] [-?|--help=false] protocolname

Comment by Bill Shannon [ 02/Oct/09 ]

This sounds like an enhancement request.

Reassigning to Nandini.

Comment by sankarpn [ 03/Oct/09 ]

ok, made as RFE. But I request this to be fixed.

Comment by Tom Mueller [ 23/Jun/10 ]

Nandini no longer on project.

Comment by Bill Shannon [ 23/Jun/10 ]

Good or bad, we've already got all those options in v3, so removing them
would be a compatibility issue. Instead, the man page for this command
could use some improvement to describe which options are likely or unlikely
to be used, as well as giving more useful usage examples.

Comment by Mike Fitch [ 03/Jan/11 ]

Will investigate reorganizing the man page in a future release.

Comment by Paul Davies [ 27/May/11 ]

Under consideration for 3.1.1

Comment by Tom Mueller [ 06/Mar/12 ]

Bulk update to change fix version to "not determined" for all issues still open but with a fix version for a released version.

Generated at Fri Oct 09 02:05:50 UTC 2015 using JIRA 6.2.3#6260-sha1:63ef1d6dac3f4f4d7db4c1effd405ba38ccdc558.