Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP Posting-Version: version B 2.10.3 alpha 5/22/85; site cbosgd.UUCP Path: utzoo!decvax!cbosgd!postmap From: postmap@cbosgd.UUCP Newsgroups: mod.map Subject: UUCP map for README Message-ID: <1484@cbosgd.UUCP> Date: Mon, 16-Sep-85 00:05:17 EDT Article-I.D.: cbosgd.1484 Posted: Mon Sep 16 00:05:17 1985 Date-Received: Mon, 16-Sep-85 08:49:03 EDT Expires: Thu, 17-Oct-85 00:05:17 EDT Sender: mark@cbosgd.UUCP Organization: AT&T Bell Laboratories, Columbus, Oh Lines: 387 Approved: postmap@cbosgd.UUCP echo x - README cat >README <<'!Funky!Stuff!' # The UUCP map is posted to newsgroup mod.map. The September posting is # out of order - the AT&T part will come last. Note the new newsgroup, # all future postings will be to mod.map. # # From rn, the map can be easily unpacked with a command such as # 43-46w | (cd ~uucp/uumap ; sh) # or you can use John Quarterman's script to automatically unpack # the files. All files intended as pathalias input have a dot in # their name, thus # pathalias path.local uumap/*.* # is a useful command to run. (You supply path.local.) # # The map is also available on a demand basis at a number of hosts who # have volunteered to make their copy available to the general public ; # details of this access are posted separately to mod.uucp.map. # # The current map totals about 840K bytes. The largest file, att.nj, is # about 112K, other large files are att.il (88K), usa.ca.n (80K), usa.ca.s # (46K), usa.ma (35K), and can.on (31K). The largest bundle, Europe+Canada, # is about 138K. # # The files are organized by region, where the regions are currently asia, # aus, can. eur, usa, and att. (AT&T gets its own region because it accounts # for nearly half of the map, and has its distribution organized internally.) # # This map can be used to generate mail routes with pathalias. Pathalias # was posted to Usenet in January 1985 and will be posted again as need warrants. # The map is also useful to determine the person to contact when a problem # arises, and to find someone for a new site to connect to. # # Please check the entry for your host (and any neighbors for whom you know # the information and have the time) for correctness and completeness. # Please send corrections and additional information to uucpmap@cbosgd.UUCP # or cbosgd!uucpmap or cbosgd!uucpmap@Berkeley.EDU. # # This map is maintained by a group of volunteers, making up part of the UUCP # Project. These people devote many hours of their own time to helping # out the UUCP community by keeping this map up to date. The volunteers are: # Rick Adams northeast # Gordon Moffett north # Bill Blue scal # Greg Fowler ncal # Rick Kiessig pacific # Doug McCallum mountain # Piet Beertema europe # Bill Welch southeast # Mike Schuh midwest # Gary Murakami att # Mel Pleasant moderator # # Please note that the purpose of this map is to make routers within # UUCP work. The eventual direction is to make the map smaller (through # the use of domains), not larger. As such, sites with lots of local # machines connected together are encouraged to create a few gateway # machines and to make arrangements that these gateways can forward # mail to your local users. We would prefer not to have information # listing the machines on your local area networks, and certainly not # your personal computers and workstations. If you need such information # for local mail delivery, create a supplement in pathalias form which # you do not publish, but which you combine with the published data # when you run pathalias. We also do not want information about machines # which are not on UUCP, that is, which are not reachable with the ! # notation from the main UUCP cluster. # # The remainder of this file describes the format of the UUCP map data. # It was last updated July 9, 1985 by Erik E. Fair . # # The entire map is intended to be processed by pathalias, a program that # generates UUCP routes from this data. All lines beginning in `#' are # comment lines to pathalias, however the UUCP Project has defined a set # of these comment lines to have specific format so that a complete # database could be built. # # The generic form of these lines is # # # # # Each host has an entry in the following format. The entry should begin # with the #N line, end with a blank line after the pathalias data, and # not contain any other blank lines, since there are ed, sed, and awk # scripts that use expressions like /^#N $1/,/^$/ for the purpose of # separating the map out into files, each containing one site entry. # # #N UUCP name of site # #S manufacturer machine model; operating system & version # #O organization name # #C contact person's name # #E contact person's electronic mail address # #T contact person's telephone number # #P organization's address # #L latitude / longitude # #R remarks # #U netnews neighbors # #W who last edited the entry ; date edited # # # sitename remote1(FREQUENCY), remote2(FREQUENCY), # remote3(FREQUENCY) # # Example of a completed entry: # # #N ucbvax # #S DEC VAX-11/750; 4.3 BSD UNIX # #O University of California at Berkeley # #C Robert W. Henry # #E ucbvax!postmaster # #T +1 415 642 1024 # #P 573 Evans Hall, Berkeley, CA 94720 # #L 122 13 44 W / 37 52 29 N # #R This is also UCB-VAX.BERKELEY.EDU [10.2.0.78] on the internet # #U decvax ibmpa ucsfcgl ucbtopaz ucbcad # #W ucbvax!fair (Erik E. Fair); Sat Jun 22 03:35:16 PDT 1985 # # # ucbvax decvax(DAILY/4), ihnp4(DAILY/2), # sun(POLLED) # # Specific Field Descriptions # # #N system name # # Your system's UUCP name should go here. Either the uname(1) command # from System III or System V UNIX; or the uuname(1) command from Version # 7 UNIX will tell you what UUCP is using for the local UUCP name. # # One of the goals of the UUCP Project is to keep duplicate UUCP host # names from appearing because there exist mailers in the world which # assume that the UUCP name space contains no duplicates (and attempts # UUCP path optimization on that basis), and it's just plain confusing to # have two different sites with the same name. # # At present, the most severe restriction on UUCP names is that the name # must be unique somewhere in the first six characters, because of a poor # software design decision made by AT&T for the System V release of UNIX. # # This does not mean that your site name has to be six characters or less # in length. Just unique within that length. # # With regard to choosing system names, HARRIS'S LAMENT: # # ``All the good ones are taken.'' # # #S machine type; operating system # # This is a quick description of your equipment. Machine type should # be manufacturer and model, and after a semi-colon(;), the operating # system name and version number (if you have it). Some examples: # # DEC PDP-11/70; 2.9 BSD UNIX # DEC PDP-11/45; ULTRIX-11 # DEC VAX-11/780; VMS 4.0 # SUN 2/150; 4.2 BSD UNIX # Pyramid 90x; OSx 2.1 # CoData 3300; Version 7 UniPlus+ # Callan Unistar 200; System V UniPlus+ # IBM PC/XT; Coherent # Intel 386; XENIX 3.0 # CRDS Universe 68; UNOS # # #O organization name # # This should be the full name of your organization, squeezed to fit # inside 80 columns as necessary. Don't be afraid to abbreviate where the # abbreviation would be clear to the entire world (say a famous # institution like MIT or CERN), but beware of duplication (In USC the C # could be either California or Carolina). # # #C contact person # # This should be the full name (or names, separated by commas) of the # person responsible for handling queries from the outside world about # your machine. # # #E contact person's electronic address # # This should be just a machine name, and a user name, like # `ucbvax!fair'. It should not be a full path, since we will be able to # generate a path to the given address from the data you're giving us. # There is no problem with the machine name not being the same as the #N # field (i.e. the contact `lives' on another machine at your site). # # Also, it's a good idea to give a generic address or alias (if your mail # system is capable of providing aliases) like `usenet' or `postmaster', # so that if the contact person leaves the institution or is re-assigned # to other duties, he doesn't keep getting mail about the system. In a # perfect world, people would send notice to the UUCP Project, but in # practice, they don't, so the data does get out of date. If you give a # generic address you can easily change it to point at the appropriate # person. # # Multiple electronic addresses should be separated by commas, and all of # them should be specified in the manner described above. # # #T contact person's telephone number # # Format: + # # Example: # # #T +1 415 642 1024 # # This is the international format for the representation of phone # numbers. The country code for the United States of America is 1. Other # country codes should be listed in your telephone book. # # If you must list an extension (i.e. what to ask the receptionist for, # if not the name of the contact person), list it after the main phone # number with an `x' in front of it to distinguish it from the rest of # the phone number. # # Example: # # #T +1 415 549 3854 x37 # # Multiple phone numbers should be separated by commas, and all of them # should be completely specified as described above to prevent confusion. # # #P organization's address # # This field should be one line filled with whatever else anyone would # need after the contact person's name, and your organization's name # (given in other fields above), to mail you something in the physical # mails. Generally, if there's room, it's best to spell out things # like Road, Street, Avenue, and Boulevard, since this is an international # network, and the abbreviations will not necessarily be obvious to someone # from Finland, for example. # # #L latitude and longitude # # This should be in the following format: # # #L NNN MM [SS] E|W / NN MM [SS] N|S [city] # # Two fields, with optional third. # # First number is Longitude in degrees (NNN), minutes (MM), and seconds (SS), # and a E or W to indicate East or West of the Prime Meridian in Greenwich, # England. # # A Slash Separator. # # Second number is Latitude in degrees (NN), minutes (MM), and seconds (SS), # and a N or S to indicate North or South of the Equator. # # Seconds are optional, but it is worth noting that the more accurate you # are, the more accurate maps we can make of the network (including # blow-ups of various high density areas, like New Jersey, or the San # Francisco Bay Area). # # If you give the coordinates for your city (i.e. without fudging for # where you are relative to that), add the word `city' at the end of the # end of the specification, to indicate that. If you know where you are # relative to a given coordinate for which you have longitude and # latitude data, then the following fudge factors can be useful: # # 1 degree = 69.2 miles = 111 kilometers # 1 minute = 1.15 miles = 1.9 kilometers # 1 second = 101.5 feet = 31 meters # # The Prime Meridian is through Greenwich, England, and longitudes go no # higher than 180 degrees West or East of Greenwich. Latitudes go no # higher than 90 degrees North or South of the Equator. # # Beware that the distance between two degrees of longitude decreases as # you get further away from the Equator. (Imagine all those longitudinal # lines converging on the north and south poles...) These numbers are # good for the Equator. If you're in Alaska or Norway, for example, they # are certainly too large for you to fudge longitude accurately. # # #R remarks # # This is for one line of comment. As noted before, all lines beginning # with a `#' character are comment lines, so if you need more than one # line to tell us something about your site, do so between the end of the # map data (the #?\t fields) and the pathalias data. # # #U netnews neighbors # # The USENET is the network that moves netnews around, specifically, # net.announce. If you send net.announce to any of your UUCP neighbors, # list their names here, delimited by spaces. Example: # # #U ihnp4 decvax mcvax seismo # # Since some places have lots of USENET neighbors, continuation lines # should be just another #U and more site names. # # #W who last edited the entry and when # # This field should contain an email address, a name in parentheses, # followed by a semi-colon, and the output of the date program. # Example: # # #W ucbvax!fair (Erik E. Fair); Sat Jun 22 03:35:16 PDT 1985 # # The same rules for email address that apply in the contact's email # address apply here also. (i.e. only one system name, and user name). # It is intended that this field be used for automatic ageing of the # map entries so that we can do more automated checking and updating # of the entire map. See getdate(3) from the netnews source for other # acceptable date formats. # # PATHALIAS DATA (or, documenting your UUCP connections & frequency of use) # # The DEMAND, DAILY, etc., entries represent imaginary connect costs (see # below) used by pathalias to calculate lowest cost paths. The cost # breakdown is: # # LOCAL 25 local area network # DEDICATED 95 high speed dedicated # DIRECT 200 local call # DEMAND 300 normal call (long distance, anytime) # HOURLY 500 hourly poll # EVENING 1800 time restricted call # DAILY 5000 daily poll # WEEKLY 30000 irregular poll # DEAD a very high number - not usable path # # Additionally, HIGH and LOW (used like DAILY+HIGH) are -5 and +5 # respectively, for baud-rate or quality bonuses/penalties. Arithmetic # expressions can be used, however, you should be aware that the results # are often counter-intuitive (e.g. (DAILY*4) means every 4 days, not 4 # times a day). # # The numbers are intended to represent frequency of connection, which # seems to be far more important than baud rates for this type of # traffic. There is an assumed high overhead for each hop; thus, # HOURLY is far more than DAILY/24. # # There are a few other cost names that sometimes appear in the map; # these are discouraged. Some are synonyms for the prefered # names above (e.g. POLLED means DAILY), some are obsolete (e.g. # the letters A through F, which are letter grades for connections.) # It is not acceptable to make up new names or spellings (pathalias # gets very upset when people do that...). # # LOCAL AREA NETWORKS # # For local area networks, (since they are usually completely connected), # there is a list notation for specifying them. Usually there is one # gateway machine to the outside world; it is best that the definition of # the network appear in that system's pathalias entry, and the other # systems just note that they connect to the LAN. An abbreviated map # entry for the sake of example: # # #N frobozz # #O Frobozz Skonk Works # #C Joe Palooka # #E frobozz!postmaster # #R gateway machine to Frobozz Company LAN # # # frobozz ucbvax(DEMAND), ihnp4(EVENING), seismo(DAILY), # mcvax(WEEKLY), akgua(EVENING) # # # # LAN addressed user@host # # # FROBOZZ-ETHER = @{frobozz, frob1, frob2, frob3}(LOCAL) # # # # LAN addressed BerkNet style host:user # # # FROBOZZ-BERKNET = {frobozz, frob4, frob5, frob6}:(LOCAL) # # For the other sites on the LAN, their map entries should reflect # who is in charge of the machine, and their pathalias data # would appear like this (again, this example is abbreviated): # # #N frob1 # #O Frobozz Skonk Works, Software Development System # #C Joe Palooka # #E frobozz!postmaster # # # frob1 FROBOZZ-ETHER # # WHAT TO DO WITH THIS STUFF # # Once you have finished constructing your pathalias entry, mail it off # to {ucbvax,ihnp4,akgua,seismo}!cbosgd!uucpmap, which is a mailing list # of the regional map coordinators. They maintain assigned geographic # sections of the map, and the entire map is posted on a rolling basis in # the USENET newsgroups mod.map.uucp over the course of a month (at the # end of the month they start over). # # Questions or comments about this specification should also be directed at # cbosgd!uucpmap. # !Funky!Stuff! : End of shell archive Brought to you by Super Global Mega Corp .com