Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 668119

Summary: ipa2b1 - cli ipa user-add password option online help and doc update - passwd versus password
Product: [Retired] freeIPA Reporter: Marc Sauton <msauton>
Component: ipa-pythonAssignee: Rob Crittenden <rcritten>
Status: CLOSED ERRATA QA Contact: Chandrasekar Kannan <ckannan>
Severity: medium Docs Contact:
Priority: low    
Version: 2.0CC: benl, dpal, jgalipea
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: freeipa-2.1.0-1.fc15 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-03-28 09:40:15 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Marc Sauton 2011-01-07 23:13:59 UTC
Description of problem:

minor cosmetic annoyance in the ipa cli help and in the doc for user-add password option

may be there was a change over time on how this option works, or may be this is till changing.

doc at
http://obriend.fedorapeople.org/freeIPA2.0/Identity_and_Policy_Management_Guide/html-single/#chap-Enterprise_Identity_Management_Guide-Quick_Install_of_IPA
"
Procedure 14.1. To create the user jlamb using the command line:

    *
      Open a shell and run the following command:
      ipa user-add jlamb --first=John --last=Lamb --password jlamb 
"

Should be more like
"
      ipa user-add jlamb --first=John --last=Lamb --password
"

There is no argument or value to pass to the --password option, it is a trigger to prompt for a password.
 
And for the user-add command with the password option, strings passwd versus password strings:

the examples provided in
/usr/lib/python2.7/site-packages/ipalib/plugins/user.py
suggest
"
 Add a new user:
   ipa user-add --first=Tim --last=User --passwd tuser1
"

should be more like:
"
 Add a new user:
   ipa user-add --first=Tim --last=User --password
"


as we have defined the string "password", at:
        Password('userpassword?',
            cli_name='password',
            label=_('Password'),
            doc=_('Prompt to set the user password'),

also in:

ipa user-add --help
Usage: ipa [global-options] user-add LOGIN

Options:
...
  --password         Prompt to set the user password



Version-Release number of selected component (if applicable):

Fedora release 14 (Laughlin)
Linux ca1.example.com 2.6.35.6-45.fc14.x86_64 #1 SMP Mon Oct 18 23:57:44 UTC 2010 x86_64 x86_64 x86_64 GNU/Linux
ipa-server-2.0.0.pre1-0.fc14.x86_64


How reproducible:
always


Steps to Reproduce:
1. ipa user-add --help
2. less /usr/lib/python2.7/site-packages/ipalib/plugins/user.py
3. ipa user-add --first=Tim --last=User --passwd tuser1
4. corrected command
ipa user-add --first=Tim --last=User --password

  
Actual results:


ipa user-add --first=Tim --last=User --passwd tuser1
Usage: ipa [global-options] user-add LOGIN

ipa: error: no such option: --passwd



Expected results:


Additional info:

Comment 1 Dmitri Pal 2011-01-08 15:58:44 UTC
https://fedorahosted.org/freeipa/ticket/735

Comment 2 Rob Crittenden 2011-02-18 02:44:02 UTC
master: 27785b679427758ec4c111583b055a64b077c23f