Date: Tue, 15 May 2001 09:41:04 +1000 From: "Doug Young" <dougy@gargoyle.apana.org.au> To: "Nik Clayton" <nik@freebsd.org> Cc: "Sue Blake" <sue@welearn.com.au>, <freebsd-docs@freebsd.org>, "Rahul Siddharthan" <rsidd@physics.iisc.ernet.in>, "Kathy Quinlan" <katinka@magestower.com>, "N6REJ" <n6rej@tcsn.net> Subject: Re: (was) I'm leaving, now something like "anti official docs rant" :) Message-ID: <014a01c0dccf$5926cd30$0300a8c0@oracle> References: <002b01c0db54$e0febaa0$5599ca3f@disappointment> <20010513171444.E26123@welearn.com.au> <00f401c0db7e$ff3ca2a0$fe00a8c0@kat.lan> <20010513122623.I97034@lpt.ens.fr> <20010514084709.A68348@welearn.com.au> <024b01c0dc05$b1314fc0$0300a8c0@oracle> < <20010514182156.A22370@catkin.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
This is a multi-part message in MIME format. ------=_NextPart_000_0147_01C0DD23.28B75030 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit I'll need the source (presumably you're using LinuxDoc) and all the images. Whats "LinuxDoc" ?? ..... I'll have it known that I've never been guilty of using stuff from linux :). I write mostly in either W2K / notepad or Solaris / StarOffice & then change the .txt extension to .html when I'm finished The following documents feature diagrams: http://www.freebsd.org/doc/en_US.ISO_8859-1/books/design-44bsd/index.h tml http://www.freebsd.org/doc/en_US.ISO_8859-1/books/corp-net-guide/index .html When I remember to turn it on in the build, so will http://www.freebsd.org/doc/en_US.ISO_8859-1/articles/vm-design/index.h tml Praise be !!!!!!!! ..... the official docs might even make it into the 19th century someday if you keep that up :) The mind doth boggle how you got those past the old guard. Some of us just don't have the artistic skills. If you would like to submit a picture or diagram to go with any of the documentation, please do so, preferably using send-pr. No prob ..... theres at least a million areas where a simple screenshot would assist considerably. What graphic formats are compatible though ..... hopefully jpg & gif ?? I've never heard of it before, for one, and locate ppp_conf.sh doesn't turn it up. Details? Ahhhhhhhhh ..... well if yours truly got the name right you might have had a fighting chance !!! Its really "ppp_script.sh" !!! (attached hereto) .... sorry 'bout that. I had a discussion with Ted Mittelstaedt about that script. He suggested some time ago that I submit it as a PR or something, however I was concerned about the question of ownership (now resolved) and it does need some relatively minor changes to update it for changes to user-ppp made by Brian Somers recently. I'll attempt to get around to those this week. Or that it's better served by the asking the XFree86 people? Maybe ..... I would have thought that applications included as a "standard" package / port should receive more than a token coverage in the docs, but I guess its not as it everyone hasn't sufficient more specifically FreeBSD stuff to mess with. Another docs list newbie / dissident & an old guard member suggested looking at official XFree & linux docs (gasp !choke !splutter !) on 'X" .... maybe something relevant can be pirated from there. [ F'rinstance -- personally, I'm using a Matrox Millennium II with XFree86 4.0.3. I've got no idea if this is a good or bad card, or even if I've configured it for the maximum amount of speed. But it does work. ] yeah well I guess at $AU400 per unit it b****y well should work !!!!!! I had in mind more "common or garden" variety things like S3 Virge / Tseng ET4000 & ET 6000 / ATI Rage Pro / etc that regular folk can afford without taking out a mortgage on the house. ------=_NextPart_000_0147_01C0DD23.28B75030 Content-Type: application/octet-stream; name="ppp_script.sh" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="ppp_script.sh" #!/bin/sh=0A= # -*- sh -*-=0A= =0A= PATH=3D/usr/bin:/bin; export PATH=0A= =0A= # ppp-setup -- a script to automatically setup user ppp.=0A= # Most of the text in this script was derived from the FreeBSD Handbook.=0A= # Many thanks to Brian Somers for his input=0A= =0A= clear=0A= =0A= # Check to see if we are root=0A= ME=3D`whoami`=0A= if [ ! "$ME" =3D "root" ]; then=0A= echo "Sorry, you must be root to run ppp-setup."=0A= exit 1=0A= fi=0A= =0A= cat << EOS=0A= |----------------------------Unleash the = Daemon---------------------------|=0A= | ------------------------------------------------------------- = |=0A= | PPP SETUP 06.23.98 *** The Easy Way to set up User PPP = |=0A= | ------------------------------------------------------------- = |=0A= | = |=0A= | hacked by Mike Jackson = |=0A= | = |=0A= | muck@ida.net = |=0A= | = |=0A= | Tue Jun 23 13:43:23 MDT 1998 = |=0A= | = |=0A= | -------------------------------- = |=0A= | = |=0A= | **** *** **** **** *** *** *** = |=0A= | * * * * * * * * * * = |=0A= | **** *** **** **** **** ** * * = |=0A= | * * * * * * * * * * = |=0A= | * * * **** **** *** *** *** = |=0A= | = |=0A= | = |=0A= | = |=0A= | [ Press Enter to continue ] = |=0A= = |________________________________________________________________________= _|=0A= EOS=0A= =0A= read tmp=0A= =0A= clear=0A= =0A= cat << EOS=0A= |----------------------------Unleash the = Daemon---------------------------|=0A= | = |=0A= | This script automagically sets up user ppp for your particular = |=0A= | system's setup according to questions that you answer. It will = |=0A= | then write the appropriate files in /etc/ppp/ for you so that = |=0A= | you can easily be on your way to dial up network connectivity. = |=0A= | = |=0A= | = |=0A= | = |=0A= | = |=0A= | The following files will be modified: = | =0A= | = |=0A= | /etc/ppp/ppp.conf Information about your ISP, modem, etc. = |=0A= | /etc/ppp/ppp.linkup Used after a connection is established. = |=0A= | /etc/ppp/ppp.secret* Allows you to change ppp on the fly. = |=0A= | /etc/hosts Contains the IP addresses of your machines. = |=0A= | /etc/host.conf Instructions for the resolver. = |=0A= | /etc/resolv.conf Tells the resolver how to behave. = |=0A= | = |=0A= | *Will not be written. = |=0A= | = |=0A= | [ Press Enter to continue ] = |=0A= = |________________________________________________________________________= _|=0A= EOS=0A= =0A= read tmp=0A= =0A= clear=0A= =0A= cat << EOS=0A= |----------------------------Unleash the = Daemon---------------------------|=0A= | = |=0A= | Before you start, it is assumed you are roughly in this position: = |=0A= | = |=0A= | * You have an account with an ISP ,and your modem already = configured. |=0A= | = |=0A= | * You know your ISP's phone number(s). = |=0A= | = |=0A= | * You know your login name and password. = |=0A= | = |=0A= | * You know the IP address of your ISP's gateway. If you don't know = |=0A= | it, don't worry. We can make one up. = |=0A= | = |=0A= | * Your ISP's netmask setting. Again, if you don't know it, we can = |=0A= | safely use a netmask of 255.255.255.0. = |=0A= | = |=0A= | * The IP address of one or more nameservers. You MUST have this! = |=0A= | = |=0A= | * If your ISP has given you a static IP address, you will need to = |=0A= | have it handy. If not, we can configure PPP to accept any IP = |=0A= | number. = |=0A= | [ Press Enter to continue ] = |=0A= = |________________________________________________________________________= _|=0A= EOS=0A= =0A= read tmp=0A= =0A= clear=0A= =0A= echo " |-----------------------------Value = Required------------------------------|" =0A= echo " | = |"=0A= echo " | Enter your ISP's name. = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "? $c"; read ISP_NAME=0A= =0A= clear=0A= =0A= echo " |-----------------------------Value = Required------------------------------|"=0A= echo " | = |"=0A= echo " | Enter your ISP's Phone Number. = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "? $c"; read ISP_PHONE=0A= =0A= clear=0A= =0A= echo " |-----------------------------Value = Required------------------------------|"=0A= echo " | = |"=0A= echo " | Enter your login name. = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "? $c"; read ISP_UNAME=0A= =0A= =0A= clear=0A= =0A= echo " |-----------------------------Value = Required------------------------------|"=0A= echo " | = |"=0A= echo " | Enter your password. = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "? $c"; read ISP_PASSWD=0A= =0A= clear=0A= =0A= echo " |-----------------------------PPP = Configuration---------------------------|"=0A= echo " | = |"=0A= echo " | Has your Internet Service Provider assigned you a gateway? = If |"=0A= echo " | you don't know your gateway, don't worry. We can make one = up |"=0A= echo " | and your ISP's server will tell us when we connect. = |"=0A= echo " | = |"=0A= echo " | Do you have a gateway? = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "y/n? $c"; read YES_NO=0A= =0A= clear=0A= =0A= if [ $YES_NO =3D "y" ];=0A= then =0A= echo " |-------------------------------Value = Required----------------------------|"=0A= echo " | = |"=0A= echo " | Enter your gateway. = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "? $c"; read ISP_GATEWAY=0A= else=0A= ISP_GATEWAY=3D'10.0.0.2/0'=0A= fi=0A= =0A= clear=0A= =0A= echo " |-----------------------------PPP = Configuration---------------------------|"=0A= echo " | = |"=0A= echo " | Has your Internet Service Provider assigned you a netmask = setting? |"=0A= echo " | If not, don't worry. We can safely use 255.255.255.0 = |"=0A= echo " | = |"=0A= echo " | Do you have a netmask setting? = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "y/n? $c"; read YES_NO=0A= =0A= clear=0A= =0A= if [ $YES_NO =3D "y" ];=0A= then=0A= echo " |-------------------------------Value = Required----------------------------|"=0A= echo " | = |"=0A= echo " | Enter your netmask setting. = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "? $c"; read ISP_NETMASK=0A= else=0A= ISP_NETMASK=3D'255.255.255.0'=0A= fi=0A= =0A= clear=0A= =0A= echo " |-----------------------------PPP = Configuration---------------------------|"=0A= echo " | = |"=0A= echo " | Does your ISP give you a static IP address? If not, don't = |"=0A= echo " | worry. We'll configure PPP to accept any IP number. = |"=0A= echo " | = |"=0A= echo " | Do you have a static IP address? = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "y/n? $c"; read STATIC_IP_YES_NO=0A= =0A= clear=0A= =0A= if [ $STATIC_IP_YES_NO =3D "y" ];=0A= then=0A= echo " |--------------------------------Value = Required---------------------------|"=0A= echo " | = |"=0A= echo " | Please enter your static IP address. = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "? $c"; read STATIC_IP=0A= else =0A= STATIC_IP=3D'10.0.0.1/0'=0A= fi=0A= =0A= clear=0A= =0A= echo " |-----------------------------Value = Required------------------------------|"=0A= echo " | = |"=0A= echo " | Please Enter your ISP's nameservers. = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "First Nameserver: $c"; read ISP_DNS_ONE=0A= echo ""; echo $n "Second Nameserver: $c"; read ISP_DNS_TWO=0A= =0A= clear=0A= =0A= echo " |-----------------------------Value = Required------------------------------|"=0A= echo " | = |"=0A= echo " | What port is your modem on? = |"=0A= echo " | = |"=0A= echo " | [1] cuaa0 (COM 1) [3] cuaa2 = (COM 3) |"=0A= echo " | [2] cuaa1 (COM 2) [4] cuaa3 = (COM 4) |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "? $c"; read PORT_NUM=0A= =0A= if [ $PORT_NUM =3D "1" ];=0A= then =0A= PORT_NUM=3D'cuaa0'=0A= elif [ $PORT_NUM =3D "2" ];=0A= then =0A= PORT_NUM=3D'cuaa1'=0A= elif [ $PORT_NUM =3D "3" ];=0A= then =0A= PORT_NUM=3D'cuaa2'=0A= else =0A= PORT_NUM=3D'cuaa3'=0A= fi=0A= =0A= clear=0A= =0A= echo " |-----------------------------Value = Required------------------------------|"=0A= echo " | = |"=0A= echo " | Some ISP's set their system up so that the authentication = part |"=0A= echo " | of your connection is done using either PAP or CHAP. If = this is |"=0A= echo " | the case, your ISP will not give a login: prompt when you = connect, |"=0A= echo " | but will start talking PPP immediately. = |"=0A= echo " | = |"=0A= echo " | If you're not sure if your ISP uses PAP/CHAP, select = no |"=0A= echo " | here. You can always go back and edit = /etc/ppp/ppp.conf |"=0A= echo " | with the command, run as root, \"ee = /etc/ppp/ppp.conf\". |"=0A= echo " | = |"=0A= echo " | Consult the FreeBSD Handbook = (www.freebsd.org/handbook) |"=0A= echo " | for further details. = |"=0A= echo " | = |"=0A= echo " | Would you like to use PAP/CHAP? = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "y/n? $c"; read PAP_CHAP_YES_NO=0A= =0A= if [ $PAP_CHAP_YES_NO !=3D "y" ];=0A= then=0A= clear =0A= =0A= echo " |-----------------------------Value = Required------------------------------|"=0A= echo " | = |"=0A= echo " | Some ISP's will prompt you for a protocol. If this = is the case, |"=0A= echo " | then a \"col: ppp\" will be appended to your login = string in |"=0A= echo " | /etc/ppp/ppp.conf. = |"=0A= echo " | = |"=0A= echo " | If you're not sure if your ISP will prompt you = for a ppp |"=0A= echo " | protocol, please select no here. = |"=0A= echo " | = |"=0A= echo " | Consult the FreeBSD Handbook = (www.freebsd.org/handbook) |"=0A= echo " | for further details. = |"=0A= echo " | = |"=0A= echo " | Does your ISP prompt you for a protocol? = |"=0A= echo " | = |"=0A= echo " = |________________________________________________________________________= _|"=0A= =0A= echo ""; echo $n "y/n? $c"; read PPP_PROMPT_YES_NO=0A= fi=0A= =0A= clear=0A= =0A= cat << EOS=0A= |--------------------------The Daemon's = Unleashed-------------------------|=0A= | = |=0A= | Ok, now I'm going to write the following PPP related files: = |=0A= | = |=0A= | /etc/ppp/ppp.conf This will contain your modem's port = number, |=0A= | the speed at which we'll talk to your = modem, |=0A= | the dial string, the login string, your = ISP's |=0A= | phone number, your username and password, = |=0A= | and your static IP address if you have = one. |=0A= | = |=0A= | /etc/ppp/ppp.linkup This will contain the lines delete ALL, = and |=0A= | add 0 0 HISADDR. This will delete all of = |=0A= | the existing routing tables for the tun = |=0A= | device, and add a default route to your = ISP's |=0A= | gateway. = |=0A= | = |=0A= | /etc/ppp/ppp.secret* This will not be written, but it allows = you |=0A= | to change PPP on the fly. = |=0A= | = |=0A= | [ Press ctrl-c to cancel writing of files ] = |=0A= | = |=0A= | [ Press Enter to continue ] = |=0A= = |________________________________________________________________________= _|=0A= EOS=0A= =0A= read tmp=0A= =0A= # move the old files if they exist=0A= =0A= if [ ! -f /etc/ppp/ppp.conf ]=0A= then =0A= #doesn't exist, so do nothing=0A= else=0A= mv /etc/ppp/ppp.conf /etc/ppp/ppp.conf.old=0A= fi=0A= =0A= =0A= if [ ! -f /etc/ppp/ppp.linkup ]=0A= then =0A= #doesn't exist, so do nothing=0A= else=0A= mv /etc/ppp/ppp.linkup /etc/ppp/ppp.linkup.old=0A= fi=0A= =0A= =0A= if [ ! -f /etc/ppp/ppp.secret ] =0A= then =0A= #doesn't exist, so do nothing=0A= else=0A= mv /etc/ppp/ppp.secret /etc/ppp/ppp.secret.old=0A= fi=0A= =0A= =0A= if [ ! -f /etc/hosts ]=0A= then=0A= #doesn't exist, so do nothing=0A= else=0A= mv /etc/hosts /etc/hosts.old=0A= fi=0A= =0A= =0A= if [ ! -f /etc/host.conf ]=0A= then=0A= #doesn't exist, so do nothing=0A= else=0A= mv /etc/host.conf /etc/host.conf.old=0A= fi=0A= =0A= =0A= if [ ! -f /etc/resolv.conf ] =0A= then =0A= #doesn't exist, so do nothing=0A= else=0A= mv /etc/resolv.conf /etc/resolv.conf.old=0A= fi=0A= =0A= =0A= # ppp.conf will now be written =0A= echo "default:" >> /etc/ppp/ppp.conf=0A= echo " set log Phase Chat Connect Carrier lcp ipcp ccp command" >> = /etc/ppp/ppp.conf=0A= echo " set device /dev/$PORT_NUM" >> /etc/ppp/ppp.conf=0A= echo " set speed 115200" >> /etc/ppp/ppp.conf=0A= echo " set dial \"ABORT BUSY ABORT NO\\\\sCARRIER TIMEOUT 5 \\\"\\\" = ATE1Q0 OK-AT-OK \\\\dATDT\\\\T TIMEOUT 40 CONNECT\"" >> /etc/ppp/ppp.conf=0A= echo "$ISP_NAME:" >> /etc/ppp/ppp.conf=0A= echo " set phone \"$ISP_PHONE\" #Separate multiple phone numbers = with a |" >> /etc/ppp/ppp.conf=0A= =0A= =0A= # does the user want to use PAP/CHAP?=0A= if [ $PAP_CHAP_YES_NO =3D "y" ];=0A= then =0A= echo " set login" >> /etc/ppp/ppp.conf=0A= elif [ $PPP_PROMPT_YES_NO =3D "y" ];=0A= then=0A= echo " set login \"TIMEOUT 10 gin:-BREAK-gin: $ISP_UNAME word: = $ISP_PASSWD col: ppp\"" >> /etc/ppp/ppp.conf =0A= else =0A= echo " set login \"TIMEOUT 10 gin:-BREAK-gin: $ISP_UNAME word: = $ISP_PASSWD\"" >> /etc/ppp/ppp.conf=0A= fi=0A= =0A= echo " set timeout 300 #Change to 0 if no timeout desired" = >> /etc/ppp/ppp.conf=0A= echo " deny lqr" >> /etc/ppp/ppp.conf=0A= =0A= =0A= # does the user have a static IP address?=0A= if [ $STATIC_IP_YES_NO =3D "y" ]; =0A= then =0A= echo " set ifaddr $STATIC_IP $ISP_GATEWAY $ISP_NETMASK" >> = /etc/ppp/ppp.conf=0A= else=0A= echo " set ifaddr 10.0.0.1/0 10.0.0.2/0 255.255.255.0" >> = /etc/ppp/ppp.conf=0A= fi=0A= =0A= # does the user want to use PAP/CHAP?=0A= if [ $PAP_CHAP_YES_NO =3D "y" ];=0A= then =0A= echo " set authname $ISP_UNAME" >> /etc/ppp/ppp.conf=0A= echo " set authname $ISP_PASSWD" >> /etc/ppp/ppp.conf=0A= fi=0A= =0A= # ppp.linkup will now be written=0A= echo "MYADDR:" >> /etc/ppp/ppp.linkup=0A= echo " delete ALL" >> /etc/ppp/ppp.linkup=0A= echo " add 0 0 HISADDR" >> /etc/ppp/ppp.linkup=0A= =0A= clear =0A= =0A= cat << EOS=0A= |--------------------------The Daemon's = Unleashed-------------------------|=0A= | = |=0A= | I'll also write these files: = |=0A= | = |=0A= | /etc/hosts This will contain the IP addresses and = |=0A= | names of machines on your network. = |=0A= | = |=0A= | /etc/host.conf This will instruct the resolver to look = |=0A= | first in the hosts file, and then consult = |=0A= | the DNS if the name was not found. = |=0A= | = |=0A= | /etc/resolv.conf This tells the resolver how to behave. = |=0A= | = |=0A= |---------------[ Press ctrl-c to cancel writing of files = ]---------------|=0A= | = |=0A= | If you have any problems getting PPP set up, you may have to look = |=0A= | at the FreeBSD Handbook at www.freebsd.org/handbook. Or, you may = |=0A= | want to see the FreeBSD FAQ at www.freebsd.org/FAQ. = |=0A= | = |=0A= | Please send any comments to: muck@ida.net. = |=0A= | = |=0A= | [ Press Enter to continue ] = |=0A= = |________________________________________________________________________= _|=0A= EOS=0A= =0A= read tmp=0A= =0A= # hosts will now be written=0A= MYSYSTEM=3D`hostname -s`=0A= MYDOMAIN_NAME=3D`hostname`=0A= echo "127.0.0.1 localhost" >>/etc/hosts=0A= echo "10.0.0.1 $MYDOMAIN_NAME $MYSYSTEM" >> /etc/hosts=0A= =0A= # host.conf will now be written=0A= echo "hosts" >> /etc/host.conf=0A= echo "bind" >> /etc/host.conf=0A= =0A= # resolv.conf will now be written=0A= MYDOMAIN=3D`hostname`=0A= echo "nameserver $ISP_DNS_ONE" >> /etc/resolv.conf=0A= echo "nameserver $ISP_DNS_TWO" >> /etc/resolv.conf=0A= echo "domain ${MYDOMAIN#*.}" >> /etc/resolv.conf=0A= =0A= clear=0A= =0A= cat << EOS =0A= The Daemon's Unleashed=0A= =0A= FreeBSD System Manager's Manual=0A= =0A= NAME=0A= ppp - Point to Point Protocol=0A= SYNOPSIS=0A= ppp $ISP_NAME - Will load the information for your ISP.=0A= =0A= ppp ON $MYSYSTEM> dial - Will dial and login to your ISP.=0A= =0A= =0A= If for some reason dialing fails, you can do it manually:=0A= =0A= ppp ON $MYSYSTEM> term - Gets you into terminal mode.=0A= Enter to terminal mode.=0A= Type '~?' for help.=0A= ATDT$ISP_PHONE - Dials your ISP's number.=0A= Connect 38400 - Connection established.=0A= Login:=0A= Password:=0A= PPP ON $MYSYSTEM> Packet mode.=0A= =0A= [ Press Enter to exit ]=0A= =0A= EOS=0A= =0A= =0A= read tmp=0A= =0A= clear=0A= =0A= exit 0=0A= =0A= ------=_NextPart_000_0147_01C0DD23.28B75030-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?014a01c0dccf$5926cd30$0300a8c0>