5 // Implements various Citadel server commands.
7 // Copyright (c) 2003 by Art Cancro <ajc@uncensored.citadel.org>
8 // This program is released under the terms of the GNU General Public License.
13 // serv_gets() -- generic function to read one line of text from the server
15 function serv_gets() {
18 $buf = fgets($clientsocket, 4096); // Read line
19 $buf = substr($buf, 0, (strlen($buf)-1) ); // strip trailing LF
25 // serv_puts() -- generic function to write one line of text to the server
27 function serv_puts($buf) {
30 fwrite($clientsocket, $buf . "\n", (strlen($buf)+1) );
36 // Identify this client, and the hostname where the user is, to Citadel.
38 function ctdl_iden() {
41 serv_puts("IDEN 0|8|001|PHP web client|" . $_SERVER['REMOTE_ADDR'] );
48 // login_existing_user() -- attempt to login using a supplied username/password
49 // Returns an array with two variables:
50 // 0. TRUE or FALSE to determine success or failure
51 // 1. String error message (if relevant)
53 function login_existing_user($user, $pass) {
56 serv_puts("USER " . $user);
58 if (substr($resp, 0, 1) != "3") {
59 return array(FALSE, substr($resp, 4));
62 serv_puts("PASS " . $pass);
64 if (substr($resp, 0, 1) != "2") {
65 return array(FALSE, substr($resp, 4));
68 $_SESSION["username"] = $user;
69 $_SESSION["password"] = $pass;
70 become_logged_in(substr($resp, 4));
72 return array(TRUE, "Login successful. Have fun.");
77 // create_new_user() -- attempt to create a new user
78 // using a supplied username/password
79 // Returns an array with two variables:
80 // 0. TRUE or FALSE to determine success or failure
81 // 1. String error message (if relevant)
83 function create_new_user($user, $pass) {
86 serv_puts("NEWU " . $user);
88 if (substr($resp, 0, 1) != "2") {
89 return array(FALSE, substr($resp, 4));
92 serv_puts("SETP " . $pass);
94 if (substr($resp, 0, 1) != "2") {
95 return array(FALSE, substr($resp, 4));
98 $_SESSION["username"] = $user;
99 $_SESSION["password"] = $pass;
100 become_logged_in(substr($resp, 4));
102 return array(TRUE, "Login successful. Have fun.");
107 // Code common to both existing-user and new-user logins
109 function become_logged_in($server_parms) {
110 $_SESSION["logged_in"] = 1;
111 ctdl_goto("_BASEROOM_");
117 // Learn all sorts of interesting things about the Citadel server to
118 // which we are connected.
120 function ctdl_get_serv_info() {
123 if (substr($buf, 0, 1) == "1") {
127 if ($i == 1) $_SESSION["serv_nodename"] = $buf;
128 if ($i == 2) $_SESSION["serv_humannode"] = $buf;
129 if ($i == 3) $_SESSION["serv_fqdn"] = $buf;
130 if ($i == 4) $_SESSION["serv_software"] = $buf;
131 if ($i == 6) $_SESSION["serv_city"] = $buf;
132 if ($i == 7) $_SESSION["serv_sysadmin"] = $buf;
134 } while (strcasecmp($buf, "000"));
141 // Display a system banner. (Returns completed HTML.)
142 // (This is probably temporary because it outputs more or less finalized
143 // markup. For now it's just usable.)
145 function ctdl_mesg($msgname) {
146 global $clientsocket;
148 $msgtext = "<DIV ALIGN=CENTER>\n";
150 serv_puts("MESG " . $msgname);
151 $response = serv_gets();
153 if (substr($response, 0, 1) == "1") {
154 while (strcmp($buf = serv_gets(), "000")) {
155 $msgtext .= "<TT>" . htmlspecialchars($buf)
160 $msgtext .= "<B><I>" . substr($response, 4) . "</I></B><BR>\n";
163 $msgtext .= "</DIV>\n";
169 // Fetch the list of users currently logged in.
171 function ctdl_rwho() {
172 global $clientsocket;
175 $response = serv_gets();
177 if (substr($response, 0, 1) != "1") {
178 return array(0, NULL);
181 $all_lines = array();
184 while (strcmp($buf = serv_gets(), "000")) {
188 $tok = strtok($buf, "|");
189 if ($tok) $thisline["session"] = $tok;
192 if ($tok) $thisline["user"] = $tok;
195 if ($tok) $thisline["room"] = $tok;
198 if ($tok) $thisline["host"] = $tok;
201 if ($tok) $thisline["client"] = $tok;
203 // IGnore the rest of the fields for now.
205 $num_lines = array_push($all_lines, $thisline);
208 return array($num_lines, $all_lines);
216 function ctdl_goto($to_where) {
218 serv_puts("GOTO " . $to_where);
219 $response = serv_gets();
221 if (substr($response, 0, 1) == "2") {
222 $_SESSION["room"] = strtok(substr($response, 4), "|");
223 return array(TRUE, substr($response, 0, 3));
227 return array(FALSE, substr($response, 0, 3));
235 // Fetch the list of known rooms.
237 function ctdl_knrooms() {
238 global $clientsocket;
241 $response = serv_gets();
243 if (substr($response, 0, 1) != "1") {
244 return array(0, NULL);
247 $all_lines = array();
250 while (strcmp($buf = serv_gets(), "000")) {
254 $tok = strtok($buf, "|");
255 if ($tok) $thisline["name"] = $tok;
258 if ($tok) $thisline["flags"] = $tok;
261 if ($tok) $thisline["floor"] = $tok;
264 if ($tok) $thisline["order"] = $tok;
267 if ($tok) $thisline["flags2"] = $tok;
270 if ($tok) $thisline["access"] = $tok;
272 if ($thisline["access"] & 8) {
273 $thisline["hasnewmsgs"] = TRUE;
276 $thisline["hasnewmsgs"] = FALSE;
279 $num_lines = array_push($all_lines, $thisline);
282 return array($num_lines, $all_lines);