Login Help

The login form allows you to log into your mailbox in order to manage the messages that are waiting for you. In the "e-mail address" field, you need to enter the e-mail address for which you want to manage the mail. The "password" field must be filled with the password for that same mailbox.

Action

You are given three actions to choose from:

• View message list
• Delete all messages
• Delete the first [ X ] messages

View message list will log into the mailbox, and retreive information about each message waiting for you. It will then give you a list of the messages waiting for you. Each one will be listed with it's subject, the sender, the date it was sent, and the size of the message in bytes. With that list, you can select individual messages and act upon them as you see fit.

Delete all messages will completely empty the mailbox. Please be very careful using this, as the messages can not be recovered once they are removed. After this button is selected, the entire contents of the mailbox are immediately deleted.

Delete the first [ X ] messages allows you to tell the server to go ahead and delete all messages up to and including number "X". The X in this case is a field in the form where you would type in the number of messages you want deleted. This can be very useful if your regular mail program is getting stuck on a particular message due to the size of it, as you would already have received the preceeding ones anyway.

Message List Help

This list gives you a form with which you can manage e-mail messages individually. Messages are listed with their index number, sender, subject, date sent, and size. Each message has a checkbox beside it, with which it can be selected. All selected messages are then acted upon depending on which button is clicked on.

Actions

Within the message list, the following options are available:

• Delete Selected Messages
  will delete the selected messages
• Delete Unselected Messages
  will delete all messages that are not selected
• Delete All Messages
will delete the entire contents of the mailbox.
• Delete Range (not currently available)
  will allow you to specify a range of messages to be deleted.
• Log Out will take you back to the login screen

Colour Coding

The list is colour-coded. The background colour of the message in the list is directly proportionate to it's size. The colours taper from light yellow (representing small messages that shouldn't be a problem), to a sharp red (representing large messages that can cause difficulties). Anything less than bytes is quite small, and should not be a problem. Anything more than bytes is considered large, and may very well cause difficulties.

Help

No help is currently available on this subject.

A password must be specified.

".$errormessage."

