Basic Usage

Launching pwman3

Once you log into the server, you can run pwman3 by simply typing the command:

thomas@mythbox:~$ pwman3
Pwman3 0.0.6 (c) Ivan Kelly <>

There are a number of commands available, the complete list is at the bottom of this document. If you need help at any time, you can use the help command. The most important commands are:

  • new - Enters a new password into the database
  • edit ## - Edits the entry specified by ## (the ID number of the entry you want to edit)
  • exit - Quits the program
  • print ## - Displays the password information for the ID specified.
  • list1) - Prints a list of the passwords that match the criteria specified.

Creating a new entry

To create a new password, you will launch the program and then type new and press Enter.

You will be asked a series of questions like this:

pwman> new
Username: testusername
Password (Blank to generate): testpassword
Notes:    This is my password for my course
Please enter your password:
Tags:     school otherstuff
Password ID: 82
  1. It will ask for what your username is at the site for the password you want to store.
  2. Then it will ask for your password.
  3. Then it will ask for the URL at which you use this username/password combination.
  4. Then it asks for notes that will help you remember what it is for.
  5. If you have not already done so, it will ask you to log in. You will need to enter your master password here.
  6. Then it will ask you for tags. Tags allow you to easily filter your passwords for later searching.
  7. Finally, it tells you the ID for this password (you do not need to remember this)

All of that is pretty self explanatory.

Listing your Passwords

Adding an entry is fine and good, but it is important to know how to access it again in the future. This is where the list or ls command comes into play.

After launching pwman3, you can type in list or ls to get a list of your passwords.

pwman> list
Current tags:  None
    1. root@work servers              work, servers       
    2. CornMaster@Triorbit            website, domain, ...
   77. xymon@Xymon-local              personal, xymon, ...
   78. admin@Xymon-CGI-Admin          personal, xymon     
   79. thawkins@johnson               personal, financi...
   80. personal, website...
   81. d2lservices@plaza/blackhawk    work, g2b           
   82. testusername@http://online.... school, otherstuff  

As you can see, I have 82 passwords in my list. If I'm looking for something specific, I can first issue the filter command, and then the list command.

pwman> filter xymon
Current tags:  xymon 
pwman> list
Current tags:  xymon 
   77. xymon@Xymon-local              personal, xymon, ...
   78. admin@Xymon-CGI-Admin          personal, xymon     

To clear the filter, I issue the clear command.

pwman> clear
pwman> list
Current tags:  None

Viewing/Editing Details

Once you have listed your passwords, and found the ID number of the password you want to view, type in the print command to print out the details.

pwman> print 82
Node 82.
Username: testusername
Password: testpassword
Notes: This is my password for my course
Tags:  school  otherstuff 

If your password/username changes, you will need to use the edit command to update it.

pwman> edit 82
Editing node 82.
1 - Username:  testusername
2 - Password:  testpassword
3 - Url:
4 - Notes:     This is my password for my course
5 - Tags:      school otherstuff 
X - Finish editing
Enter your choice:  2
Password (Blank to generate): testpassword2
 1 - Username:  testusername
2 - Password:  testpassword2
3 - Url:
4 - Notes:     This is my password for my course
5 - Tags:      school otherstuff 
X - Finish editing
Enter your choice:  x

When in edit mode, you need to press the key for the part you want to edit, either 1, 2, 3, 4 or 5 depending on what you want to enter.

You do not have to press enter after pressing a number.

After making a selection, you will be able to type in a new entry for what you selected. Once you are finished, press Enter. This will return you to the main edit menu. Press X to quit edit mode.


To exit the program, you must type exit and press Enter.

You should also log out of any session you are in at the terminal, or over a remote connection (putty). Although you have logged out of the application, any passwords your viewed/entered will appear in the terminal history. Closing the terminal will clear this history.

Other Commands

Here is a list of all commands:

pwman> help

Documented commands (type help <topic>):
EOF    delete  exit    filter  help    list  new     print  save  tags
clear  edit    export  forget  import  ls    passwd  rm     set 

You can type help filter to find out more about the filter command.

pwman> help filter
Usage: filter <tag> ...
Filters nodes on tag. Arguments can be zero or more tags. Displays current tags if called without arguments.

Here is a brief overview of other commands you may need:

  • tags - Lists all of the tags you have used.
  • delete ## or rm ## - Deletes a password from the database.
  • passwd - This command changes the master password to your database.
  • forget - This forgets your master password for the session, which will force you to retype it the next time you try to do something. I believe it is safer just to exit out of the program.

Delete Command In Action

pwman> delete 82
Are you sure you want to delete 'testusername@'? [y/N]  y
testusername@ deleted

Tags Command In Action

pwman> tags
Tags:  stargate,  car  email  shopping  cpanel  personal  personal,  tv,  bomgar  wiki  insurance  website  webhosting  webcast  websites  webtools
  toyota  yahoo  bank  banner  acrobat  wordpress  work  blog  creditcard  servers  server  googleapps  google  api  financial  sports  linux  munbldc
  tax  dokuwiki  sql  xymon  hosting  machineaccount  raritan  cpf  ascii  rlb  remotesupport  respondus  reseller  adobe  power  stream  delt 
 government  bills  studentloan  cert  airmiles  support  home  homedepot  d2l  dilbert  helix  cable  ftp  domain  bldc  registration  listings  
g2b  bug  mpsc  mysql  hotel  games  loan  digicert  no-ip  bookmarks,  memorial  grades2banner  hardware  survey  ssl 
1) or ls
pwman3/pwman3usage.txt · Last modified: 2010/10/01 19:59 (external edit)
CC Attribution-Noncommercial-Share Alike 3.0 Unported Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0