Troubleshooting Shellsock

ShellSock ver 1.01 is now available. If you are facing problems using ver 1.00 of ShellSock, please download and try out the new release.

  1. When I run Netscape/Explorer, ShellSock does not popup.
  2. ShellSock reports that "winsock.ini" could not be located.
  3. Netscape/Explorer says "connecting to 127.0.0.1" and then times out.
  4. When I run an IRC client, I get a "connect timed out" error.
  5. Display of images in Netscape/Explorer drags.
  6. Netscape/Explorer does not load any of the images correctly.
  7. Netscap/Explorer does not load some images.
  8. I installed some new IP clients and ShellSock no longer pops up.
  9. Cello/Mosaic complains that the web page was not loaded correctly.
  10. Netscape/Explorer does not load the specified page.
  11. I set up the COM port, but ShellSock says "Cannot open specified COM port".
  12. When I try to login to my shell account using the ShellSock terminal, I get "Login incorrect", however I am able to login correctly using my normal terminal program.
  13. ShellSock always says "modem link is down...." even when I am actually connected.
  14. Pictures at hotmail.com don't load up
  15. Netscape Mail / News clients will not work on the student servers.
  16. Eudora says "Connection timed out." or "Unable to connect to server" when I select "Get Mail".
  17. Eudora says "HELO giasxx.xxx.xxx.xxx" when sending mail and does not proceed.
  18. The first time, the mail send works just fine. However the next time, Eudora says that it was unable to connect up with the server. The third time I try to send, Eudora again works correctly.
  19. Eudora/netscape says "An error occured when sending your User Name" when I try to get my mail.
  20. Netscape says "HTTP: Access authorization required, use the -auth=id:pw parameter"
  21. I am logging into VSNL using the guest account as my account is on a different server. How do I use ShellSock with it?
  22. VSNL lines are always busy.... Can I setup ShellSock to automatically redial?
  23. Known Limitations of the ShellSock.
  24. My problem is different from any of those mentioned above.


Problem:
I installed Shellsock as instructed, but when I run my client software, the Shellsock terminal window and about box does not popup.

* The software you are running is not a 16-bit IP client software. It is most likely a 32-bit version.

* You are trying to use ShellSock with your communication software. SHELLSOCK WILL NOT WORK WITH PROCOMM OR BITWARE OR HYPERTERMINAL OR ANY OTHER COMMUNICATION SOFTWARE! ShellSock is a sockets driver and is designed to work with IP client software like Netscape Navigator and Internet Explorer. For a complete list of supported software, please read our FAQ!

* The ShellSock software has not been installed correctly. Windows 95 automatically overwrites any winsock.dll file in the windows directory with its own version whenever any IP client software is installed. Check to see if the winsock.dll file actually is the shellsock file. Its easy to see the difference, ShellSock's winsock.dll file comes to around 140 Kb, whereas the winsock.dll of windows comes to around 42 Kb.

* The IP Client software you are using comes with its own dialler and TCP/IP stack. During installation, go for custom installation and do not install the dialler or the TCP/IP stack.

Fix:

The solution is to make sure that no other winsock.dll file is present in your windows (usually C:\WINDOWS) or the windows\system (usually C:\WINDOWS\SYSTEM) directories as well as in the sub-directories of the client software and to use only 16-bit client software with ShellSock.


Problem:
I get a message from Shellsock reporting that the 'WINSOCK.INI' file could not be located.

Shellsock searches for the 'WINSOCK.INI' file only in the directory where the DLL file is located. If you have put the '.INI' file in the C:\WINDOWS directory and the DLL file in a separate directory, Shellsock cannot locate its initialisation file and pops up this message.

Fix:

Copy the '.INI' file of Shellsock into the correct directory.


Problem:
Shellsock gets loaded properly, but when I try to connect to any site Netscape /Explorer says connecting to 127.0.0.1 and after about half a minute I get a 'Connection not established' error.

If you have installed any software (eg: Blue Laser) that uses "a proxy server" setting, and did not uninstall it correctly, you will face this problem.

Fix:

The solution is to locate the .ini file of Netscape or Explorer and make the necessary modification to remove the proxy server setting.


Problem:
Netscape/Explorer works correctly, but when I run my IRC client/Mail client server, I get a "connect timed out" error.