\n
• Connecting to sever
"; if(wait_for_ok($socket)){ /** submit the username **/ echo "
• Submitting Username
"; send_command("USER ".$username."\n", $socket); $logged_in = wait_for_ok($socket); echo "
• Submitting Password
"; send_command("PASS ".$password."\n", $socket); $logged_in &= wait_for_ok($socket); if($logged_in){ echo "
• Logged in, getting message list
"; /** get our list of messages **/ send_command("LIST\n", $socket); $output = wait_for_reply("\n.\r\n", $socket); $sizelist = preg_split("/\n/", $output); $nummessages = sizeof($sizelist) - 3; echo "
• Reading message headers"; for($n = 0; $n < $nummessages; $n++){ /*** Get the index number and size ***/ $messagedata = preg_split("/[\s\t\r\n]+/", trim($sizelist[$n + 1])); $message_number[$n] = $messagedata[0]; $message_size[$n] = $messagedata[1]; /*** get the header info ***/ send_command("TOP ".$message_number[$n]." 1\n", $socket); $header = explode("\n", wait_for_reply("\n.\r\n", $socket)); for($m = 0; $m < sizeof($header); $m++){ $data = explode(": ", $header[$m]); if(!strncmp($header[$m], "From:", 5)){ $sndr = explode("\"", $data[1]); $message_sender[$n] = htmlspecialchars(trim($sndr[1])); if($message_sender[$n] == ""){ $message_sender[$n] = htmlspecialchars(trim($data[1])); } } if(!strncmp($header[$m], "Subject:", 8)){ //$message_subject[$n] = htmlspecialchars(trim($data[1])); $message_subject[$n] = substr(htmlspecialchars(trim($header[$m])), 8); } if(!strncmp($header[$m], "Date:", 5)){ $dstring = preg_split("/[+-]/", $data[1]); $message_date[$n] = htmlspecialchars(trim($dstring[0])); } } echo "."; } echo "
"; }else{ $returnval = _ERROR_POP_AUTHENTICATION; $ERRORMESSAGE = "Invalid username or password on the POP server"; } send_command("QUIT\n", $socket); wait_for_ok($socket); }else{ $returnval = _ERROR_POP_CONNECTION; $ERRORMESSAGE = "Not getting a login OK from the POP server"; } echo "

\n
• Connecting to server
\n"; /* connect to the server on port 110 */ $result = socket_connect ($socket, $pophost, 110); if ($result < 0) { $returnval = _ERROR_SOCKET_CONNECT; $ERRORMESSAGE = socket_strerror($result); } if(wait_for_ok($socket)){ /** submit the username **/ echo "
• Submitting username
\n"; send_command("USER ".$username."\n", $socket); $logged_in = wait_for_ok($socket); echo "
• Submitting password
\n"; send_command("PASS ".$password."\n", $socket); $logged_in &= wait_for_ok($socket); if($logged_in){ echo "
• Deleting Messages"; for($n = 0; $n < $_POST["nummessages"]; $n++){ if($_POST["rm".$n] == 1){ echo "."; send_command("DELE ".($n + 1)."\n", $socket); if(!wait_for_ok($socket)){ if(!strlen($ERRORMESSAGE)){ $ERRORMESSAGE = "Error deleting message ".$n; } $ERRORMESSAGE .= ", ".$n; $returnval = _ERROR_DELETING_MESSAGE; } } } echo "
\n"; }else{ $returnval = _ERROR_POP_AUTHENTICATION; $ERRORMESSAGE = "Invalid username or password on the POP server"; } echo "
• Logging out of server
\n"; send_command("QUIT\n", $socket); wait_for_ok($socket); }else{ $returnval = _ERROR_POP_CONNECTION; $ERRORMESSAGE = "Not getting a login OK from the POP server"; } socket_close ($socket); switch($returnval){ case _ERROR_SOCKET_CREATE: case _ERROR_SOCKET_CONNECT: case _ERROR_POP_AUTHENTICATION: case _ERROR_POP_CONNECTION: echo "

Error opening mailbox:

"; echo "

".$ERRORMESSAGE."

\n"; break; case _ERROR_DELETING_MESSAGE: echo "

".$ERRORMESSAGE."

\n"; break; default: echo "

The selected messages have been successfully deleted

\n"; } return $returnval; } function delete_unselected_messages($pophost, $username, $password){ GLOBAL $ERRORMESSAGE; $returnval = 0; /* grab the IPA */ $address = gethostbyname ($pophost); /* Create a TCP/IP socket. */ $socket = socket_create (AF_INET, SOCK_STREAM, 0); if ($socket < 0) { echo "socket_create() failed: reason: " . socket_strerror ($socket) . "\n"; return _ERROR_SOCKET_CREATE; $ERRORMESSAGE = socket_strerror($result); } echo "
\n
• Connecting to server
\n"; /* connect to the server on port 110 */ $result = socket_connect ($socket, $pophost, 110); if ($result < 0) { $returnval = _ERROR_SOCKET_CONNECT; $ERRORMESSAGE = socket_strerror($result); } if(wait_for_ok($socket)){ /** submit the username **/ echo "
• Submitting username
\n"; send_command("USER ".$username."\n", $socket); $logged_in = wait_for_ok($socket); echo "
• Submitting password
\n"; send_command("PASS ".$password."\n", $socket); $logged_in &= wait_for_ok($socket); if($logged_in){ echo "
• Deleting Messages"; for($n = 0; $n < $_POST["nummessages"]; $n++){ if($_POST["rm".$n] != 1){ echo "."; send_command("DELE ".($n + 1)."\n", $socket); if(!wait_for_ok($socket)){ if(!strlen($ERRORMESSAGE)){ $ERRORMESSAGE = "Error deleting message ".$n; } $ERRORMESSAGE .= ", ".$n; $returnval = _ERROR_DELETING_MESSAGE; } } } echo "
\n"; }else{ $returnval = _ERROR_POP_AUTHENTICATION; $ERRORMESSAGE = "Invalid username or password on the POP server"; } echo "
• Logging out of server
\n"; send_command("QUIT\n", $socket); wait_for_ok($socket); }else{ $returnval = _ERROR_POP_CONNECTION; $ERRORMESSAGE = "Not getting a login OK from the POP server"; } socket_close ($socket); echo "
\n"; switch($returnval){ case _ERROR_SOCKET_CREATE: case _ERROR_SOCKET_CONNECT: case _ERROR_POP_AUTHENTICATION: case _ERROR_POP_CONNECTION: echo "

Error opening mailbox:

"; echo "

".$ERRORMESSAGE."

\n"; break; case _ERROR_DELETING_MESSAGE: echo "

".$ERRORMESSAGE."

\n"; break; default: echo "

The selected messages have been successfully deleted

\n"; } return $returnval; } function delete_all_messages($pophost, $username, $password){ GLOBAL $ERRORMESSAGE; $returnval = 0; /* grab the IPA */ $address = gethostbyname ($pophost); /* Create a TCP/IP socket. */ $socket = socket_create (AF_INET, SOCK_STREAM, 0); if ($socket < 0) { echo "socket_create() failed: reason: " . socket_strerror ($socket) . "\n"; return _ERROR_SOCKET_CREATE; $ERRORMESSAGE = socket_strerror($result); } echo "
\n
• Connecting to server
\n"; /* connect to the server on port 110 */ $result = socket_connect ($socket, $pophost, 110); if ($result < 0) { $returnval = _ERROR_SOCKET_CONNECT; $ERRORMESSAGE = socket_strerror($result); } if(wait_for_ok($socket)){ /** submit the username **/ echo "
• Submitting username
\n"; send_command("USER ".$username."\n", $socket); $logged_in = wait_for_ok($socket); echo "
• Submitting password
\n"; send_command("PASS ".$password."\n", $socket); $logged_in &= wait_for_ok($socket); if($logged_in){ echo "
• Getting message list
\n"; /** get a list of messages **/ send_command("LIST\n", $socket); $output = wait_for_reply("\n.\r\n", $socket); $sizelist = preg_split("/\n/", $output); $nummessages = sizeof($sizelist) - 3; echo "
• Deleting messages"; for($n = 0; $n < $nummessages; $n++){ echo "."; send_command("DELE ".($n + 1)."\n", $socket); if(!wait_for_ok($socket)){ if(!strlen($ERRORMESSAGE)){ $ERRORMESSAGE = "Error deleting message ".$n; } $ERRORMESSAGE .= ", ".$n; $returnval = _ERROR_DELETING_MESSAGE; } } echo "
\n"; }else{ $returnval = _ERROR_POP_AUTHENTICATION; $ERRORMESSAGE = "Invalid username or password on the POP server"; } echo "
• Logging out of server
\n"; send_command("QUIT\n", $socket); wait_for_ok($socket); }else{ $returnval = _ERROR_POP_CONNECTION; $ERRORMESSAGE = "Not getting a login OK from the POP server"; } socket_close ($socket); echo "
\n"; switch($returnval){ case _ERROR_SOCKET_CREATE: case _ERROR_SOCKET_CONNECT: case _ERROR_POP_AUTHENTICATION: case _ERROR_POP_CONNECTION: echo "

Error opening mailbox:

"; echo "

".$ERRORMESSAGE."

\n"; break; case _ERROR_DELETING_MESSAGE: echo "

".$ERRORMESSAGE."

\n"; break; default: echo "

All messages successfully deleted

\n"; } return $returnval; } function delete_message_range($pophost, $username, $password, $firstindex, $lastindex){ GLOBAL $ERRORMESSAGE; $returnval = $deltally = 0; /* grab the IPA */ $address = gethostbyname ($pophost); /* Create a TCP/IP socket. */ $socket = socket_create (AF_INET, SOCK_STREAM, 0); if ($socket < 0) { echo "socket_create() failed: reason: " . socket_strerror ($socket) . "\n"; return _ERROR_SOCKET_CREATE; $ERRORMESSAGE = socket_strerror($result); } echo "
\n
• Connecting to server
\n"; /* connect to the server on port 110 */ $result = socket_connect ($socket, $pophost, 110); if ($result < 0) { $returnval = _ERROR_SOCKET_CONNECT; $ERRORMESSAGE = socket_strerror($result); } if(wait_for_ok($socket)){ /** submit the username **/ echo "
• Submitting username
\n"; send_command("USER ".$username."\n", $socket); $logged_in = wait_for_ok($socket); echo "
• Submitting password
\n"; send_command("PASS ".$password."\n", $socket); $logged_in &= wait_for_ok($socket); if($logged_in){ echo "
• Getting message list
\n"; /** get a list of messages **/ send_command("LIST\n", $socket); $output = wait_for_reply("\n.\r\n", $socket); $sizelist = preg_split("/\n/", $output); $nummessages = sizeof($sizelist) - 3; /** do a range check on the specivied indexes **/ if($firstindex > $lastindex){ $swp = $firstindex; $firstindex = $lastindex; $lastindex = $swp; } if($firstindex < 1) $firstindex = 1; if($lastindex > $nummessages) $lastindex = $nummessages; if($firstindex <= $nummessages && $lastindex >= 1){ /** The range is a valid one, delete the specified messages **/ echo "
• Deleting messages"; for($n = $firstindex; $n <= $lastindex; $n++){ echo "."; send_command("DELE ".$n."\n", $socket); if(!wait_for_ok($socket)){ if(!strlen($ERRORMESSAGE)){ $ERRORMESSAGE = "Error deleting message ".$n; } $ERRORMESSAGE .= ", ".$n; $returnval = _ERROR_DELETING_MESSAGE; }else{ $deltally++; } } echo "
\n"; }else{ /** The range is not a valid one. Don't do any deleting **/ echo "

No messages deleted - Invalid range specified

\n"; } }else{ $returnval = _ERROR_POP_AUTHENTICATION; $ERRORMESSAGE = "Invalid username or password on the POP server"; } echo "
• Logging out of server
\n"; send_command("QUIT\n", $socket); wait_for_ok($socket); }else{ $returnval = _ERROR_POP_CONNECTION; $ERRORMESSAGE = "Not getting a login OK from the POP server"; } socket_close ($socket); echo "
\n"; switch($returnval){ case _ERROR_SOCKET_CREATE: case _ERROR_SOCKET_CONNECT: case _ERROR_POP_AUTHENTICATION: case _ERROR_POP_CONNECTION: echo "

Error opening mailbox:

"; echo "

".$ERRORMESSAGE."

\n"; break; case _ERROR_DELETING_MESSAGE: echo "

".$ERRORMESSAGE."

\n"; break; default: echo "

".$deltally." messages successfully deleted

\n"; } return $returnval; } /** sends output through the specified socket. This is here for the purpose of allowing command strings to be composed within the argument itself, without having to calculate it's length. It just tidies up the code a bit. **/ function send_command($command, $socket){ socket_write ($socket, $command, strlen($command)); } /** Reads data from the socket until one of the lines starts with either +OK or -ERR. This is standard POP3 stuff. **/ function wait_for_ok($socket){ $returnval = FALSE; $output = ""; while(strncmp($output, "+OK", 3) && strncmp($output, "-ERR", 4)){ $output = socket_read($socket, 2048); } if(!strncmp($output, "+OK", 3)) $returnval = TRUE; return $returnval; } /** reads data from $socket until it hits a line that starts with $rstring. Returns the data fetched from that socket **/ function wait_for_reply($rstring, $socket){ $returnval = ""; $output = ""; //while (strncmp($output, $rstring, strlen($rstring))){ while((strpos($returnval, $rstring) == FALSE) && strncmp($output, $rstring, strlen($rstring))){ $output = socket_read($socket, 2048); $returnval .= $output; } return $returnval; }