$ssh->login([ $user [, $password ] ])



     Sets the username and password to be used when

     authenticating with the sshd daemon. The username $user is

     required for all authentication protocols (to identify

     yourself to the remote server), but if you don't supply it

     the username of the user executing the program is used.



     The password $password is needed only for password

     authentication (it's not used for passphrases on encrypted

     RSA/DSA identity files, though perhaps it should be). And if

     you're running in an interactive session and you've not

     provided a password, you'll be prompted for one.