ShellSock uses two main programs, "telnet" and "lynx" to simulate a socket connection and ShellSock is able to use either or both to do the simulation. If you setup ShellSock to use only lynx (by checking only "Use Lynx" in the setup box), ShellSock will be unable simulate an IRC connect.

Fix:

Check both "Use Telnet" and "Use Lynx" boxes in the "Basic Setup" window. (Basic Setup is accessable from "Shellsock - Terminal" by clicking on the "Setup" button).


Problem:
Practically everything works correctly, but display of images in Netscape/Explorer just drags.

ShellSock uses two main programs, "telnet" and "lynx" to simulate a socket connection and ShellSock is able to use either or both to do the simulation. If you setup ShellSock to use only telnet (by checking only "Use Telnet" in the setup box), ShellSock has to revert to a slow method of transfer for binary files. The actual speed decrease is more than 200% of normal transfer rate.

Fix:

Check both "Use Telnet" and "Use Lynx" boxes in the "Basic Setup" window. (Basic Setup is accessable from "Shellsock - Terminal" by clicking on the "Setup" button).


Problem:
I am able to get the text information, but none of the images are being loaded correctly and Netscape/Explorer show them as broken images.

One of programs that ShellSock depends on is not available and therefore ShellSock is unable to download the images correctly. This is not a fatal error as ShellSock has the capability to work even without this program.

Fix:

Check only "Use Telnet" in the "Basic Setup" window. (Basic Setup is accessable from "Shellsock - Terminal" by clicking on the "Setup" button).


Problem:
I am able to get both text and graphics, but sometimes, 1 or 2 images in the web page appear as broken images.

This could be due to your modem re-training and ShellSock timing out on the connect (In which case setting the "ConnectTimeout" to a higher value might help) or the particular image has a .html extension. Unfortunately, ShellSock decides on the method to use based on the extension of the file, and in such an extreme case uses the wrong method.

Fix:

One solution is to check only "Use Lynx" in the "Basic Setup" window. (Basic Setup is accessable from "Shellsock - Terminal" by clicking on the "Setup" button). Don't forget to re-check "Use Telnet" when you want run an IRC client.


Problem:
I just installed some new IP client software and now ShellSock does not pop up

The reason that Shellsock is not executed is that the client software you are executing comes with its own winsock.dll which has over written ShellSock or you have installed ShellSock into the C:\WINDOWS directory in Windows 95.

Fix:

The solution is to make sure that no other "winsock.dll" file is present in your windows (usually C:\WINDOWS) or the windows\system (usually C:\WINDOWS\SYSTEM) directories as well as in the sub-directories of the client software and if you are running Windows 95, install ShellSock into its own directory and add it to your path statement or if you really can't be bothered, just make the "winsock.dll" file of ShellSock read only so 95 does not try to replace ShellSock with its own socket driver.


Problem:
Cello/Mosaic complains that the web page was not loaded correctly.

Although initially, we had got both Cello and Mosaic working with ShellSock, during last minute modification to ShellSock, we found that both these browsers are become partially inoperational.

Fix:

Unfortunately there is presently no fix other than to switch to either Netscape Navigator or Internet Explorer, both of which work correctly with ShellSock.


Problem:
Netscape/Explorer does not load the specified page even though I re-try again and again. But when I quit and restart Netscape/Explorer, every thing works fine.

One of the telnet connection just blocks and does not exit. Therefore other connections cannot be started.

Fix:

Set number of simultaneous network connections to "1". In netscape, this can be done from "network preferences", for Explorer, you have to edit the "iexplore.ini" file.


Problem:
I set up the COM port, but ShellSock says "Cannot open specified COM port".

Cause: ShellSock cannot access the specified COM Port.

Technical: OpenComm() function returned a value less that 0.

Possible Explanations and Solutions:
Your winsock.ini file could be readonly! If you are using ver 1.00 version of ShellSock, try downloading the latest version which fixes this problem.

Some other program like Hyperterminal, Terminal or Fax Software could be using the COM Port and therefore ShellSock cannot gain access to it. Exit such programs before running ShellSock.

Under Windows 3.1 see if Terminal works correctly with the COM port you are trying to specify. First get terminal working so that you can dial into your Shell account. Then try the same COM port settings on ShellSock.

