The software described in this guide is furnished under a license agreement and may be used only in accordance with the terms of the agreement.

Information in this document is subject to change without notice. The names of companies, products, people, characters, and/or data mentioned herein are fictitious and are in no way intended to represent any real individual, company, product, or event, unless otherwise noted. Complying with all applicable copyright laws is the responsibility of the user. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of WinAbility Software Corporation. WinAbility Software Corporation may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from WinAbility Software Corporation, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property.

NO WARRANTY

The technical information in this document is provided AS-IS and WinAbility Software Corporation makes no warranty as to its accuracy or use. Any use of the information contained herein is at the risk of the user. This document may include technical or other inaccuracies or typographical errors.

Copyright Notice

© 2004 WinAbility Software Corporation. All rights reserved.

Trademarks

WinAbility, WinAbility.Com, HostName Commander, and "The Way Software Should Be!" are either registered trademarks or trademarks of WinAbility Software Corporation and/or its suppliers in the U.S.A. and/or other countries. Other product and company names mentioned in this document may be the trademarks or registered trademarks of their respective owners and are hereby acknowledged.

Thank you for choosing HostName Commander!

HostName Commander is a software utility that helps you manage the relationships between the host names and the IP addresses of the computers.

(If you are not sure what a "host name" or "IP address" is, you can find a short introduction into the subject here.)

You can use HostName Commander to control which servers your web browser connects to when you (or another user of your computer) enter particular host names into its address bar. If you are a web developer, you will find it convenient to use HostName Commander to quickly switch between the development and production servers while working on your web scripts and web pages. Even if you have nothing to do with web development, you can use HostName Commander to block access to specific web sites, by assigning an invalid IP address to their host names. In particular, you can use this ability to suppress the third-party advertisements displayed by many web sites.

If you are a web developer

