w3-tools.com - Free Webmaster Tools and Resources
  		w3-tools.com - Free Webmaster Tools and Resources
 Free Webmaster Tools and Resources

 



PEAR Manual

This manual is provided as a courtesy. It is not an official source. Please check pear.php.net for updated information.

PEAR Manual

PEAR Manual
PEAR Manual
PrevNext

File_Passwd_Unix::addUser()

File_Passwd_Unix::addUser() -- Add an user

Synopsis

mixed File_Passwd_Unix::addUser (string $user, string $pass [, array $extra = array()])

Description

The username must start with an alphabetical character and must NOT contain any other characters than alphanumerics, the underline and dash.

If you use the 'name map' you should also use these naming in the supplied extra array, because your values would get mixed up if they are in the wrong order, which is always true if you DON'T use the 'name map'!

So be warned and USE the 'name map'!

If the passwd file is shadowed, the user will be added though, but with an 'x' as password, and a PEAR_Error will be returned, too.

Parameter

string $user

the name of the user to add

string $pass

the password of the user to add

array $extra

extra properties of user to add

Return value

Returns TRUE on success, PEAR_Error on failure.

Table 37-1. Possible PEAR_Error values

Error CodeSummary
FILE_PASSWD_E_ALREADY_EXISTSuser already exists
FILE_PASSWD_E_INVALID_CHARSusername contains illegal characters
FILE_PASSWD_E_INVALID_CHARSany of the extra proporties contains a colon
FILE_PASSWD_E_INVALID_ENC_MODEactual encryption mode is not supported
FILE_PASSWD_E_UNDEFINEDif passwd file is shadowed

Note

This function can not be called statically.

PrevHomeNext
File_Passwd_Unix::save()UpFile_Passwd_Unix::modUser()

Newsletter
Join to our newsletter and receive news and updates about our site.
Your name: 
E-mail address: 
Action: 
 

Hosted by

Search
Google
Web w3-tools.com

Links
  What is my IP? Find your IP address!     Valid XHTML 1.0 Transitional  
Copyright © 2006. by w3-tools.com. All rights reserved