Under Windows 95, go into Control Panel -> System -> Device Manager and check if the COM Port you specified has a IRQ conflict. If so try to find a solution to the IRQ conflict before trying to get ShellSock working.

In short try out existing terminal programs, to see if they work.... and once you are pretty certain about the COM port settings... try those settings out on ShellSock.

Points to Note:
What is COM4 in DOS need not be COM4 in Windows so try all the ports out.
If you use a DOS terminal program in a DOS session under Windows 95 and then try to use ShellSock without exiting from the DOS session (You have to exit the DOS session.... Not just the terminal program)., ShellSock will be unable to access the COM port.


Problem:
When I try to login to my shell account using the ShellSock terminal, I get "Login incorrect", however I am able to login correctly using my normal terminal program.

Cause: A bug in ShellSock ver 1.00 causes this problem to occur if COM speed is set to a value greater than 19200.

Technical: BuildCommDCB() takes values upto 19200 only.

Possible Solutions:
Download and use version 1.01 of ShellSock which fixes this problem.


Problem:
ShellSock always says "modem link is down...." even when I am actually connected.

Cause: ShellSock is unable to detect the CD line status.

Technical: CD line in your serial cable may not be connected at all!

Possible Solutions:
The simplest solution is to ask ShellSock to ignore the CD line status. This is done by modifying the DetectCarrier entry in the "winsock.ini" file.Locate the entry "DetectCarrier=Yes" in the winsock.ini file using a normal text editor like notepad and modify it to "DetectCarrier=No". Alternatively you could get your serial cable checked up.


Problem:
Pictures at hotmail.com don't load up

Cause: Somewhere along the way, we got mixed up between the network byte ordering and host byte ordering and as a direct result, attempting to access a resource with "Use Lynx" checked by referring to its IP number will not work. "hotmail.com" uses this facility to load up pictures.

Possible Solutions:
While accessing your hotmail account, temporarily turn off "Autoload images" and make sure "Use telnet" is checked in ShellSock setup.


Problem:
Netscape Mail / News clients will not work on the student servers.

Cause: We couldn't figure out a method of disabling the echo of the "telnet" program on the student servers.... and as a direct result, netscape mail and news clients will not work correctly.

The normal 5000/- Rs shell account, the echo of "telnet" can be disabled by using the string "^E ^E ^E" . We need to find a string that would have a similar effect on the student server "telnet" program. Any help in this regard appreciated.

Possible Solutions:
Use "Eudora" ver 1.5.4 or above. Remember to check "Use Asychronous Winsock Calls" in Network setup of Eudora. Also "Use Telnet" of ShellSock setup should be checked.


Problem:
Eudora says "Connection timed out." or "Unable to connect to server" when I select "Get Mail".

Causes: "Use Telnet" is not checked in ShellSock Setup.
The pop3 server is probably not present on your student server.

Possible Solutions:
Make sure that "Use Telnet" option is checked in ShellSock setup when using any mail or news clients. Ask helpdesk for a pop3 server to be installed. (Even the dialup method of Eudora requires this). As of now, giasmda, giasbga and giasbma have pop3 servers functional. In a worst case senario, you can always .forward mail to different pop3 account and use Eudora read it off from there. There are some freenets that support pop3 servers.


Problem:
Eudora says "HELO giasxx.xxx.xxx.xxx" when sending mail and does not proceed.

Cause: Eudora is using the blocking hook method which ShellSock does not support.

Possible Solutions:
Use "Eudora" ver 1.5.4 or above. Remember to check "Use Asychronous Winsock Calls" in Network setup of Eudora. Also "Use Telnet" of ShellSock setup should be checked.


Problem:
The first time, the mail send works just fine. However the next time, Eudora says that it was unable to connect up with the server. The third time I try to send, Eudora again works correctly.

Cause: Eudora is caching IP numbers to the mail server. The second time you try to send, Eudora tries to connect up using the IP number only. However since ShellSock relies on pseudo IP numbers, Eudora is searching for a non-existant IP address. The third time, Since an error was encountered Eudora looks up the domain name again and therefore will work correctly.

Possible Solutions:
Uncheck the option "Cache network info" in Network setup of Eudora.


Problem:
Eudora/netscape says "An error occured when sending your User Name" when I try to get my mail.