If you develop complex, interactive web sites, you probably design them on your local development server, before uploading the web pages and scripts to the production server. For example, if the domain name of your web site is www.mycoolsite.com, then during the development phase you want the host name www.mycoolsite.com to point to your development server (or to your own computer, if you don't have a separate development server). When the development is finished and the site goes live, you want the name www.mycoolsite.com to point to your production server, to make you able to test the live web site and see it just like the rest of the world does. When developing and maintaining a non-trivial web site, you are probably switching back and forth between the development and productions servers may times. If you do that by manually editing the Windows HOSTS files, you have probably wondered many times, there should be a better way of doing it, haven't you?

As a matter of fact, there IS a better (as in faster and more efficient) way of managing your host names, and this is what HostName Commander is all about. With HostName Commander you are be able to switch the server your web site name points to with just a couple of clicks of the mouse, any time of the day or night, and see the result immediately (well, almost immediately). When you need to test the web site on the development server, you would use HostName Commander to make the host name www.mycoolsite.com to resolve to the IP address of your development server (such as 127.0.0.1, if it's your own computer, or something like 192.168.0.5, if the development server is on your LAN). When you no longer want the host name of your site to resolve to the development server, HostName Commander would let the DNS server resolve it to the IP address of the production server.

If you tried to manage the host names manually before, you know that the web browser cache is often causes annoying problems when you switch the host name from one server to another: even when you make the host name to point to a new server, the web browser keeps displaying the pages from the cache that it previously downloaded from the old server. To solve this problem, you would need to manually open the web browser cache and clean or empty it after each change to the host name. With HostName Commander this problem is no longer a problem: it can clean up the browser cache for you automatically after each change from the development to production server (and back), removing from the cache only the pages which belong to the web site affected, and leaving the rest of the browser cache intact.

HostName Commander comes especially handy when you develop a large number of different web sites for different clients. HostName Commander lets you see and control all host names of the web sites you manage using the convenient and straightforward user interface, that lets you manipulate the host names of your web sites quickly and easily.

If you want to block certain web sites

The ability of HostName Commander to point web site names to arbitrary IP addresses makes you able to stop users of your computer from viewing the unwanted web sites, by mapping their host names to the invalid IP addresses.

For example, if your child is working on a term paper about the US government, you don't want him or her to accidentally type into the web browser the address whitehouse.com and end up at an infamous adult web site, instead of the web site devoted to the home of the US President (which correct address is whitehouse.gov).

With HostName Commander, you can assign some invalid IP address (such as 127.0.0.1) to the host names whitehouse.com and www.whitehouse.com, and that will make the web browser to display the Web site not found or a similar error message, when trying to see the contents of the blocked web site.

Even better, you can determine the actual IP address of the whitehouse.gov server, and assign whitehouse.com and www.whitehouse.com to that address, too. This way, no matter which address your child has entered into the browser, both whitehouse.gov and whitehouse.com will take him or her to the US President's home web site.

If you want to block third-party web ads

You can use the ability of HostName Commander to point web site names to arbitrary IP addresses to block the third-party web advertisements from being displayed on the web pages or in the popup windows while you are browsing the Internet.

A third-party ad is an image that is loaded by a web site from a separate server, with a host name different from the host name of the main web server. For instance, many web advertisements come from the adserver.com web site. If you use HostName Commander to point the name adserver.com to some invalid IP address (such as 127.0.0.1), the web browser will not be able to connect to adserver.com, and that in turn will make it unable to download the advertising images from that server. As a result, the blank image placeholders will be displayed on the web pages instead of the actual advertisements. Since the main contents of a web site is loaded from a server with a different host name (such as www.cnn.com or www.news.com), the main content of the web pages will not be affected by the blocking of the adserver.com site.

(Of course, this method of blocking web ads works only if the main content and the ad images on a particular web page are served from different servers. If a particular web page displays ads from the same server as its main content, you cannot block the ads, because if you were to assign an invalid IP address to the server's host name, that would stop the delivering of the main content of the web site, too. If the sites you visit most display ads from their own servers, use the ad-blocking software specifically designed to filter web content and block web ads it contains.)

HostName Commander features easy and intuitive user interface with full support for the drag-and-drop operations, visual editing, customizing, importing and exporting of the host name lists, and more.

If you have not done so yet, visit our web site now and download a free no-strings-attached evaluation version of HostName Commander, to see for yourself how easy your name host management can be with it:

Version 1.0 (October 14, 2003)

The first release of HostName Commander.

HostName Commander is designed for operating systems Windows 98 and higher (including Windows Millennium), and Windows XP/2000 and higher.

There are no special requirements or recommendations except the obvious one: the better processor and more RAM your computer has, the better HostName Commander will perform. At least 1 MB (one megabyte) of free space on your hard disk is required to install HostName Commander. HostName Commander can be used both on a stand-alone computer and on a network.

Note: Throughout HostName Commander documentation, Windows is used to refer to Windows 98/Me and Windows XP/2000. In those few instances where the operation of HostName Commander under these operating systems differ, an explicit operating system name is used.

  • If you use Windows XP or Windows 2000, login as the administrator, or as a power user. If you login as a regular or limited user, you may not be able to install or use this software.

  • To begin the installation, simply run the installation file. If you do not have the installation file, please visit our web site to download the latest version:

    http://www.winability.com/download/

  • Note that if you have a previous version of this software already installed on your computer, the installation utility may prompt you to restart the computer, in order to be able to replace the files currently in use by Windows.

  • The installation program will walk you through the process of setting up HostName Commander. You will be prompted to read and accept the End User License Agreement, and to select the installation options such as the folder where to copy the files.

  • After you press the Finish button, the installation program will copy the files into the specified folder and configure Windows for using HostName Commander.

  • IMPORTANT: Make a backup copy of the installation file with the evaluation version of HostName Commander that you have downloaded from our web site, as well as a copy of the message with your license key, on a floppy or other removable disk, because if you ever need to reinstall the software, you will need both, the installation file and your licensing information to install the program in the fully-licensed mode. It's not enough to store the files on your hard disk, because when (not if) it crashes, you will lose the files. (Yes, hard disks do crash, believe us!) We provide for download from our web site the latest versions of the installation files only. When we release an updated version, we remove the older version from the download area, so the installation file with the version that you have purchased may not be available for download in the future. Remember, it's your responsibility to backup your important files! If you do misplace your license key or the installation file that we no longer offer for download, please use this link to order a replacement:

    http://www.winability.com/lost_file_or_key/

To completely uninstall HostName Commander, it's not enough to simply delete its program files from the installation folder. To completely remove HostName Commander from your computer, follow the instructions below.

IMPORTANT: If your computer is configured for several user accounts, login as the same user as the user you were logged in when you installed HostName Commander. If you use Windows XP Fast User Switching, log off from all other accounts before trying to uninstall HostName Commander.

Automatic removal

Method 1. Click on the Start button at the bottom of your screen, choose Programs - HostName Commander - Uninstall from the menu, and follow the instructions.

Method 2. Open Windows Control Panel, open the Add/Remove Programs item and use it to uninstall HostName Commander.

Manual removal

Follow these steps to manually remove HostName Commander from your computer:

a. With Windows Explorer, delete the folder where you have installed HostName Commander (confirm that you want to delete the files that that folder contains, if prompted);

b. With Windows Explorer, delete the shortcuts to HostName Commander files, if any, from your personal Start Menu, Start - Programs menu, Desktop, and from the Quick Launch toolbar (refer to Windows Help for more information about these objects of Windows user interface);

c. With Registry Editor, delete the following keys, if any:

HKEY_CURRENT_USER\Software\WinAbility\HostName Commander

HKEY_LOCAL_MACHINE\Software\WinAbility\HostName Commander

HKEY_LOCAL_MACHINE\Software\HostName Commander

d. If you have enabled the option to display the taskbar icon of HostName Commander, delete the value HNC_TBI from the following keys, if any:

HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Run

e. Finally, if you want to restore the original host name information that was in effect before you have installed HostName Commander, open Windows Explorer and navigate to the following folder:

C:\WINDOWS\system32\drivers\etc (if you use Windows 2000, XP, or Windows Server 2003 or later)

or

C:\WINDOWS (if you use Windows 98 or Me)

In this folder, select the file HOSTS (or hosts) and rename it to HOSTS.HNC. Then, in the same folder, select the file HOSTS.backup (or hosts.backup) and rename it to HOSTS (or hosts).

That will conclude the manual removal of HostName Commander.

  1. A license key, allowing you to use the program without the registration reminders displayed by the evaluation version.

  2. FREE upgrades to the updated versions of HostName Commander released within one year after the date of purchase (Both minor and major upgrades are free within one year).

  3. FREE support by email for at least three months after the purchase.

  4. Optional CD-ROM delivery of the software.

Related topics:

What is HostName Commander?

HostName Commander is a software utility that lets you manage the relationships between the host names and the IP addresses of the computers.

What is a host name?

Host name is a textual label assigned to a computer, to distinguish it from other computers on the network. On the Internet, host name has the same meaning as web site name, or domain name. For instance, www.microsoft.com is the host name of the Microsoft's web server. You enter the host name into the address bar of your web browser to tell the browser which server you want to connect to. However, before the web browser can connect to the web server, it must determine the correct IP address of the target computer.

What is an IP address?

IP address is a set of four numbers, each between 0 and 255, separated with dots. For example, 168.192.0.1 is an IP address. Each computer connected to a network has its own IP address, and the Internet uses the network addresses to direct the data between the computers attached to the network.

How do the host names and IP addresses relate to each other?

Each valid host name is assigned to the appropriate IP address, and the table of such assignments is maintained by the special computers called DNS servers. When you enter a host name into a web browser, the browser sends the host name to the DNS server first, which replies with the IP address that corresponds to that host name. Then the web browser connects to the web server using its IP address. (You might not notice that, because the communication with the DNS server occurs very quickly.)

So where does HostName Commander fit in this picture?

HostName Commander acts as a negotiator between the web browser and the DNS server. That is, when a web browser or other Internet-related program issues a request to resolve a host name to its IP address, HostName Commander checks the host names that you have set up with it, and if the matching host name found, returns the IP address you have assigned to that host name, without contacting the DNS server. The web browser uses the IP address provided by HostName Commander to connect to the server, again without contacting the DNS server. If you have not set up an IP address for that host name with HostName Commander, the request for teh IP address is passed on to the DNS server, as usual. So, with HostName Commander you can control which servers correspond to the host names, overriding the information provided by the DNS servers.

How can I use the ability of HostName Commander to assign IP addresses to the host names?

You can use it to control which servers your web browser connects to when you (or another user of your computer) enter particular host names into its address bar. If you are a web developer, you will find it convenient to use HostName Commander to quickly switch between the development and production servers while working on your web scripts and web pages. Even if you have nothing to do with web development, you can use HostName Commander to block access to specific web sites, by assigning an invalid IP address to their host names. In particular, you can use this ability to suppress the third-party advertisements displayed by many web sites.

When you run HostName Commander, it displays the current host name information for your computer as a tree-like structure:

(Note that if you are running HostName Commander for the fist time, and you have not previously set up any host names, you could see a blank window, or a window with just one IP address, 127.0.0.1, with only one host name "localhost" mapped to it.)

The main window of HostName Commander displays the list of the IP addresses, with the lists of the name hosts mapped to each IP address. To map a host name to an IP address, you would use the Add Host Name command to add a host name to one of the IP addresses displayed in the window. After a host name has been added, you could activate or deactivate it, by clicking on the checkbox next to the host name with the mouse. When you activate a host name, you make it resolve to the IP address it is attached to, and all network requests to that host name would be directed to the computer with that IP address. When you deactivate a host name (by clearing the check box next to it), you break the relationship between the host name and the IP address, and that makes the host name to resolve as usual, as if HostName Commander were not present in your computer at all.

HostName Commander lets you create several groups of host names mapped to the same IP address, to make it easier to manage such groups independently on each other. You can enter short comments for both the IP address and the host names, which are displayed in the parenthesizes next to the IP addresses and host names. You can move the host names between the IP addresses with the mouse or using the Move Up/Down commands.

To add a new host name, choose the Add Host Name command of HostName Commander, by clicking on the appropriate button in the toolbar, or by pressing the Ins key. This command will open the Add New Host Name dialog box:

This dialog box has the following areas:

Host Name

The host name you want manage with HostName Commander

Comment for this host name

An optional descriptive text you want to be displayed in the window next to the host name itself. The maximum length of test that you can enter here is 255 characters, including spaces and punctuation.

Connect this host name to the exiting IP address

Select the existing IP address you want to map this host name to.

Create a new IP address for this host name

Select this option if you want to create a new IP address and map this host name to it.

Note that you can also add a new IP address to the HostName Commander window without adding a new host name to it. To do that, choose the Add IP Address from the menu or press the Ctrl+Ins keys to display the

The Add New IP Address dialog box lets you enter the IP address and comment for the new group of host names. Note that you can create several groups of host names even if they are mapped to the same numerical IP address, to be able to quickly enable/disable such groups of host names independently on each other.

You can modify the text of a host name or IP address by selecting it in the HostName Commander window and then clicking on it with the mouse once (or by pressing the F2 key), just like you would go about renaming a file in Windows Explorer:

Note that the Allow in-place editing option must be enabled in order for this method of modifying the host names and IP addresses to work. Also, only the text of a host name or IP address can be changed this way; to change the comment and other properties of an item use the Edit command described below.

To modify all properties of a host name that already exists in the HostName Commander window, select it and choose the Edit command from the menu of HostName Commander, by clicking on the appropriate button in the toolbar, or by pressing the Enter key. You can also double-click the host name in question with the mouse. This command will open the Edit Host Name dialog box:

This dialog box has the same areas as the Add New Host Name. Simply make the desired changes and press the OK button to save the modifications to the host name.

You can also modify the new IP addresses displayed in the HostName Commander window, using the same Edit command of HostName Commander. If you select an IP address before choosing the Edit command, the Edit IP Address dialog box is displayed, which you can use to change the numerical value and comment of the selected IP address:

To delete a host name, select it in the HostName Commander main window and choose the Delete command, by clicking on the Delete button in the toolbar: , or by pressing the Del key. If the Confirm delete option has been enabled, you will be prompted to confirm that you indeed want to delete the host name. If you confirm the operation, the selected host name will be removed form the list.

If you select the IP address before choosing the Delete command, the selected IP address will; be deleted, as well as all host names listed under it.

If you have deleted a host name or IP address by mistake, you can restore the deleted item back using the Undo command. Note that only the last 25 changes can be reverted by the Undo command. Also, the Undo information gets refreshed when you restart HostName Commander, so all changes you've made would not be reversible after you have exited HostName Commander. We recommend to backup the current name host information in a separate file, before making extensive changes.

Note that if you want to temporarily stop Windows from using the information you have set up for a particular host name, you can simply deactivate it, instead of deleting it. This way, if you decide later on to start using that host name again, you would simply activate it back, without having to create it from scratch.

You can set each host name to be either active or inactive at any given time. Only the active host names are actually connected to the appropriate IP addresses. If a host name in an inactive state, it is not mapped to its IP address, as if the host name were not present in the HostName Commander list at all. The check box displayed next to each host name can be used as a visual indicator of the state of that particular host name. If there is a check mark present on the checkbox, the host name is in active state. If there is no check mark displayed, the host name is in inactive state.

You can activate or deactivate all host names under the same IP address, by clicking with the mouse on the check box displayed next to the IP address (or by pressing the Space bar while the IP address is selected). After each click, the state of the check box is changing from cleared to checked to grayed and back to cleared. When the check box next to an IP address is cleared, all host names listed under that IP address become deactivated:

If you make a checkmark to appear on the box next to the IP address, all host names mapped to that IP address become active:

Finally, when you make the check box next to the IP address to be "mashed", each host name under that IP address may be activated or deactivated independently on other host names, by clicking on the check boxes next to the host names:

Note that only if the checkbox next to the IP address is "mashed" you can change the state of the individual host names under that IP address. If the checkbox next to an IP address is cleared or has a checkmark in it, it affects all host names under that IP address and prevents you from changing their states individually. When the state of a host name is controlled by its parent IP address, the background of the checkbox next to the host name becomes gray.

You may want to practice activating and deactivating the host names by clicking on the check boxes next to them as well as on those next to the IP addresses, and observe the changes caused by your actions, to get a better understanding of how the states of the host names can be changed.

You can change the order in which the host names are listed under the IP addresses by moving them using the Move Up and Move Down commands (or by pressing the Ctrl+Up and Ctrl+Down keys):

When resolving host names to the IP addresses, the host names are processed in the order they appear in the HostName Commander window. You may want to move the host names you use most closer to the top of the list, to improve the performance.

You can also move the whole groups of the host names that belong to the same IP address by moving the IP addresses themselves.

Note also that instead of using the Move Up and Move Down commands, you can also drag and drop the host names and IP addresses with the mouse, in the same way as you would drag and drop files and folders in Windows Explorer.

In order for the changes you make to become effective, you must save the changes by using the Save Changes command, or by pressing the Ctrl+S key.

Keep in mind, however, that some network software keeps the mapping of the host names to the IP addresses in a cache, and the cache may not become updated when you save the change. (The details of updating the cache are program-specific and depend on each program's the implementation). This means that although the new mappings of the host names to the IP addresses become effective immediately after you save the changes, some network programs may still use the old information, as it was stored in their cache. If this causes a problem with your software, you can usually just restart it to force it to update its cache. In the worst case scenario, you may need to restart Windows in order the new host name information to take effect, but such situations are rare.

Another issue that may prevent your Internet programs from using the updated host name information is the web browser cache, where the web pages of the recently visited web sites is stored between the sessions, to speed up the loading of the pages that were already loaded by the browser during the previous visit to a web site. If the browser has saved a web page form a web site in its cache, and later you have mapped the host name of that web site to a different IP address, the browser may not detect the change and keep displaying the web page from its cache, even though it must be fetched from a different server now.

To solve this problem, HostName Commander prompts you to clean up the web browser cache for the web sites for which you have modified the host name information.

As you probably know, web browsers usually store the pages they display in the web browser cache, so that the next time you want to view the same page, the browser would not have to download it all again, and display the version of the page that was previously stored in the cache. Usually this helps increase the speed of the browsing, however it may cause a problem when you use HostName Commander to change the IP address for some host name: if your web browser has saved a web page from a web site with that host name in its cache, and later you have mapped the host name of that web site to a different IP address, the browser may not detect the change and keep displaying the web page from its cache, even though it must be fetched from a different server now.

To solve this problem, HostName Commander prompts you to clean up the web browser cache for the web sites for which you have modified the host name information. When you save the changes, HostName Commander detects which host names might need to be updated, and displays the following prompt:

HostName Commander automatically places the check marks for the host names which were modified, and leaves the rest of the host name unchecked. You can modify the list of the host names for which you want the web browser cache to be cleaned by checking or clearing the check marks next to the host names in the list displayed.

You can also select one of the options offered to control how the Clean up Browser Cache should be displayed next time:

If you press the Yes button on the Clean up Browser Cache prompt, HostName Commander will remove the web pages form the web browser cache for the host names checked in its list, forcing the web browser to load the fresh copies of the web pages the next time you are visiting the web site in question. Note however, that you may need to restart the web browser to actually force it to load the updated pages; because even if a web page is no longer in the cache, the web browser can still keep a copy of it in its memory!

Note that you can use the Clean up Browser Cache command at any time, without saving the changes to the host name information: simply click on the little down arrow next to the Save Changes button to display a menu, and then choose Clean up cache from the menu.

Note also that only the cache of Internet Explorer is currently can be cleaned up with this command; other web browsers are not supported at this time.

HostName Commander allows you to quickly turn off the host name information you have set up with it, and let Windows perform the host name resolution as usual, as if HostName Commander were not present in the system. You may find this feature of use when, for instance, the host name information you have set up causes a web site not to display properly. Or, if you have configured HostName Commander to block some web sites from other users of your computer, but you want to see the blocked websites yourself.

The quickest way to disable HostName Commander is by choosing the Disable command from the menu of the taskbar icon. Note that you can choose to protect this command with a password, to prevent unauthorized users from disabling HostName Commander without your permission. If you have the main window of HostName Commander on the screen, you can also choose the Disable command from the Save Changes menu, to achieve the same result.

When you disable HostName Commander, all host name mappings you have set up with it become inactive, and ignored by Windows when resolving host names to the IP addresses. Note that, as in case when you save changes to the host name information, you may need to restart your web browser or other software that accesses the Internet, in order for the new disabled state of the host names to become effective.

To return HostName Commander back into the enabled state, choose the Enable command form the taskbar menu. If you have the main window of HostName Commander on the screen, you can also choose the Enable command from the Save Changes menu, to bring the host name information back in the active state. Again, in order for the change to take effect, you may need to restart your web browser.

Suppose you have collected a long list of host names of the web servers supplying the web ads to other web sites, and you want to send that list to a friend of yours, to make him or her able to block the web ads, too. Instead of typing in all the host names into an email message, you could use the Export Host Name List command of HostName Commander to prepare such a list for you. To use this command, first select the IP address which host names you want to export, and click on the little arrow next to the Annd Host Name button:

Choose the Export Host Name List command from this menu to display the following dialog box:

Here you can select the IP address from which you want to export the list of the host names; the host name list itself is displayed in the Host name list area.

You can also choose among the following options which affect the contents of the exported list:

  • Include header with the IP Address information

    If you select this option, the first line of the list will contain information about the IP address from which the list is being exported. This option is useful if the recepient of the list is going to eventually import the list into another copy of HostName Commander: the header would provide the information where the list should be imported.

  • Include comments

    If you select this option, then the comments for the hostnames would be exported along with the host names themselves. Select this option if you want the recipient to be able to see your comments and import them along with the host names into his or her copy of HostName Commander.

To save the list into a file, click on the Save to file button and then enter the file name for the file in which to save the list. Or, simply select the text displayed in the Host name list box, and press Ctrl+C to copy it onto the Windows Clipboard. Then switch to your email program, and paste the list directly into the email message to send to the friend.

If you have a long list of host names which you want to enter into HostName Commander program, you don't have to type them all manually, you can use the Import Host Name List command of HostName Commander to import such a list fast. To use this command, first select the IP address where you want to import the host name list, and click on the little arrow next to the Add Host Name button:

Choose the Import Host Name List command from this menu, to display the following dialog box:

Paste the list of the host names that you want to import into the Host name list box. Or, if you have the list saved in a file, click on the Load from file button to load the list into the Host name list box from that file. You can also type the host names in, one host name per line.

Note that if the first line starts with the symbol #, it is considered a "header" of the list, and HostName Commander attempts to use information it contains to automatically select the IP address to add the host names to. Specifically, if the first line starts with the character #, followed by an IP address, followed by a comment in parenthesis, HostName Commander will attempt to select the IP address with that comment in the Add these hosts to the existing IP address list for you. If the first line does not follow the format described, it is not used as the header of the list. Note also that the header is used only when you paste the list into the box or load it from a file; if you type in the list manually, the header is not used and you should select the correct target IP address yourself.

The list of host names may contain lines which start with the # character; such lines are ignored during the importing of the host names, even if the rest of the line contains a valid hostname. If you want such lines to be processed, you should remove the # characters from them. Also, each line with a host name may contain an IP address in front of the host name (such format is common for the HOSTS files). In this case, HostName Commander will skip and ignore the IP address, because you specify the IP address to add the host names to using the dialog box itself.

Finally, the list of host names may contain not only the host names themselves, but also their comments. The comments must be on the same line as the host names their belong to, and they should be separated from the host names by at least one space character.

After you have inserted the list of the host names into the Host name list box, select the IP address to which you want the host names to be added (or choose to create a new IP address for this list, if desired) and press OK. The host names from the list will be added to that IP address for you by HostName Commander.

Although all commands of HostName Commander are available as the menu items which you can select with the mouse, you may find it convenient to use the following keyboard shortcuts for faster access to the commands:

To Press Notes
Add New Host Name Ins 
Add New IP Address Ctrl+Ins 
Delete Host Name or IP Address Del 
Edit Host Name or IP Address F2 Only if the appropriate option is enabled
Edit Properties Enter 
Undo last command Ctrl+Z 
Move Up Ctrl+Up 
Move Up Ctrl+Down 
Save Changes Ctrl+S 
Change Options of HostName Commander  Ctrl+O 
Display User's Guide for HostName Commander  F1 
Exit HostName Commander  Esc Only if the appropriate option is enabled

HostName Commander offers you the option to display its icon in the Windows taskbar notification area, next to the system clock. If you choose this option, you can click on the icon to display a menu with commands to open the main window of HostName Commander, as well as to quickly enable or disable HostName Commander, without the need to open the main window of HostName Commander.

The taskbar icon also serves as a visual indicator of the state (enabled or disabled) of HostName Commander:

  • HostName Commander is currently enabled
  • HostName Commander is currently disabled

Note that you can choose to protect the commands on the taskbar icon menu with a password, to prevent unauthorized users from disabling HostName Commander without your permission.

You can customize the behavior of HostName Commander in some situations to better suit your requirements and personal working style by changing its options. To change the options, press the Options button on the menu bar: (or press the Ctrl+O keys). As a result, the Options dialog box will be shown:

This dialog box contains the following areas:

HostName Commander prompts you to enter your license key when you run it: simply press the Enter License Key button on the welcome screen and enter your licensing information into the form.

Alternatively, when the main window of HostName Commander is displayed, click on the little arrow next to the Help button in the menu bar, and choose About from the pop-down menu. Then click on the Register button in the dialog box.

IMPORTANT: When entering your licensing information, make sure you enter your name and the license key exactly as they are shown on your Registration Acknowledgment, including all capitalization and punctuation. Otherwise, HostName Commander may not accept the license key or may not register your information properly. You may wish to copy and paste the name and key from our message into the dialog box areas, to avoid typos.

Yes, you may give evaluation copies of our programs to your friends and associates. However, you may NOT share your license key, if any, with anybody else. Please remember that the license key we provide you with are for your own use only. If your friends like our programs, please let them purchase their own license keys. To avoid possible confusion, please give out the original installation files with the evaluation versions that you may download from our web site.

There are several other simple, but important conditions which we impose on further redistribution of our programs. Unless you have obtained a written permission from us to do otherwise, you must:

  • Include ALL of the UNMODIFIED original files of the evaluation version.

  • Inform the user that the evaluation copies are for the evaluation purposes ONLY.

  • Not charge for the evaluation copies.

  • Not bundle our software with other programs.

  • Once again, you may not share the license key.

Please refer to the file License.txt in the folder where you have installed HostName Commander for the complete description of our distribution requirements.

If you have used the Options dialog box to protect HostName Commander with a password, and later you cannot remember the password you've set up, you can reset (erase) that password by using the Reset Password command, usually available on the Start - Programs - HostName Commander menu.

If the Start - Programs - HostName Commander - Reset Password command is not present (for example, because you did not choose to create the Programs menu items for HostName Commander during the installation), you can open the Reset Password dialog box by running the file HostNameCmdr.exe with the command line switch /PW. That is, if you have installed HostName Commander into its default installation folder, choose Start - Run and enter the following command in the command line box:

"C:\Program Files\WinAbility\HostName Commander\HostNameCmdr.exe" /PW

(Make sure there is a space character between the path to HostNameCmdr.exe and the /PW switch!)

When the Reset Password dialog box appears on the screen, it will prompt you to enter your licensing information, and if you have entered it correctly, it will erase the password. (The prompt for the licensing information is necessary in order to stop unauthorized users from erasing the password without your permission.) If you have not purchased a license yet and are using HostNameCmdr.exe in the evaluation mode, the Reset Password dialog box lets you erase the password without entering the licensing information:

After the password has been erased, run HostName Commander and use the Options command to set up a new password, if you want it to be protected again.

You can use the PING utility included with Windows to determine the "real" IP address of a web site. Before using this utility, make sure you are not mapping a host name to some IP address with HostName Commander, because if you do, the PING utility will show the address you've set up with HostName Commander, instead of the "real" IP address. If you do have set up an entry for the web site in question with HostName Commander, you need to temporarily deactivate it before using the PING utility.

To run the PING utility, click on the Windows Start button, and choose Run from the Start Menu. If you use Windows 95,98, or Me, enter "command" (without the quotes) as the command line to run. If you use Windows XP,2000, or NT, enter "cmd" (again, without the quotes). Click OK and the command prompt window should appear on the screen.

Now enter the word "ping" (without the quotes) followed by a space, followed by the host name you want to determine the IP address of, and press Enter:

In this example, the IP address of the host name www.whitehouse.gov is 205.161.7.127 . (Keep in mind that the IP address may change in the future!). If the PING utility reports an error, make sure your computer is connected to the Internet when you are running it.

As of this writing, there are several lists of the ad servers available on the Internet, some of which are listed here:

http://www.winability.com/hostname-commander/adlists.htm

Please note that these lists are maintained by independent parties, which we have no control of. Use them on your own risk!

Yes, you can use HostName Commander to block adult web sites, if you can find a comprehensive list of the host names of such sites. Keep in mind that new adult sites with new host names appear daily, so keeping track of all of them is not practical. Instead of HostName Commander, we recommend to use web-filtering software that blocks access to the adult sites by analyzing the content of the web pages downloaded from them. This makes such blocking more effective. There are many content filtering programs available on the Internet, use you favorite search engine and you may find something suitable for your requirements.

This user's guide is available online in the printed-friendly format:

http://www.winability.com/hostname-commander/users-guide-printable.htm

Simply open the link above in your web browser and use the web browser's Print command to print it out on your printer.