home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / communication / ps_if.README < prev    next >
Encoding:
Text File  |  1996-06-26  |  3.6 KB  |  122 lines
  1. README.English for ps_if: loadable kernel driver for multiple virtual IP hosting
  2.  
  3. This is a NeXT Mach loadable device driver for virtual hosting multiple IP
  4. addresses on a single NEXTSTEP host.
  5.  
  6. The driver allows you to use Web server software such as NCSA httpd 1.5
  7. (and later), and Apache httpd with the virtual hosting enabled.
  8.  
  9. The author is manmos@stellar.co.jp (Hideo "Sir MaNMOS" Morishita),
  10. Stellar Craft Inc., Osaka, Japan.
  11.  
  12. The source and binary have been posted in fj.sources.
  13. Here's the posting data for the article:
  14.  
  15. Newsgroups: fj.sources
  16. From: manmos@stellar.co.jp (Hideo "Sir MaNMOS" Morishita)
  17. Subject: Pseudo network interface driver(1/1)
  18. Supersede: <MANMOS.96Jun25170440@antares.stellar.co.jp>
  19. Message-ID: <MANMOS.96Jun25174855@antares.stellar.co.jp>
  20. Organization: Stellar Craft Inc., Osaka, Japan
  21. Distribution: fj
  22. Date: Tue, 25 Jun 1996 08:48:55 GMT
  23. Lines: 428
  24.  
  25.  
  26. This is a rough English translation by an anonymous translator.
  27.  
  28. ---
  29.  
  30. If you've been wondering why NEXTSTEP does not support virtual IP hosting
  31. (multi-homing) with NCSA or Apache httpd, your wait is over!
  32.  
  33. I have written a loadable device driver that assigns additional IP addresses
  34. to a NEXTSTEP host.
  35.  
  36. First, do in this directory,
  37.  
  38. # make install
  39.  
  40. This creates the following three files:
  41.  
  42. /usr/local/etc/ps/ps_reloc
  43. /usr/local/etc/ps/ps_load
  44. /usr/local/etc/ps/ps_unload
  45.  
  46. [If User-only environent does not have make, precompiled binary and scripts
  47. may be copied to respective files as shown above as user root.
  48. You must execute the scripts as root, or the scripts must have the mode 755,
  49. which makes them SUID root.]
  50.  
  51. /usr/local/etc/ps/ps_reloc is the device driver binary.
  52. /usr/local/etc/ps/ps_load is a script that loads the driver and assigns IP addresses.
  53. /usr/local/etc/ps/ps_unload is a script that unloads the driver.
  54.  
  55. Usages for ps_load, and ps_unload are described below
  56.  
  57. -----
  58. NAME
  59.     ps_load
  60.  
  61. SYNOPSIS
  62.     /usr/local/etc/ps/ps_load [ethernet address] [ip address] .....
  63.  
  64. DESCRIPTION
  65.     The first argument is the Ethernet address of the (real) host.
  66.     The Ethernet address may be found in /usr/adm/messages immediately
  67.     after the machine is booted.  It is on a line which looks like:
  68.  
  69.     Feb 29 04:15:21 antares mach: en0: Ethernet address 
  70.  
  71.     The portion in the format XX:XX:XX:XX:XX:XX is the Ethernet address.
  72.     Alternatively, you can find it from another machine on the same LAN by
  73.     doing (after rlogin to another host):
  74.  
  75.     # /usr/etc/arp -a
  76.  
  77.     The second and (optional) additional arguments are virtual IP addresses
  78.     to be assigned.  These may be virtual hostnames (DNS registered).
  79.     Any number of virtual IP addresses may be assigned up to a limit that is
  80.     compiled in.  As distributed, the limit is two, which may be increased
  81.     by modifying DEVICE_NUM= in Makefile.
  82.  
  83.     Specify IP addresses that belong to the same subnet as that of the real host.
  84.  
  85.     If this is not the case, routing information must be entered into the
  86.     routing table of the default router.
  87.  
  88.  
  89. -----
  90. NAME
  91.     ps_unload
  92. SYNOPSIS
  93.     /usr/local/etc/ps/ps_unload
  94. DESCRIPTION
  95.     This unloads the virtual interface driver that has been loaded previously.
  96.  
  97.  
  98. -----
  99. Note
  100. Virtual Host usage with Apache httpd
  101.  
  102. Uncomment and enable "BindAddress" line that is commented out in httpd.conf.
  103.  
  104. BindAddress    *
  105.  
  106. Then,
  107.  
  108. <VirtualHost hoge.foo.bar>
  109. ServerAdmin webmaster@hoge.foo.bar
  110. DocumentRoot /www/apache_1.0.5/hoge.doc
  111. ServerName hoge.fuu.bar
  112. ErrorLog hoge.logs/error_log
  113. TransferLog hoge.logs/access_log
  114. </VirtualHost>
  115.  
  116. In the above example, "hoge.foo.bar" is one of the virtual addresses assigned.
  117. It is also possible to list, between <VirtualHost> and </VirtualHost>, any
  118. directives that are allowd in access.conf and srm.conf.
  119.  
  120.  
  121.  
  122.