Cause: This error will occur on the giasbm01 server due to a entirely different version of the pop3 server installed there.

Possible Solutions:
Netscape mail won't work. Use "Eudora" ver 1.5.4 or above. Remember to check "Use Asychronous Winsock Calls" in Network setup of Eudora. Also "Use Telnet" of ShellSock setup should be checked. Locate entry "EchooffPorts=110,119,6667,7000" in the "winsock.ini" file. and replace it with "EchooffPorts=119,6667,7000".


Problem:
Netscape says "HTTP: Access authorization required, use the -auth=id:pw parameter"

Cause: You are trying to access a password protected web page with only "Use Lynx" checked in ShellSock setup.

Possible Solutions:
Check "Use Telnet" in ShellSock setup and then try to access the web page.


Problem:
I am logging into VSNL using the guest account as my account is on a different server. How do I use ShellSock with it?

Possible Solutions:
Login as guest, and from the menu select the "server" to which you want to proceed to. You will now notice "Trying 202.xx.xx.xx" on your screen, followed by "Connected to giasxx....." etc. At this point press ^] (i.e. ] ). The "telnet>" prompt will now appear on the screen. Type "set escape ^P" and press enter. ^P is P. Now log on as usual, come to the shell prompt and click on the [done] button of the ShellSock terminal window.


Problem:
VSNL lines are always busy.... Can I setup ShellSock to automatically redial?

Possible Solutions:
Unfortunately this is not possible, but we can suggest some useful alternatives. Although we have not incorporated a dialler. You can utilize the init string in setup of ShellSock as a simple dialler. Simply add "dt 887615" (where 887615 would be your VSNL shell account number) to the existing init string (use dp if pulse dial). Using this method, ShellSock will always dial the number specified when it initializes the modem. To redial, simply click on the "Init" button in the terminal window or use the ALT_I shortcut. If you wish to abort while dialling, simply press . You can also utilize your existing communication program to do the dialing and logging in for you and then exit your communication program and start off Netscape/Explorer. To achieve this, you might have to specify "AT &D0" in the modem initialization string of your communication program. As long as the line is still active and the communication settings of both ShellSock and the Communication program match.. this method will work correctly.


Known Limitations of the ShellSock:

  • 32-bit software do not work with ShellSock:

    ShellSock currently supports only 16-bit client software. Even on Windows 95, ShellSock together with a 16-bit client software will work correctly.

  • FTP Clients:

    Due to the rather complicated juggling required to emulate a ftp connect, ShellSock does not currently support ftp clients or ftp access.

  • Reduced Functionality of certain software:

    ShellSock can emulate only one connect at a time. Some options like (finger in an IRC client) may not work while you are actually chatting online.

  • No support for any Server software:

    This should be pretty obvious. You cannot run a web server on this emulation.

  • No support for UDP/ raw sockets:

    Utility programs like PING will not work as shellsock does not implement support for UDP/ raw sockets. ShellSock currently emulates only the TCP protocol.

  • Programs that convert IP numbers to Host Names and Vice Versa:

    These programs will not display the correct IP address or Host Name. This is because ShellSock uses a method of false IP no/ Name allocation to satisfy such programs.

  • Programs that use blocking hooks:

    ShellSock does not implement the blocking hook method and as such any programs that uses blocking hooks will not work correctly. Whenever configurable, try to use the asynchronous type socket calls only.

  • Some images are shown to be broken:

    ShellSock relies on the extension of the file to determine the method of transfer. Unfortunately on some web sites, the graphics counter image has a .html extension and therefore such images will not be transferred correctly. One solution is to check "Use Lynx" only for browsing and check "Use Telnet" for chatting, email or news.

  • Large Posts Info may cause problems:

    Due to inherent technical limitations of the telnet buffer length at the unix server, posts larger than 255 bytes have to be broken up for information to be correctly transmitted. However in some cases this breaking up of the posts may not be recognized by some www servers which stop as soon as they get the CR LF.


If the above material did not provide you with a clue to the solution of your problem, please send in a explanation of the problem faced to the address given below.
shellsock@xtendmail.com
Copyright 1997 Xtend Technologies (P) Ltd, "Blue Hill", Kalathiparambil Lane, Ernakulam South, Kerala - 682 016. INDIA. All Rights Reserved