diff --git a/release/sysinstall/help/XF86.hlp b/release/sysinstall/help/XF86.hlp index 32ad853c0bca..d2c2038d25b8 100644 --- a/release/sysinstall/help/XF86.hlp +++ b/release/sysinstall/help/XF86.hlp @@ -1,551 +1,924 @@ -README for XFree86 3.1.2 on FreeBSD 2.1 -Rich Murphey, David Dawes -20 January 1995 -[Last Updated: 14 October 1995] + Release Notes for XFree86[TM] 3.2 + The XFree86 Project, Inc + 29 October 1996 -1. What and Where is XFree86? ------------------------------- + This document describes the new features in XFree86 3.2 compared with + the previous full release, 3.1.2. It also includes installation + instructions for the binary distributions. -XFree86 is a port of X11R6 that supports several versions of Intel- -based Unix. It is derived from X386 1.2, which was the X server -distributed with X11R5. This release consists of many new features -and performance improvements as well as many bug fixes. The release -is available as source patches against the X Consortium X11R6 code, as -well as binary distributions for many architectures. + 1. XFree86 and X11R6.1 -See the Copyright Notice (COPYRIGHT.html). + XFree86 releases starting with the 3.1.2D beta are based on the X + Consortium's X11R6.1. -The sources for XFree86 are available as part of the FreeBSD 2.1 -distribution, or by anonymous ftp from: + R6.1 is an update to R6, and is intended to be compatible with R6 at + the source and protocol levels. Binaries should be upward-compatible. + X11R6.1 includes some new Xserver extensions: DOUBLE-BUFFER, XKEYBOARD + and RECORD. LBX has been dropped from R6.1, and as such, has been + dropped from XFree86 too. It is expected that it will reappear in + some form in a future release. -ftp.XFree86.org:/pub/XFree86/current -(ftp://ftp.XFree86.org/pub/XFree86/current) + 2. OS issues + Always check the OS specific README files for special requirements or + caveats. -Binaries for XFree86 on FreeBSD are also available as part of -2.1 or from: + Users running Linux/Elf (on Intel platforms) should note that they + will need ld.so-1.7.14. This can be found at + tsx-11.mit.edu:pub/linux/packages/GCC + . -ftp.XFree86.org:/pub/XFree86/current/binaries/FreeBSD-2.0 -(ftp://ftp.XFree86.org/pub/XFree86/current/binaries/FreeBSD-2.0) + 3. New Features in 3.2 -XFree86.cdrom.com:/pub/XFree86/current/binaries/FreeBSD-2.0 -(ftp://XFree86.cdrom.com/pub/XFree86/current/binaries/FreeBSD-2.0) + Note, items marked with `*' have been added since the last beta + release (3.1.2G). -Send email to Rich-Murphey@Rice.edu or XFree86@XFree86.org if you have -comments or suggestions about this file and we'll revise it. + 3.1. General -2. Installing the Binaries ---------------------------- + o XFree86 3.2 includes the X Consortium's X11R6.1. -In the FreeBSD 2.1 distribution, XFree86 comes in 3 major sections: -"basic" distributions, fonts and servers. At the minimum, you will -need the binaries and libraries from the basic distribution, the -"misc" fonts collection and at least one server. The smallest usable -distribution is around 9MB. + o XFree86-3.2 includes a full distribution for Linux/m68k. -If you can't decide what to pick and you have 52Mb of disk -space, it's safe to unpack everything. + o XFree86-3.2 includes a full distribution for Linux/Alpha. -What follows is a description of the various distribution files -comprising XFree86. If you are installing this as part of FreeBSD 2.1 -then there's no need to use these files directly: You may simply check -the desired components off the installation menus provided for that -purpose. If you're installing this manually, then the following -information should prove useful: + o XFree86-3.2 includes a full distribution for OS/2. - Required (6.7Mb): + 3.2. General X server changes - X312bin.tgz - all the executable X client applications and shared libs - X312fnts.tgz - the misc and 75 dpi fonts + o A `DefaultColorDepth' keyword has been added for the Screen + section in XF86Config files to allow the default bpp to be + specified. - X312lib.tgz - data files needed at runtime + o A `-nolock' server command-line option has been added to allow + the server's locking mechanism to be disabled. + o All VGA cards with a set of discrete clocks (i.e. not a + ClockChip or a ClockProg) can now also use all the clocks + mentioned in the clocks line divided by 2. This presents the + server with twice as many clocks to choose from. Add the option + "clkdiv2" to the "Device" section of XF86Config to enable this. - Required unless you have already customized your configuration - files: + o Some cursor colouring bugs have been fixed for servers that use + hardware cursors. - X312xicf.tgz - customizable xinit runtime configuration file + o A security problem related to the X server's lock files has been + fixed. - X312xdcf.tgz - customizable xdm runtime configuration file + o The VidMode extension (as used by xvidtune) now by default only + allows changes to modes by clients using a local connection + type. There is also an option to completely disable mode + changes via this extension. - Choose at least one server ( 2.3Mb): + o A new server extension called "XFree86-Misc" has been added. + The primary purpose of this is to allow reconfiguration of some + parameters while the server is running. Some functions + previously in the VidMode extension (like screen save functions) + have been moved to this new extension. - X3128514.tgz - 8-bit color for IBM 8514 and true compatibles. + o Support has been added for the ALPS GlidePoint. A tap on the + pad is treated as a fourth button. - X312AGX.tgz - 8-bit color for AGX boards. + o The XKEYBOARD extension is included in the servers as part of + X11R6.1. It is enabled by default, but can be disabled either + from the command line (see the Xserver man page) or from the + XF86Config file (see XkbDisable in the XF86Config man page). + With this extension enabled, you may see some differences in the + keyboard mappings. - X312Mch3.tgz - 8 and 16-bit color for ATI Mach32 boards. + o A new extension called XFree86-DGA is now provided. This allows + a client program to get direct access to the video card's + memory. This is implemented for most of the servers/drivers + that can support it. Connections are only allowed from clients + using a local connection type (e.g., DISPLAY=":0"). For details + of the client-side API, see the XF86DGA(3) man page, and the + file README.DGA. - X312Mch8.tgz - 8-bit color for ATI Mach8 boards. + o An implementation of the XInput extension is now included. It + has support for the following devices: - X312Mono.tgz - 1-bit monochrome for VGA, Super-VGA, Hercules, and others. + + Joystick (Linux, FreeBSD, NetBSD and OpenBSD only) - X312P9K.tgz - 8, 16, and 24-bit color for Weitek P9000 boards (Diamond - Viper). + + Wacom tablet (Wacom IV protocol only) - X312S3.tgz - 8, 16 and 24-bit color for S3 boards (#9 GXE, Actix GE32, - SPEA Mercury, STB Pegasus) + + Elographics touchscreen - X312SVGA.tgz - 8-bit color for Super-VGA cards. + + SummaSketch tablet - X312VG16.tgz - 4-bit color for VGA and Super-VGA cards + + Mouse - X312W32.tgz - 8-bit Color for ET4000/W32, /W32i and /W32p cards. + Refer to the XF86Config(4/5) manual page and the xinput document + for configuration details. - X312nest.tgz - A nested server running as a client window on another - display. + o The default black and white pixel values are now black = 0 and + white = 1 for all servers. This may be swapped with the + `-flipPixels' command-line option. - Optional: + o Underscore characters are now ignored in Options and keywords in + the XF86Config file. - X312doc.tgz - (.5Mb) READMEs and XFree86 specific man pages + o The built-in X server malloc is used by default. - X312man.tgz - (1.7Mb) man pages except XFree86 specific ones in etc archive + o A problem that can cause the X server to crash when running + xvidtune has been fixed. - X312ctrb.tgz - (1.0Mb) Contributed clients like ico, xeyes, etc. + o Bitmap fontpath elements can have ":unscaled" appended to + prevent the fonts from being treated as scalable. This works + with the fontserver (xfs) too. - X312f100.tgz - (1.8Mb) 100dpi fonts - X312fcyr.tgz - (1.8Mb) Cyrillic fonts - X312fscl.tgz - (1.6Mb) Speedo and Type1 fonts + o *The PEX and XIE server extensions can now be dynamically loaded + for Linux/ELF, FreeBSD, NetBSD and OpenBSD. - X312fnon.tgz - (3.3Mb) Japanese, Chinese and other non-English fonts + 3.3. XF86Setup - X312fsrv.tgz - (.3Mb) the font server and it's man page - X312prog.tgz - (3.9Mb) config, lib*.a and *.h files needed only for - compiling + o 3.2 includes a new, graphical utility for X server configuration + called `XF86Setup'. NOTE: this utility requires that you have + the VGA16 server installed, as well as the server specific to + your video card. - X312link.tgz - (7.8Mb) X server reconfiguration kit + 3.4. PC98 Support - X312pex.tgz - (.5Mb) PEX fonts and shared libs needed by PEX applications. - X312lbx.tgz - (.2Mb) low bandwidth X proxy server and libraries. + o Support has been added for PC98 machines. These are Intel based + machines which are common in Japan. -Note that there is no longer a separate xdm archive. FreeBSD 2.0 -and later handles this in shared libraries now, so that the xdm -binary does not itself contain des and there is no more need for -us to provide separate tar balls. + o Support has been added for the PANIX-PC98 SVR4.0 OS. + o The following PC98-specific X servers are included: -2.1. Full Install: -------------------- + + XF98_NECS3 PC98 NEC(S3) server. -[ Note: Unless you're installing XFree86 3.1.2 manually, that is - to say not as part of the FreeBSD 2.1 installation, you may skip - to section 2.3 ] + + XF98_PWSKB SKB-PowerWindow(S3) server. - 1. You must be logged in as root to unpack the archives because - several executables are set-user-id. Otherwise the server may - abort if you unpack it as an ordinary user. You must also use a - ``umask'' value of 022 because the X server requires special - permissions. + + XF98_PWLB PC98 PowerWindowLB(S3) server. - % su - # umask 022 + + XF98_GA968 GA-968V4/PCI(S3 968). + + XF98_TGUI Cyber9320 and TGUI9680. - 2. If you have 52Mb free in the /usr partition ``cd /usr'' and skip - to no. 3. Otherwise, create a directory on another partition - and sym link it into /usr: + + XF98_NKVNEC NKV-NEC(cirrus) server. - # cd /usr/local - # mkdir X11R6 - # ln -s /usr/local/X11R6 /usr/X11R6 + + XF98_WABS WABS(cirrus) server. + + XF98_GANBWAP GANB-WAP(cirrus) server. - 3. Unpack everything: + + XF98_WABEP WAB-EP(cirrus) server. - If you are using sh (as root usually does): + + XF98_WSNA WSN-A2F(cirrus) server. - # for i in X312*.tgz; do - # tar -xzf $i - # done + + XF98_EGC EGC(generic vga16) server. + + XF98_NEC480 PEGC-480(generic vga256) server. - Else, if you are using csh: + 3.5. XInput Extension - % foreach i (X312*.tgz) - % tar -xzf $i - % end + o Motion history support is included for XInput devices. - 4. Create a symbolic link ``X'' that points to the server that - matches your video card. The XF86_* man pages list which vga - chip sets are supported by each server. For example, if you - have an ET4000 based card you will use the XF86_SVGA server: + o XInput drivers are now dynamically loadable for Linux/ELF, + FreeBSD, and NetBSD. - # cd /usr/X11R6/bin; rm X; ln -s XF86_SVGA X + o Multiple instances of XInput devices may be specified. + 3.6. S3 server -2.2. Minimal Install: ----------------------- -First do numbers 1 and 2 above. Then unpack the required archives: + o Support for the S3 Trio64V+. - # for i in bin fnts lib xicf; do - # tar -xzf X312$i.tgz - # done + o *New server (XF86_S3V) for the S3 ViRGE and ViRGE/VX. Note that + this server is very new, and is considered "beta". Please + report any problems with it. -Then unpack a server archive corresponding to your vga card. The -server man pages, X11R6/man/man1/XF86_*, list the vga chip sets -supported by each server. For example, if you have an ET4000 based -card you will use the XF86_SVGA server: - # tar -xzf X312SVGA.tgz - # cd /usr/X11R6/bin; rm X; ln -s XF86_SVGA X + o Support in the S3 server for the AT&T 20C409 and 20C499 RAMDACs. + o Some potential problems with the way the accelerator is used + have been fixed. -2.3. After either Full or Minimal Install above: -------------------------------------------------- + o A new driver has been added for the 868/968/Trio64V+ which uses + the new MMIO mode available with these chips. This new driver + is used by default for these chips on Intel platforms, but not + yet on Alpha platforms. It can be enabled for Alpha platforms + by specifying: -Add /usr/X11R6/bin to the default path for sh in /etc/profile and for -csh in /etc/csh.login if they are not already there: + Chipset "NewMMio" - # echo 'set path = ($path /usr/X11R6/bin)' >>/etc/csh.login - # echo 'PATH=$PATH:/usr/X11R6/bin' >>/etc/profile -Or make sure all who use X put /usr/X11R6/bin in their shell's -``path'' variable. + If you see any problems with the new driver, please let us know. + It is possible to disable this new driver and use the old one by + specifying: -Next either reboot or invoke ldconfig as root to put the shared -libraries in ld.so's cache: + Chipset "mmio_928" - # ldconfig /usr/lib /usr/local/lib /usr/X11R6/lib -If you had already configured X11R6/lib/X11/xinit/xinitrc or -X11R6/lib/X11/xdm/* omit the xinit-config or xdm-config archive or -unpack it separately and merge in your customizations. + in the Device section. Please test the new driver before disabling + it, and for any problem you see, also check if it happens with the + old driver, and let us know (even if the old driver fixes the prob- + lem!). -The fscl and f100 archives are optional and can be omitted if you are -short on space. The optional link archive allows you to reconfigure -and customize a X server binary. The optional prog archive is needed -only for writing or compiling X applications. The optional pex -archive contains pex clients and libraries for building 3D graphics -applications. + o An initialisation problem with some VideoLogic cards has been + fixed. - NOTE: You don't need to uncompress the font files, but if - you uncompress them anyway you must run mkfontdir in the - corresponding font directory; otherwise your server will - abort with the message ``could not open default font - 'fixed'''. + o Support for the ELSA Winner 2000PRO/X rev G and ELSA Gloria-8 + (except the GLint 300SX 3D chip) has been added. -3. Installing The Display Manager (xdm) ----------------------------------------- + o Problems with S3 dashed lines are fixed. -The display manager makes your PC look like an X terminal. That is, -it presents you with a login screen that runs under X. + o Added options "slow_dram" and "slow_edodram" to avoid pixel + errors on the display for some broken cards. -The easiest way to automatically start the display manager on boot is -to add a line in /etc/ttys to start it on one of the unoccupied -virtual terminals: + o A Ti3026 clock problem that appears on some SPEA cards has been + fixed. - ttyv4 "/usr/X11R6/bin/xdm -nodaemon" xterm on secure + o Code has been added to automatically detect the Trio32 bug that + causes font cache problems. When detected, a workaround is + activated.. -You should also make sure that /usr/X11R6/bin/X is a symbolic link to -the Xserver that matches your video card or edit the file Xservers in -/usr/X11R6/lib/X11/xdm to specify the pathname of the X server. + o Framebuffer address problems with some 1MB Trio64 VLB cards + should be fixed. -The change to /etc/ttys won't take effect until you either reboot or -``kill -HUP 1'' to force initd to reread /etc/ttys. You can also test -the display manager manually by loging in as root on the console and -typing ``xdm -nodaemon''. + o The low ICS5342 clock limit has been removed. + o Detection of Diamond S3 cards has been improved. If you've + needed to use the "diamond" option to avoid screen wrapping in + previous releases, try removing it and let us know if there are + any problems. -4. Configuring X for Your Hardware ------------------------------------ + o Memory parameter calculations for 2MB Trio64 cards have been + fixed. If you've needed to add something like "S3MClk 170" to + your XF86Config with previous versions, you should remove it + now. -The XF86Config file tells the X server what kind of monitor, video -card and mouse you have. You must create it to tell the server what -specific hardware you have. + o The handling of the S3RefClk XF86Config setting has been fixed + for cards with an IBM Ramdac. -If you are installing XFree86 as part of FreeBSD 2.1, you may invoke -XF86Config automatically from the FreeBSD configuration menu. You -should still read this document first, however, as it contains -valuable information on mouse and VGA card selection below. -XFree86 3.1 uses a new configuration file format. Consult the -XF86Config man page and the general INSTALL (INSTALL.html) file for -instructions. -If you have a Xconfig file for XFree86 2.x, use reconfig to translate -part of it into the new format: + o Support for S3 and Bt485 HW cursor in doublescan modes. - # reconfig XF86Config + o Fix positioning of IBM RGB Ramdac HW cursor in interlace and + doublescan modes (the cursor shape still isn't correct). -and complete the rest according to the XF86Config man page and the -XF86Config.sample file as a template. + o Improved linear fb detection for PCI cards. In particular this + should allow most Trio64V+ cards to use the linear fb, which + seems to prevent a lot of the lockups that have been reported. -In order to protect your hardware from damage, the server no longer -will read XF86Config files from a user's home directory, but requires -that it be in /etc/XF86Config, /usr/X11R6/lib/X11/XF86Config.hostname -or /usr/X11R6/lib/X11/XF86Config. + o Support for the ELSA Elsa Winner2000PRO/X-2,4 Rev.G which uses + an ICS9161A clock chip as well as the Ti3026 RAMDAC (clock + doubling not supported yet). -You'll need info on your hardware: + o The default InvertVCLK settings have been changed for #9 Motion + 771 cards and Hercules Terminator 64 Pro cards. If you have + needed to add Invert_VCLK lines to your XF86Config file to avoid + screen wrapping with version 3.1.2, please remove them when + testing this version. If there are problems with the new + defaults, please report them to us. - o Your mouse type, baud rate and it's /dev entry. + o *Text clipping performance has been improved. - o The video card's chipset (e.g. ET4000, S3, etc). + 3.7. Mach64 server - o Your monitor's sync frequencies. -Bus Mice: + o Most problems in the handling of block_write have been fixed. + Nevertheless, you still might need to add the "no_block_write" + option to your XF86Config if the BIOS doesn't correctly + initialise the chip. -In FreeBSD, the bus mouse is generally found on /dev/mse0. Specify -/dev/mse0 when asked, and in case of failure ensure that your Bus -mouse was indeed "probed" when the system was booted. To make -sure of this, type: + o Screen blanking for some Mach64 CT cards running at 16bpp and + 32bpp has been fixed. Problems remain for some revisions of the + CT chip. - % dmesg | grep mse + o The Mach64 server supports the VT and GT chipset. The GT is + also known as "3D Rage". The newer 3D Rage II is not yet + supported. -If you do not see something like this: - mse0 at 0x23c irq 5 on isa + o A problem with olvwm icons has been fixed. -then it means that your bus mouse was not detected properly and you -should reboot with the `-c' flag and verify that the device entry for -mse0 matches your bus mouse settings. + o A problem with ghostview scrollbars has been fixed. This may + also fix some Netscape font problems that have been reported. -If the mouse is probed properly but still fails to function then you -might double check that the /dev entry for the bus mouse exists. Use -the script /dev/MAKEDEV to create the entry if it doesn't already -exist, e.g: + o The Mach64 CT (also known as the 264CT or 215CT22200) chip is + now supported. This chip has a integrated RAMDAC and clockchip, + and is used on some Graphics Xpression and WinBoost cards. - % cd /dev - % sh MAKEDEV mse0 + o The Mach64 GX-F (GX rev 3) is now supported. + o The IBM RGB514 RAMDAC is now supported (as used on the ATI + Graphics Turbo Pro 1600). -Serial Mice: + o The memory base should now be correctly detected for VLB cards. + If you've needed to add a `MemBase' line to the XF86Config for + previous versions, please try removing it, and let us know if + there are any problems. -The easiest way to find which port your mouse is plugged into is to -use ``cat'' or ``kermit'' to look at the output of the mouse. Connect -to it and just make sure that it generates output when the mouse is -moved or clicked. If your mouse is plugged into the first serial port -(COM1), for example, you could do this: + o Cursor colour problems at 16bpp/32bpp mode with some RAMDACs + have been fixed. - % cat < /dev/cuaa0 + o Errors in detecting some RAMDACs (like the CH8398) should now be + fixed. -Where /dev/cuaa0 represents the first serial port, /dev/cuaa1 the -second, /dev/cuaa2 the third and so on. + o 8 bit-per-RGB mode (when running at 8bpp) is now the default for + RAMDACs that support it. -If you can't find the right mouse port then use ``dmesg | grep sio'' -to get a list of serial devices that were detected at boot time: + o Hardware cursor mask problem has been fixed. - % dmesg|grep sio - sio0 at 0x3f8-0x3ff irq 4 on isa + o Support for the AT&T 20C408 RAMDAC/Clockchip has been added. -The presence of sio0 will indicate that COM1 was found. If you see -sio1, sio2 or sio3 then it means that a serial port was found at one -of the other com addresses and you should use the appropriate -/dev/cuaa device entry to talk to it. + o Arbitrary clocks can be used on most cards with supported clock + chips. -If things still aren't working then double check that the /dev entries -corresponding to these devices exist. Use the script /dev/MAKEDEV to -create entries if they don't already exist, e.g: + o Hardware cursor color problem on Mach64 CT, VT and GT chips at + 16bpp and 32bpp has been fixed. - % cd /dev - % sh MAKEDEV cuaa0 [cuaa1, cuaa2, etc..] + o Doublescan mode is supported on VT and GT chipsets. The + hardware cursor is not correctly displayed in doublescan modes, + but functions correctly. No other Mach64 chipsets can support + an accelerated doublescan mode. -If you plan to fine tune the screen size or position on your monitor -you'll need the specs for sync frequencies from your monitor's manual. + o Video noise on certain CT, VT and GT chips has been eliminated + (on nearly all cards) or reduced as much as possible (on certain + CT based cards). + o Clock chip programming accuracy has been greatly improved on CT, + ET, VT and GT based cards. This may result in modes that were + set up for a previous release not being displayed as before. + With the xvidtune program, you can adjust the screen to work + with the now correct clock programming. -5. Running X -------------- + o *The reliability of the Mach64 detection code has been improved. -8mb of memory is a recommended minimum for running X. The server, -window manager, display manager and an xterm take about 8Mb of virtual -memory themselves. Even if their resident set size is smaller, on a -8Mb system that leaves very space for other applications such as gcc -that expect a few meg free. The R6 X servers may work with 4Mb of -memory, but in practice compilation while running X can take 5 or 10 -times as long due to constant paging. + 3.8. Mach32 server -The easiest way for new users to start X Window System is to type ``startx ->& startx.log''. Error messages are lost unless you redirect them -because the server takes over the screen. -To get out of X Window System, type: ``exit'' in the console xterm. You can -customize your X by creating .xinitrc, .xserverrc, and .twmrc files in -your home directory as described in the xinit and startx man pages. + o Hardware cursor mask problem has been fixed. + o *16bpp support has been added for the AT&T 20C490 and Bt481 + RAMDACs. -6. Rebuilding Kernels for X ----------------------------- + o *Some VT switching problems have been fixed. -The GENERIC FreeBSD 2.x kernel supports XFree86 without any -modifications required. You do not need to make any changes to the -GENERIC kernel or any kernel configuration which is a superset. + 3.9. W32 server -For a general description of BSD kernel configuration get -smm.02.config.ps.Z -(ftp://gatekeeper.dec.com/pub/BSD/manuals/smm.02.config.ps.Z). It is -a ready-to-print postscript copy of the kernel configuration chapter -from the system maintainers manual. -Alternatively, you can read the kernel configuration section of the -FreeBSD handbook (http://www.freebsd.org/handbook). + o Support has been added for the ET6000 -If you do decide to reduce your kernel configuration file, do not -remove the two lines below (in /sys/arch/i386/conf). They are both -required for X support: + o Support has been added for the ICD2061A clock chip (which is + used on the Diamond Stealth 32). - options XSERVER #Xserver - options UCONSOLE #X Console support + o The server's reporting of bits/RGB resolution has been fixed. -The generic FreeBSD 2.x kernel is configured by default with the -syscons driver. To configure your kernel similarly, it should have a -line like this in /usr/src/sys/i386/conf/GENERIC: + o Support for the STG1703 RAMDAC/clock has been added. Clocks up + to 135MHz should be OK. To use the programmable clock add the + following line to the Device section of the XF86Config: - device sc0 at isa? port "IO_KBD" tty irq 1 vector scintr -The maximum number of virtual consoles can be set using the MAXCONS -option: + ClockChip "stg1703" - options "MAXCONS=4" #4 virtual consoles -Otherwise, the default without a line like this is 12. You must have -more VTs than gettys as described in the end of section 3, and 4 is a -reasonable minimum. -The server supports several console drivers: pccons, syscons and pcvt. -The syscons driver is the default in FreeBSD 1.1.5 and higher. They -are detected at runtime and no configuration of the server itself is -required. -The pcvt console driver is bundled into FreeBSD and may be enabled -by changing the `sc0' line in your kernel configuration file to -`vt0'. See /sys/i386/conf/LINT for more details. + o Options have been added to allow PCI burst mode and W32 + interleaving to be turned on or off. The XF86Config Device + section entries for these are: -The XFree86 servers include support for the MIT-SHM extension. The -GENERIC kernel does not support this, so if you want to make use of -this, you will need a kernel configured with SYSV shared memory -support. To do this, add the following line to your kernel config -file: - options SYSVSHM # System V shared memory - options SYSVSEM # System V semaphores - options SYSVMSG # System V message queues -If you are using a SoundBlaster 16 on IRQ 2 (9), then you need a patch -for sb16_dsp.c. Otherwise a kernel configured with the SoundBlaster -driver will claim interrupt 9 doesn't exist and X server will lock up. -S3 cards and serial port COM 4 cannot be installed together on a -system because the I/O port addresses overlap. + Option "pci_burst_on" + Option "pci_burst_off" + Option "w32_interleave_on" + Option "w32_interleave_off" -7. Rebuilding XFree86 ----------------------- -The server link kit allows you to build an X server using a minimum -amount of disk space. Just unpack it, make the appropriate changes to -site.def, type ``./mkmf' and ``make'' to link the server. See -README.LinkKit (LinkKit.html) for more info. -The source tree takes about 114Mb before compiling and an additional -100Mb after ``make World''. You should configure the distribution by -editing xf86site.def and site.def in xc/config/cf before compiling. -By default, the config files are set up to build shared libraries. If -you are running a version of FreeBSD that doesn't include shared -library support, add the following line to site.def: - #define BuildBsdSharedLibs NO + o Support has been added for the ICS5341 programmable clock. To + enable this, add the following lines to the Device section of + your XF86Config file: -If your system doesn't have support or SYSV shared memory (for -example, if you don't have the header), you should disable -the MIT-SHM extension by adding the following line to site.def: - #define HasShm NO + Ramdac "ics5341" + ClockChip "ics5341" -To compile the sources on FreeBSD 1.1 and later, type: - make World -8. Building Other X Clients ----------------------------- -The easiest way to build a new client (X application) is to use xmkmf -if an Imakefile is included with it. Type ``xmkmf -a'' to create the -Makefiles, then type ``make''. Whenever you install additional man -pages you should update whatis.db by running ``makewhatis -/usr/X11R6/man''. + o Problems that could cause the W32 server to crash at startup or + get stuck in a loop at exit have been fixed. -Note: Starting with XFree86 2.1 and FreeBSD 1.1, the symbol __386BSD__ -no longer gets defined either by the compiler or via the X config -files for FreeBSD systems. When porting clients to BSD systems, make -use of the symbol BSD for code which is truly BSD-specific. The value -of the symbol can be used to distinguish different BSD releases. For -example, code specific to the Net-2 and later releases can use: + o *Some drawing bugs have been fixed. + + 3.10. AGX server + + + o Fix for clock probing with AGX-010 chips. + + 3.11. I128 server + + + o A new server for the Number Nine Imagine 128 card is included. + This server is currently not accelerated. + + o Support has been added for the Series 2 cards. + + o Support has been added for 8MB cards. + + 3.12. TGA server + + + o *A new server for the DEC 21030 (TGA) is included. This is only + available for Alpha machines. This server is currently not + accelerated. + + 3.13. SVGA/VGA16/Mono servers + + + o A PCI probe has been added to these servers. If it causes + problems, it can be disabled by adding the line: + + Option "no_pci_probe" + + + + to the Device section in your XF86Config file. + + 3.14. VGA16 server + + + o A problem preventing the StaticGray visual from working has been + fixed. + + 3.15. ET3000 driver (VGA16 server) + + + o VGA16 support has been added to the ET3000 driver. + + 3.16. Trident driver (SVGA server) + + + o TGUI9440 is now fully supported by the SVGA server. + + o Major updates for most of the trident family of chips. + + o TGUI9660/9680 chipsets are now fully supported + + o Check README.trident distributed with this release for full + details. + + 3.17. Ark driver (SVGA server) + + + o The Ark driver will now detect the ARK2000MT, but it is treated + as an ARK2000PV. + + o A problem which caused the server to crash when no Ramdac was + given in the XF86Config file has been fixed. + + o ICS5342 clock support (required for the Diamond Stealth64 + Graphics 2001 series) has been added. To enable this, add the + following lines to the Device section of your XF86Config file: + + + Ramdac "ics5342" + ClockChip "ics5342" + + + + + + Do not include any Clocks lines in your XF86Config file. + + o Panning has been fixed for ARK2000PV cards with 2MB of video + memory. + + o *Some basic BitBlt acceleration has been added. + + o *24bpp packed pixel support has been added for some + cards/RAMDACs. + + o *Memory bandwidth problems have been fixed. + + o *Hardware cursor support has been added. + + 3.18. ET6000 driver (SVGA server) + + + o *This driver includes support for linear memory and 16bpp, 24bpp + and 32bpp operation. Note, this support isn't currently present + in the W32 accelerated server. + + 3.19. Alliance ProMotion driver (SVGA server) + + + o A driver for the Alliance ProMotion 6442 has been added (from + Alliance Semiconductor). This has not been thoroughly tested. + + + 3.20. NVidia NV1 / SGS Thomson STG2000 driver (SVGA server) + + + o *A driver for the NV1/STG2000 has been added. This chipset is + used on the Diamond Edge 3D card. This is a very new driver, + and is considered "beta". It includes support for 8bpp and + 16bpp. + + 3.21. Matrox Millennium driver (SVGA server) + + + o *A driver for the Matrox Millennium (mga2064w) has been added. + This is a very new driver, and is considered "beta". It + includes support for 8bpp, 16bpp, 24bpp and 32bpp. The + acceleration capabilities of this chipset are only used to a + very limited extent at this stage. + + 3.22. Cirrus driver (SVGA server) + + + o Support has been added for the CL-GD5446, CL-GD5462 and CL- + GD5464. + + o Support has been added for the CL-GD7543. + + o Support for the CL-GD754x series of laptop chips is included, + but it appears to be broken in this release. + + o The programmable clock code has been improved to avoid unstable + settings. + + o *Some FIFO setting problems have been fixed. + + o *Packed 24bpp support has been added for the 54xx. + + o *Some problems with 16bpp for a 1MB 5434 have been fixed. + + 3.23. SiS driver (SVGA server) + + + o Support is included for the SiS 86C201 PCI graphics card. + + o 256 colour support has been added. + + o SiS 86c202 and 86c205 somewhat work when "sis86c201" is + specified as chipset. + + 3.24. Chips and Technologies driver (SVGA server) + + + o This driver has been significantly reworked. + + o Support has been added for the 65546, 65548, 65550 and 65554. + + o Linear addressing support for the 65530 and above. + + o 16bpp and 24bpp (packed) support for the 65545 an above. + + o BitBLT and some other acceleration for the 65545, 65546, 65548 + and 65550. + + 3.25. ALI driver (SVGA server) + + + + + o Interlaced modes now work with this driver. + + 3.26. ATI driver (SVGA server) + + + o Mach64 support has been improved. + + o The driver name has been changed back from "vgawonder" to "ati". + + o Support is included for most recent Mach64 cards. + + o The "undoc_clocks" option has been removed. If you had been + using it, remove it from your XF86Config file. + + o A colourmap problem with VGA Wonder V3 boards has been fixed. + + 3.27. WD90C24 driver (SVGA server) + + + o A problem with snow at high clocks has been fixed. + + 3.28. Compaq AVGA driver (SVGA server) + + + o The Compaq AVGA driver has been disabled in this release because + it doesn't work, and nobody seems interested in fixing it. + + 3.29. Hercules mono driver + + + o The Hercules mono driver has been disabled in this release + because it has problems, and isn't likely to be fixed soon. + + 3.30. Client/Library changes + + + o Support for most vt220/vt320 escape sequenced has been added to + xterm. + + o Support for ddterm's escape sequences has been added to xterm. + + o The termcap and terminfo entries for xterm have been updated in + line with the new features present. These entries are not + completely compatible with earlier versions of xterm. + + o xdm's session handling on BSD OSs has been fixed. + + o Some buffer overrun problems which can lead to security problems + have been fixed in libXt and libX11. At least one of these + problems has been used to exploit the setuid xterm. + + o POSIX termios support has been added for xterm on most BSD + systems. This removes the need for the BSD kernel to built with + the COMPAT_43 option. + + o As part of the change to X11R6.1, the shared library revisions + for libX11, libXaw, libXext, and libXtst have been incremented + to 6.1. + + o The client-side library code for the XFree86 extensions and the + ScreenSaver extension has been moved into separate libraries. + The old libXExExt has been removed. + + o Colour support is now included by default in xterm. It isn't + enabled by default, but can be enabled with the +cm command line + + flag, or by setting the `colorMode' resource to `true'. I18N + support in xterm has been improved (as part of X11R6.1). If + you've previously been using one of the many "color_xterm" + variants, try this and let us know if you have any problems. + + o xdpyinfo has been updated to provide more detailed information + about the XInput extension and the XFree86 extensions. + + o The setting/examining of extended screen saver parameters has + been added to xset (was in xvidtune). xset can now also be used + to set the keyboard repeat parameters. + + o The following new clients have been added: + + + dga -- a test program for the XFree86-DGA extension. + + + xsetmode, xsetpointer -- programs for use with the XInput + extension. + + o The xdm security fix from the X Consortium's R6 fix-13 is + included. + + o xconsole has been updated for Unixware 2.x. + + o XNLS support has been added for KOI8-R. + + o xrdb dynamically allocates string space to avoid overruns. + + o A memory overrun problem in xterm has been fixed. + + o An "AllowNullPasswd" resource has been added to xdm. + + o libXt bug fix from the X Consortium's R6 fix-13. + + 3.31. xf86config utility + + + o Incorrect handling of IBM RGB Ramdacs has been fixed. + + 3.32. SuperProbe + + + o Added detection for C&T 65548, Cirrus CL-GD7543/1, AT&T 20C409, + AT&T20C499, and fixed an incorrect ET4000/W32 probe problem. + + o Much improved detection for Mach64 cards. + + o Improved detection for Trident cards. + + o Added detection of SiS, ARK, S3 ViRGE cards. + + 3.33. Fonts + + + o The Cyrillic fonts have been updated. + + + 4. Installing the XFree86 3.2 Release + + The XFree86 3.2 binary release is distributed as a full release, not + as an upgrade. + + What follows is a list of the XFree86 3.2 components. There may be + some variations in this for some OSs. + + + The following are required for all installations: + + + preinst.sh Pre-installation script + postinst.sh Post-installation script + X32bin.tgz Clients, run-time libs, and app-defaults files + X32doc.tgz Documentation + X32fnts.tgz 75dpi, misc and PEX fonts + X32lib.tgz Data files required at run-time + X32man.tgz Manual pages + X32set.tgz XF86Setup utility + X32VG16.tgz 16 colour VGA server (XF86Setup needs this server) + + + + + The following is required for new installations, and optional for + existing installations: + + + X32cfg.tgz sample config files for xinit, xdm + + + + + NOTE: Be very careful about installing X32cfg.tgz over an existing + installation if you have customised your xinit and/or xdm config + files. Installing X32cfg.tgz will overwrite any existing files. If + you do have customised files, there is no need to install X32cfg.tgz. + + The following X servers are for PC/AT hardware. Choose at least one + which matches your hardware, as well as the VGA16 server. The VGA16 + server is required by the new configuration utility (XF86Setup). + + + X328514.tgz 8514/A server + X32AGX.tgz AGX server + X32I128.tgz I128 server + X32Ma32.tgz Mach 32 server + X32Ma64.tgz Mach 64 server + X32Ma8.tgz Mach 8 server + X32Mono.tgz Mono server + X32P9K.tgz P9000 server + X32S3.tgz S3 server + X32S3V.tgz S3 ViRGE server + X32SVGA.tgz SVGA server + X32VG16.tgz 16 colour VGA server (XF86Setup needs this server) + X32W32.tgz ET4000/W32, ET6000 server + + + + + The following X server is for Alpha hardware. + + + X32TGA.tgz DEC 21030 (TGA) server + + + + + The following X servers are for PC98 hardware. If you have a PC98 + machine, choose one which suits your hardware. If you don't know what + a PC98 machine is, you don't need any of these. + + + + X329NS3.tgz PC98 NEC(S3) server + X329SPW.tgz PC98 PCSKB-PowerWindow(S3) server + X329LPW.tgz PC98 PowerWindowLB(S3) server + X329EGC.tgz PC98 EGC(generic) server + X329GA9.tgz PC98 GA-968V4/PCI(S3 968) server + X329GAN.tgz PC98 GANB-WAP(cirrus) server + X329480.tgz PC98 PEGC-480(generic) server + X329NKV.tgz PC98 NKV-NEC(cirrus) server + X329WS.tgz PC98 WABS(cirrus) server + X329WEP.tgz PC98 WAB-EP(cirrus) server + X329WSN.tgz PC98 WSN-A2F(cirrus) server + X329TGU.tgz PC98 TGUI server + + + + + The following are optional. + + + X32f100.tgz 100dpi fonts + X32fcyr.tgz Cyrillic fonts + X32fnon.tgz Other fonts (Chinese, Japanese, Korean, Hebrew) + X32fscl.tgz Scalable fonts (Speedo and Type1) + X32fsrv.tgz Font server and config files + X32prog.tgz X header files, config files and compile-time libs + X32lkit.tgz X server LinkKit + X32lk98.tgz PC98 X server LinkKit + X32nest.tgz Nested X server + X32vfb.tgz Virtual framebuffer X server + X32ps.tgz PostScript version of the documentation + X32html.tgz HTML version of the documentation + + + + + If you already have a version of XFree86 installed, MAKE A BACKUP OF + /usr/X11R6 BEFORE DOING ANYTHING ELSE. The standard installation + procedure will overwrite your existing version of XFree86. + + If you are installing from scratch, create a directory called + /usr/X11R6, then extract the required .tgz files. If you don't have + enough space in /usr for this, create a directory elsewhere and create + a symbolic link to it. E.g., if you create a directory in /home: + + + mkdir /home/X11R6 + ln -s /home/X11R6 /usr + + + + + The next step is to run the pre-installation script. This script + makes some preliminary checks of your system. For some OSs, it may + tell you to install new versions of some system components before + proceeding with the installation. This script also removes outdated + files and symbolic links from a previous installation that may cause + problems. + + Copy the preinst.sh script to /var/tmp, then go to /usr/X11R6 and run + it: + + + cd /usr/X11R6 + sh /var/tmp/preinst.sh + + + The .tgz files are gzipped tar files. To extract them, go to + /usr/X11R6, and run the following as root for each file you need: + + + gzip -d < X32file.tgz | tar vxf - + + + + + On some OSs, you might get some "Broken Pipe" messages. Providing + there are no other messages associated with this, they can be safely + ignored. Note: You should not be running X while doing this installa- + tion. Doing so may cause the installation to fail, or cause your X + session to crash. + + If you are using NetBSD or FreeBSD, a more reliable (and highly + recommended) way of doing this is to extract the .tgz files with: + + + gzip -d < X32file.tgz | tar -v -x --unlink -f - + + + + + If you have GNU cpio (as Linux does) or SVR4 cpio, a more reliable + (and highly recommended) way of doing this is to extract the .tgz + files with: + + + gzip -d < X32file.tgz | cpio -i -v -d -u -H ustar + + + + + Once the required .tgz files have been extracted, copy the postinst.sh + script to /var/tmp, then go to /usr/X11R6 and run it: + + + cd /usr/X11R6 + sh /var/tmp/postinst.sh + + + + + For OSs which use ldconfig (like Linux, FreeBSD and NetBSD), you + should either run ldconfig or reboot to complete the installation. On + FreeBSD and NetBSD, ldconfig takes arguments. In particular, you + should at least include /usr/lib and /usr/X11R6/lib on the command + line. Check /etc/rc to see how ldconfig gets run at boot time. + + + Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/RELNOTE.sgml,v 3.47 1996/10/26 09:38:54 dawes Exp $ - #if (BSD >= 199103) -To ensure that this symbol is correctly defined, include -in the source that requires it. Note that the symbol CSRG_BASED is -defined for *BSD systems in XFree86 3.1.1 and later. This should be -used to protect the inclusion of . -For code that really is specific to a particular i386 BSD port, use -__FreeBSD__ for FreeBSD, __NetBSD__ for NetBSD, __386BSD__ for 386BSD, -and __bsdi__ for BSD/386. -9. Thanks ----------- -Many thanks to: - o Pace Willison for providing initial *BSD support. - o Amancio Hasty for 386BSD kernel and S3 chipset support. - o David Greenman, Nate Williams, Jordan Hubbard for FreeBSD kernel - support. - o Rod Grimes, Jordan Hubbard and Jack Velte for the use of Walnut - Creek Cdrom's hardware. - o Orest Zborowski, Simon Cooper and Dirk Hohndel for ideas from - the Linux distribution. -$XConsortium: FreeBSD.sgml,v 1.3 95/01/23 15:34:41 kaleb Exp $ -Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/FreeBSD.sgml,v 3.10 1995/01/28 16:01:28 dawes Exp $ -$XFree86: xc/programs/Xserver/hw/xfree86/doc/READ.FreeBSD,v 3.12 1995/01/28 16:19:37 dawes Exp $ diff --git a/release/sysinstall/help/distributions.hlp b/release/sysinstall/help/distributions.hlp index f77241cd7ae1..d5289aea4176 100644 --- a/release/sysinstall/help/distributions.hlp +++ b/release/sysinstall/help/distributions.hlp @@ -2,7 +2,7 @@ DISTRIBUTION INFORMATION ------------------------ An ``X-'' prefixed before a distribution set means that the XFree86 -3.1.2-S base distribution, libraries, manual pages, SVGA server and a +3.2 base distribution, libraries, manual pages, SVGA server and a set of default fonts will be selected in addition to the set itself. If you select such a set, you will also be presented with a set of menus for customizing the selections to your desired X Window System @@ -23,7 +23,7 @@ Kern-Developer: As above, but with only kernel sources instead of the complete source tree. User: The base distribution, man pages, dictionary files and - the FreeBSD 1.x and 2.0 compatibility sets. + the FreeBSD 1.x, 2.0 and 2.1.x compatibility sets. Minimal: Only the base distribution. diff --git a/release/sysinstall/help/hardware.hlp b/release/sysinstall/help/hardware.hlp index cca8811b57d3..1cfb269c235f 100644 --- a/release/sysinstall/help/hardware.hlp +++ b/release/sysinstall/help/hardware.hlp @@ -1,4 +1,4 @@ -Hardware Documentation Guide: $Id: hardware.hlp,v 1.8 1996/08/23 07:56:04 jkh Exp $ +Hardware Documentation Guide: $Id: hardware.hlp,v 1.9.2.1 1996/11/13 11:49:40 jkh Exp $ Contents last changed: July 4th, 1996 @@ -102,7 +102,7 @@ le0 300 5 dyn d0000 Digital Equipment EtherWorks 2 and EtherWorks 3 lnc0 280 10 n/a dyn Lance/PCnet cards (Isolan, Novell NE2100, NE32-VL) -vx0 dyn dyn n/a dyn +vx0 dyn dyn n/a dyn 3Com 3c590 / 3c595 ze0 300 5 dyn d8000 IBM/National Semiconductor PCMCIA Ethernet Controller zp0 300 10 dyn d8000 3Com PCMCIA Etherlink III @@ -113,8 +113,8 @@ zp0 300 10 dyn d8000 3Com PCMCIA Etherlink III If the hardware in your computer is not set to the same settings as those shown in the table and the item in conflict is not marked 'dyn', you will have to either reconfigure your hardware or use UserConfig -('-c' boot option) to reconfigure the kernel to match the way your -hardware is currently set (see the next section). +to reconfigure the kernel to match the way your hardware is currently set +(see the next section). If the settings do not match, the kernel may be unable to locate or reliably access the devices in your system. @@ -123,127 +123,150 @@ or reliably access the devices in your system. 2. Using UserConfig to change FreeBSD kernel settings -- -------------------------------------------------- -The UserConfig utility allows you to override various settings of -the FreeBSD kernel before the system has booted. This allows you to -make minor adjustments to the various drivers in the system without -necessarily having to recompile the kernel. +The FreeBSD kernel on the install floppy contains drivers for every +piece of hardware that could concievably be used to install the rest +of the system with. Unfortunately, PC hardware being what it is, some +of these devices can be difficult to detect accurately, and for some, +the process of detecting another can cause irreversible confusion. -UserConfig is activated by specifying the `-c' flag at the initial -boot prompt. For example: +To make this process easier, FreeBSD provides UserConfig. With this +UserConfig, the user can configure and disable device drivers before +the kernel is loaded, avoiding potential conflicts, and eliminating +the need to reconfigure hardware to suit the default driver settings. - >> FreeBSD BOOT @ 0x10000: 640/7168 k of memory - Use hd(1,a)/kernel to boot sd0 when wd0 is also installed. - Usage: [[wd(0,a)]/kernel][-abcCdhrsv] - Use ? for file list or press Enter for defaults +Once FreeBSD is installed, it will remember the changes made using +UserConfig, so that they only need be made once. - Boot: -c - -- +It is important to disable drivers that are not relevant to a system +in order to minimise the possibility of interference, which can cause +problems that are difficult to track down. -This command causes the system to boot the default kernel ("/kernel") and -the UserConfig utility to be started once the kernel is loaded into memory. +UserConfig features a commandline interface for users with serial +consoles or a need to type commands, and a fullscreen 'visual' +interface, which provides point-and-shoot configuration functionality. -The `-c' flag follows any of the other parameters you may need to provide -for the system to boot properly. For example, to boot off the second of -two SCSI drives installed and run UserConfig, you would type: +Here is a sample UserConfig screen shot in 'visual' mode: - Boot: sd(1,a)/kernel -c - ----------------- +---Active Drivers---------------------------10 Conflicts------Dev---IRQ--Port-- + Storage : (Collapsed) + Network : + NE1000,NE2000,3C503,WD/SMC80xx Ethernet adapters CONF ed0 5 0x280 + NE1000,NE2000,3C503,WD/SMC80xx Ethernet adapters CONF ed1 5 0x300 + Communications : (Collapsed) + Input : (Collapsed) + Multimedia : +---Inactive Drivers-------------------------------------------Dev-------------- + Storage : + Network : (Collapsed) + Communications : + Input : + Multimedia : + PCI : -As always, the kernel will report some information on your processor -and how much memory your system has. Then UserConfig will be invoked -and you will see the prompt: - - config> - -To see the list of commands that UserConfig accepts, you may type '?' and -press [ENTER]. The help message looks something like this: - -Command Description -------- ----------- -ls List currently configured devices -port Set device port (i/o address) -irq Set device irq -drq Set device drq (DMA Request) -iomem Set device maddr (memory address) -iosize Set device memory size -flags Set device flags -enable Enable device -disable Disable device (will not be probed) -visual Go to visual mode -quit Exit this configuration utility -help This message +---Parameters-for-device-ed0--------------------------------------------------- + Port address : 0x280 Memory address : 0xd8000 + IRQ number : 5 Memory size : 0x2000 + Flags : 0x0000 +------------------------------------------------------------------------------- + IO Port address (Hexadecimal, 0x1-0x2000) + [TAB] Change fields [Q] Save device parameters -You may alter nearly all of the default settings present in the FreeBSD -generic kernel. This includes reassigning IRQs, disabling troublesome -devices (or drivers that conflict with the hardware your system has), -setting special device flags, etc. + The screen is divided into four sections : -Since people's tastes in user interface design vary widely, we have -provided two different interfaces to the UserConfig utility. If you -type `visual' (or just `v') you will be placed in the "GUI" oriented device -attributes editor. If you're someone who's more at home with -command-line flavored interfaces then simply don't do that and use -the CLI commands directly. :-) + - Active Drivers. Listed here are the device drivers that are currently + enabled, and their basic parameters. + - Inactive Drivers. These drivers are present, but are disabled. + - Parameter edit field. This area is used for editing driver parameters. + - Help area. Keystroke help is displayed here. -Since the visual interface pretty much describes itself, we'll use the -more verbose command line interface while describing UserConfig in the -following examples. +One of the Active and Inactive lists is always in use, and the current +entry in the list will be shown with a highlight bar. If there are +more entries in a list than can be shown, it will scroll. The bar can +be moved up and down using the cursor keys, and moved between lists +with the TAB key. -The most common use of UserConfig is to adjust or disable a driver -which is causing trouble. The "ls" command displays the current -settings for all the drivers present in the booted kernel, and once -you have located an entry of interest you may use the displayed device -name to change its settings or even disable the driver completely. +Drivers in the Active list may be marked "CONF". This indicates that +one or more of their parameters conflicts with another device, and +indicates a potential for problems. The total number of conflicts is +displayed at the top of the screen. -For example, to change the memory address of network adapter 'ed0' to -the address 0xd4000, you would type - - config> iomem ed0 0xd4000 - ----------------- +As a general rule, conflicts should be avoided, either by disabling +conflicting devices that are not present in the system, or by altering +their configuration so that they match the installed hardware. -To entirely disable a device driver you are not using, use the -"disable" command. In this example, you would disable device -`ie0' by typing: +In the list areas, drivers are grouped by their basic function. +Groups can be 'Collapsed' to simplify the display (this is the default +state for all groups). If a group is collapsed, it will be shown with +'(Collapsed)' in the list, as above. To Expand a Collapsed group, +position the highlight bar over the group heading and press Enter. To +Collapse it again, repeat the process. - config> disable ie0 - ----------- +When a device driver in the Active list is highlighted, its full +parameters are displayed in the Parameter edit area. Note that not +all drivers use all possible parameters, and some hardware supported +by drivers may not use all the parameters the driver supports. -You can use the "ls" command to verify your changes and correct -any other problems before continuing the boot process. +To disable a driver, go to the Active list, Expand the group it is in, +highlight the driver and press Del. The driver will move to its group +in the Inactive list. (If the group is collapsed or off the screen, +you may not see the driver in its new location.) -Once you are happy with a given configuration you may type: "quit" +To enable a driver, go to the Inactive list, Expand the group it is +in, highlight the driver and press Enter. The highlight will move to +the Active list, and the driver you have just enabled will be +highlighted, ready to be configured. -This will cause the kernel to boot with the new settings you -have chosen. +To configure a driver, go to the Active list, Expand the group it is +in, highlight the driver and press Enter. The cursor will move to the +Parameter edit area, and the device's parameters may be edited. -Once you have a fully installed system (e.g. the `bin' distribution -has been successfully extracted), any changes you make in UserConfig -are permanently stored in the `/kernel' file on the root filesystem. -This action is performed by the `dset' utility, which will ensure that -these settings remain in effect until you replace the kernel with -a new one. If you do not want your changes to be permanently -stored like this, remove `dset' from the /etc/rc file before you -make any changes. +While editing parameters, the TAB and cursor keys can be used to move +between fields. Most numeric values (except IRQ) are entered in +hexadecimal, as indicated by the '0x' at the beginning of the field. +The allowable values for a given field are show in the Key Help area +when the field is active. -If you accidentally change a setting for a device that you did not mean -to change, the safest thing to do is to reset the computer and start -over. Do not allow the boot to proceed (e.g. do not type "quit") with -bad settings as these may be permanently stored by dset and -leave your system in a state where it will no longer run properly. +To finish configuring a driver, press 'Q'. -We suggest as a general rule that you disable any drivers that are not -used by your particular hardware configuration. There are known problems -with certain device drivers (see section 4.0) that can cause conflicts -with other devices if they're also not disabled. You should move or -disable any device that resides at the same port or IRQ as a device -you actually have! -You can also remove drivers that are not needed by building yourself a -custom kernel that contains only the device drivers which your system -really needs (see section 6.0 of the FreeBSD.FAQ). If your system has -sufficient free disk space to store and compile the kernel sources, -this is the option we most highly recommend. +Sample UserConfig session +------------------------- + +Here is a walkthrough of a sample use of UserConfig. The system in +question has an IDE disk, two serial ports, a single printer port, a +floppy drive and an NE2000 ethernet card set to I/O address 0x340 and +IRQ 10. + +- At the 'config>' prompt, type 'v' and press Enter to activate + 'visual' mode. + +- The fullscreen mode comes up, with the highlight bar in the Active Drivers + area over the 'Storage' group, which is Collapsed. Press Enter to + Expand the group. + +- Disable all of the drivers listed in this group except for the + "Floppy disk controller" and "IDE/ESDI/MFM disk controller" by + highlighting each in turn and pressing Del. + +- Move to the 'Network' group, Expand it, and disable all of the drivers + except for 'ed0', the first of the + "NE1000,NE2000,3C503,WD/SMC80xx Ethernet adapters". + +- Move to the 'Communications' group, Expand it and disable the 'lpt1' and + 'lpt2' drivers. + +- Disable the 'mse0' driver in the 'Input' group. + +- Go back to the 'Network' group, highlight the 'ed0' driver, and press + Enter to configure it. + +- Change the 'Port address' and 'IRQ number' fields to match the + configuration of the card, ie. 0x340 and 10 respectively. + +- Press 'Q' to finish configuring the device, and then 'Q' again to + leave UserConfig. Answer 'yes' to save the changes and continue to boot + using the new configuration. 3. LINT - other possible configurations diff --git a/release/sysinstall/help/readme.hlp b/release/sysinstall/help/readme.hlp index ec4576798995..5f3071156fc0 100644 --- a/release/sysinstall/help/readme.hlp +++ b/release/sysinstall/help/readme.hlp @@ -1,25 +1,33 @@ ----------------------------------------- - FreeBSD 2.2 --- SNAPSNOT Version , , + FreeBSD 2.2 --- ALPHA Version , , ----------------------------------------- /( )` \ \___ / | -Welcome to the latest 2.2 SNAPSHOT release of /- _ `-/ ' -FreeBSD! These 2.2 snapshots are done periodically (/\/ \ \ /\ -along the way to 2.2-RELEASE (scheduled for release / / | ` \ -sometime in the first quarter of '97) for testing O O ) / | -purposes and to provide early access to new 2.2 `-^--'`< ' -features to those devlopers or hobbiests who have (_.) _ ) / -an interest in knowing more about what we're up to. `.___/` / +Welcome to the 2.2 ALPHA release of FreeBSD! /- _ `-/ ' +This release preceeds our first full 2.2 release, (/\/ \ \ /\ +which is scheduled for a late December / early / / | ` \ +January release. Your testing of this release will O O ) / | +help to ensure that 2.2-RELEASE is of the highest `-^--'`< ' +quality we can make it, and is much appreciated. (_.) _ ) / + `.___/` / `-----' / Feedback or offers to help with anything <----. __ / __ \ you see in this release are most welcome <----|====O)))==) \) /==== and should be sent to one of the approp- <----' `--' `.__,' \ riate mailing lists (see notes below). | | \ / /\ -Please also note that these SNAP releases are ______( (_ / \______/ -EXPERIMENTAL in nature and not intended for the ,' ,-----' | -casual user or in production environments! `--{__________) +Please also note that ALPHA releases, as much ______( (_ / \______/ +as we enjoy seeing them tested in serious ,' ,-----' | +situations, are not recommended for production `--{__________) +environments! +***** Final note: PLEASE also read the Hardware guide, which you will +find in the root directory of your distribution as HARDWARE.TXT. It +is also available in the Documentation submenu of the boot floppy, but +it's probably a good idea to read it before even getting that far. It +contains important checklist information on configuring your hardware +before starting the installation process. **** + What is FreeBSD? FreeBSD is an operating system based on 4.4 BSD Lite for Intel, AMD, Cyrix or NexGen "x86" based PC hardware. It works @@ -36,7 +44,7 @@ researchers or folks who simply want to see how it all works. A large collection of 3rd party ported software (the "ports collection") is also provided to make it easier for you to obtain and install all your favorite traditional UNIX utilities for FreeBSD. -Over 550 ports, from editors to programming languages to graphical +Over 600 ports, from editors to programming languages to graphical applications, make FreeBSD a powerful and comprehensive operating environment that extends far beyond what's provided by many commercial versions of UNIX. diff --git a/release/sysinstall/help/relnotes.hlp b/release/sysinstall/help/relnotes.hlp index e77dd19c6a4a..e0d8e7fffc67 100644 --- a/release/sysinstall/help/relnotes.hlp +++ b/release/sysinstall/help/relnotes.hlp @@ -1,32 +1,34 @@ RELEASE NOTES - FreeBSD Release 2.2 SNAPSHOT + FreeBSD Release 2.2-ALPHA -0. What's new since 2.2-961014-SNAP? +This is an ALPHA release of FreeBSD 2.2-RELEASE and is aimed primarily +at release testers. Some parts of the documentation may not be updated +yet and should be reported if and when seen. Naturally, any installation +failures or crashes should also be reported ASAP by sending mail to +bugs@freebsd.org or using the send-pr command (those preferring a WEB based +interface can also see http://www.freebsd.org/send-pr.html). + + +0. What's new since 2.1.5-RELEASE ------------------------------------ Support for the SDL RISCom N2pci sync serial card. -0. What's new since 2.2-961006-SNAP? ------------------------------------- - -11th-hour bug in SYN attack protection code fixed [showstopper]. - Support for Cyclades Cyclom-Y (multi-port async serial) PCI adaptors as well as multiple controllers and the 32-Y (if you are currently using the Cyclades serial adapter, you should re-make your /dev entries and remove the old ones). -/usr/src/contrib now part of src dist selection (doh!) [showstopper]. +Updated support for ethernet adaptors which use the DEC DC21X4X chipset. + +Support for HP PC Lan+ cards (model numbers: 27247B and 27252A) + +The 3COM 3c590 / 3c595 drivers have improved considerably. You need only change your kernel settings *once* now, on initial startup from the floppy. They will be preserved on the subsequently installed kernel. - -0. What's new since 2.2-960801-SNAP? ------------------------------------- -Support for HP PC Lan+ cards (model numbers: 27247B and 27252A) - Update to gcc 2.7.2.1 & add support for weak symbols. Many things moved/brought into /usr/src/contrib, updating and @@ -39,66 +41,6 @@ Update sgmlfmt to `instant'. Protection against the widely reported SYN attack. -1. What's New since 2.1.0-RELEASE? ----------------------------------- -A considerable number of changes to the VM system have been made -to increase the stability under certain types of load. If you -had panics under the last snapshot, try this one and see if they -persist. - -The AHC driver now does considerably more in the way of handling errors -gracefully. - -More cosmetic work on the installation, /stand/sysinstall now genuinely -useful after installation time (though still missing a man page - urk!). - -Early support for APM (automated power management) and PCCARD -(formerly PCMCIA) features of laptops. Many PCCARD devices -are supported, from modems to ethernet cards to SCSI adaptors. - -Adaptec AIC7850 support has been added. - -The Yellow Pages (NIS) support has had many optimizations made -and no longer has portions copyright under the GPL. - -Various VM system enhancements and a few bugs fixed (gzip'd binaries -now work again, for example). - -The system installation tool has been revamped with slightly different -menu behavior and a number of bugs have been fixed. It's hoped that -this installation will be more intuitive for new users than previous -ones (feedback welcomed, of course). - -The Intel EtherExpress Pro/100B PCI ethernet card is now supported. - -The 3COM 3C590 and 3C595 ethernet cards are now supported. - -The ARNET (now Digiboard) Sync 570i high-speed serial card is now supported. - -The Linux emulation is now good enough to run the Linux version of -Netscape, with JAVA support (as well as a number of other Linux -utilities). - -The Matrox Meteor frame grabber card is better supported. - -It is now possible to burn CDROMs using the Plasmon or HP 4080i -CDR drives (see `wormcontrol(1)'). - -The pipe code has been substantially sped up, as have some components -of the VM system. - -A /dev/random device (and associated "pool of entropy") has been added -for applications which require more unpredicatable sequences of random -numbers for security. See the random(4) man page for more info. - -Early NFS v3 support (not enabled by default). - -An early implementation of the Device Filesystem (devfs) is available -(see mount_devfs). Device switch tables are now also dynamically built. - -Early IPX routing support. - - 2. Technical overview --------------------- @@ -107,7 +49,7 @@ for Intel i386/i486/Pentium (or compatible) based PC's. It is based primarily on software from U.C. Berkeley's CSRG group, with some enhancements from NetBSD, 386BSD, and the Free Software Foundation. -Since our release of FreeBSD 2.0 over a year ago, the performance, +Since our release of FreeBSD 2.0 almost 2 years ago, the performance, feature set and stability of FreeBSD has improved dramatically. The largest change is a revamped VM system with a merged VM/file buffer cache that not only increases performance but reduces FreeBSD's memory @@ -123,11 +65,11 @@ heart and have attempted to provide what we hope is a more sane and easily understood installation process. Your feedback on this (constantly evolving) process is especially welcome! -In addition to the base distributions, FreeBSD offers a new ported -software collection with over 390 commonly sought-after programs. The +In addition to the base distributions, FreeBSD offers a ported +software collection with over 600 commonly sought-after programs. The list of ports ranges from http (WWW) servers, to games, languages, editors and almost everything in between. The entire ports collection -requires only 10MB of storage, all ports being expressed as "deltas" +requires only 6MB of storage, all ports being expressed as "deltas" to their original sources. This makes it much easier for us to update ports and greatly reduces the disk space demands made by the ports collection. To compile a port, you simply change to the directory of @@ -263,6 +205,7 @@ DEC EtherWORKS II NICs (DE200, DE201, DE202, and DE422) DEC DC21040, DC21041, or DC21140 based NICs (SMC Etherpower 8432T, DE245, etc) DEC FDDI (DEFPA/DEFEA) NICs Fujitsu MB86960A/MB86965A +HP PC Lan+ cards (model numbers: 27247B and 27252A) Intel EtherExpress (not recommended due to driver instability) Intel EtherExpress Pro/100B PCI Fast Ethernet @@ -343,7 +286,7 @@ LAST resort! 4.2. CDROM -FreeBSD 2.1-RELEASE and these 2.2 SNAPSHOT CDs may be ordered on CDROM from: +FreeBSD 2.1.6-RELEASE and 2.2-RELEASE CDs may be ordered on CDROM from: Walnut Creek CDROM 4041 Pike Lane, Suite D @@ -351,21 +294,16 @@ FreeBSD 2.1-RELEASE and these 2.2 SNAPSHOT CDs may be ordered on CDROM from: 1-800-786-9907, +1-510-674-0783, +1-510-674-0821 (fax) Or via the internet from orders@cdrom.com or http://www.cdrom.com. -Their current catalog can be obtained via ftp as: +Their current catalog can be obtained via ftp from: ftp://ftp.cdrom.com/cdrom/catalog. Cost per -RELEASE CD is $39.95 or $24.95 with a FreeBSD subscription. -FreeBSD 2.2-SNAP CDs are $29.95 or $14.95 with a FreeBSD-SNAP subscription +FreeBSD 3.0-SNAP CDs are $29.95 or $14.95 with a FreeBSD-SNAP subscription (-RELEASE and -SNAP subscriptions are entirely seperate). With a subscription, you will automatically receive updates as they are released. Your credit card will be billed when each disk is shipped and you may cancel your subscription at any time without further obligation. -Walnut Creek CDROM also sells a full line of FreeBSD related -merchandise such as T-shirts ($14.95, available in "child", Large and -XL sizes), coffee mugs ($9.95), tattoos ($0.25 each) and posters -($3.00). - Shipping (per order not per disc) is $5 in the US, Canada or Mexico and $9.00 overseas. They accept Visa, Mastercard, Discover, American Express or checks in U.S. Dollars and ship COD within the United @@ -383,7 +321,8 @@ valued - please do not hesitate to report any problems you may find (preferably with a fix attached, if you can!). The preferred method to submit bug reports from a machine with -internet mail connectivity is to use the send-pr command. Bug reports +internet mail connectivity is to use the send-pr command or use the CGI +script at http://www.freebsd.org/send-pr.html. Bug reports will be dutifully filed by our faithful bugfiler program and you can be sure that we'll do our best to respond to all reported bugs as soon as possible. Bugs filed in this way are also visible on our WEB site @@ -482,29 +421,40 @@ The FreeBSD Development Team, excluding core team members Thomas Gellekum Thomas Graichen Rod Grimes + James FitzGibbon John Hay Jeffrey Hsu Ugen J.S. Antsilevich Gary Jennejohn + Andreas Klemm + Warner Losh L Jonas Olsson Eric L. Hernes Scott Mace Atsushi Murai Mark Murray + Alex Nash + Masafumi NAKANE + David E. O'Brien Andras Olah + Steve Passe Bill Paul Joshua Peck Macdonald John Polstra + Steve Price Mike Pritchard Doug Rabson + James Raynard Geoff Rehmet Martin Renters Paul Richards Ollivier Robert + Chuck Robey Dima Ruban Wolfram Schneider Andreas Schulz Karl Strickland + Michael Smith Paul Traina Guido van Rooij Steven Wallace @@ -515,8 +465,8 @@ The FreeBSD Development Team, excluding core team members Additional FreeBSD helpers and beta testers: Coranth Gryphon Dave Rivers - Kaleb S. Keithley Michael Smith - Terry Lambert David Dawes + Kaleb S. Keithley Terry Lambert + David Dawes Don Lewis Special mention to: @@ -544,4 +494,4 @@ We sincerely hope you enjoy this release of FreeBSD! The FreeBSD Core Team -$Id: relnotes.hlp,v 1.16 1996/10/23 22:28:56 wosch Exp $ +$Id: relnotes.hlp,v 1.17.2.1 1996/11/13 11:49:42 jkh Exp $ diff --git a/release/sysinstall/help/upgrade.hlp b/release/sysinstall/help/upgrade.hlp index 37527a355328..0e693c95f36d 100644 --- a/release/sysinstall/help/upgrade.hlp +++ b/release/sysinstall/help/upgrade.hlp @@ -1,11 +1,11 @@ -Welcome to the 2.1 (or 2.0.5) -> 2.1.6 upgrade procedure! +Welcome to the 2.1.x (or 2.0.5) -> 2.2 upgrade procedure! It must first be said that this upgrade DOES NOT take a particularly -sophisticated approach to the upgrade problem, it being more a question -of providing what seemed "good enough" at the time. A truly polished -upgrade that deals properly with the broad spectrum of installed 2.0.5 / 2.1 -systems would be nice to have, but until that gets written what you get is -this - the brute-force approach! +sophisticated approach to the upgrade problem, it being more a +question of providing what seemed "good enough" at the time. A truly +polished upgrade that deals properly with the broad spectrum of +installed 2.0.5 / 2.1 systems would be nice to have, but until that +gets written what you get is this - the brute-force approach! What this upgrade will attempt to do is best summarized thusly: diff --git a/usr.sbin/sysinstall/help/distributions.hlp b/usr.sbin/sysinstall/help/distributions.hlp index f77241cd7ae1..d5289aea4176 100644 --- a/usr.sbin/sysinstall/help/distributions.hlp +++ b/usr.sbin/sysinstall/help/distributions.hlp @@ -2,7 +2,7 @@ DISTRIBUTION INFORMATION ------------------------ An ``X-'' prefixed before a distribution set means that the XFree86 -3.1.2-S base distribution, libraries, manual pages, SVGA server and a +3.2 base distribution, libraries, manual pages, SVGA server and a set of default fonts will be selected in addition to the set itself. If you select such a set, you will also be presented with a set of menus for customizing the selections to your desired X Window System @@ -23,7 +23,7 @@ Kern-Developer: As above, but with only kernel sources instead of the complete source tree. User: The base distribution, man pages, dictionary files and - the FreeBSD 1.x and 2.0 compatibility sets. + the FreeBSD 1.x, 2.0 and 2.1.x compatibility sets. Minimal: Only the base distribution.