diff options
| author | Nathan Whitehorn <nwhitehorn@FreeBSD.org> | 2011-10-03 15:13:09 +0000 |
|---|---|---|
| committer | Nathan Whitehorn <nwhitehorn@FreeBSD.org> | 2011-10-03 15:13:09 +0000 |
| commit | e59e2d8ec7ee4b936b1d9299aed5b879b5dcc26f (patch) | |
| tree | c481c54594473b69a886998821cfee95a4a025ba /usr.sbin/sysinstall/help | |
| parent | 8d79dfca555bf45bec92359b163370674aa5a526 (diff) | |
Notes
Diffstat (limited to 'usr.sbin/sysinstall/help')
| -rw-r--r-- | usr.sbin/sysinstall/help/anonftp.hlp | 21 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/configure.hlp | 10 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/distributions.hlp | 34 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/drives.hlp | 92 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/fixit.hlp | 3 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/html.hlp | 20 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/media.hlp | 54 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/network_device.hlp | 58 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/options.hlp | 181 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/partition.hlp | 169 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/securelevel.hlp | 40 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/shortcuts.hlp | 117 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/slice.hlp | 57 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/tcp.hlp | 42 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/usage.hlp | 65 | ||||
| -rw-r--r-- | usr.sbin/sysinstall/help/usermgmt.hlp | 89 |
16 files changed, 0 insertions, 1052 deletions
diff --git a/usr.sbin/sysinstall/help/anonftp.hlp b/usr.sbin/sysinstall/help/anonftp.hlp deleted file mode 100644 index a85b8aa85883d..0000000000000 --- a/usr.sbin/sysinstall/help/anonftp.hlp +++ /dev/null @@ -1,21 +0,0 @@ -This screen allows you to configure the anonymous FTP user. - -The following configuration values are editable: - -UID: The user ID you wish to assign to the anonymous FTP user. - All files uploaded will be owned by this ID. - -Group: Which group you wish the anonymous FTP user to be in. - -Comment: String describing this user in /etc/passwd - - -FTP Root Directory: - - Where files available for anonymous FTP will be kept. - -Upload subdirectory: - - Where files uploaded by anonymous FTP users will go. - If you do not wish to allow anonymous uploads, then this - field should be blank - note that this is not the default! diff --git a/usr.sbin/sysinstall/help/configure.hlp b/usr.sbin/sysinstall/help/configure.hlp deleted file mode 100644 index 65be877a3252c..0000000000000 --- a/usr.sbin/sysinstall/help/configure.hlp +++ /dev/null @@ -1,10 +0,0 @@ -This menu allows you to configure your system after the installation -process is complete. At the minimum, you should probably set the -system manager's password and the system time zone. - -For extra goodies like bash, emacs, Pascal, etc., you should look at -the Packages item in this menu. - -For setting the timezone after the system is installed, type -``tzsetup''. For more information on the overall general system -configuration, see the ``/etc/defaults/rc.conf'' file. diff --git a/usr.sbin/sysinstall/help/distributions.hlp b/usr.sbin/sysinstall/help/distributions.hlp deleted file mode 100644 index d6fefa665b756..0000000000000 --- a/usr.sbin/sysinstall/help/distributions.hlp +++ /dev/null @@ -1,34 +0,0 @@ -DISTRIBUTION INFORMATION ------------------------- - -An ``X-'' prefixed before a distribution set means that the Xorg -base distribution, libraries, manual pages, servers 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 -setup. - -Any distribution may be further customized by selecting the `Custom' -item before leaving the menu. - -The current "canned" installations are provided: - -All: The base distribution, man pages, dictionary files, - profiling libraries, the FreeBSD compatibility libraries, - the complete source tree, games and your choice of Xorg - distribution components. - -Developer: Base distribution, man pages, dictionary files, - profiling libraries and the complete source tree. - -Kern-Developer: As Developer, but with only kernel sources instead of - the complete source tree. - -User: The base distribution, man pages and dictionary files. - -Minimal: Only the base distribution. - -Custom: Allows you to create or modify your distribution set on - a piece-by-piece basis. - -Reset: Clear all currently selected distributions. diff --git a/usr.sbin/sysinstall/help/drives.hlp b/usr.sbin/sysinstall/help/drives.hlp deleted file mode 100644 index 946a1b211b7f0..0000000000000 --- a/usr.sbin/sysinstall/help/drives.hlp +++ /dev/null @@ -1,92 +0,0 @@ -Boot Manager Selection: ------------------------ - -If you wish to switch between multiple operating systems on your -machine, or if you are trying to install FreeBSD on a drive other than -your 1st drive, then you must install a boot manager. In the case -where you wish to boot off an alternate drive, it should also be noted -that you still need to install a boot manager on the FIRST drive! -Even if you do not intend to create a FreeBSD partition on that drive -(e.g. it's being wholly used by something else), the boot manager -still needs to reside on the first disk in order to function as a -"redirector" for the boot process. - -To do this, simply select your 1st drive in the drive selection menu -and when the partition editor comes up, don't make any changes - just -(Q)uit. At the boot manager menu which follows, select the first -option (install a boot manager) and then proceed to setup the other -drive(s) for FreeBSD as normal. - -It should also be noted that "operating systems" such as Windows 95 -will completely overwrite your boot manager without so much as a -polite "may I please destroy your boot manager?" prompt if you make -the mistake of installing them second. If this happens to you after -FreeBSD is already installed, all is not lost! Simply revisit your -FreeBSD distribution directory and look for a tools/ subdirectory, in -which you'll find "bootinst.exe" and "boot.bin". To reinstall, simply -say "bootinst boot.bin" while in the tools/ subdirectory. - - -If you see the boot manager displaying ``F?'' when you try to come up -for the first time and it refuses to change, no matter how often you -whap on the function key assigned to FreeBSD, then you have a geometry -mismatch problem and you should read the next section for important -information on how to prevent that exact problem from happening! - - -Geometry Translation / Sharing the disk(s) with another OS: ----------------------------------------------------------- - -If you are going to actually install some portion of FreeBSD on a -drive then PLEASE BE VERY CERTAIN that the Geometry reported in the -Partition Editor is the correct one for your drive and controller -combination! - -IDE drives often have a certain geometry set during the PC BIOS setup, -or (in the case of larger IDE drives) have their geometry "translated" -by either the IDE controller or a special boot-sector translation -utility such as that by OnTrack Systems. In these cases, knowing the -correct geometry gets even more complicated as it's not something you -can easily tell by looking at the drive or the PC BIOS setup. The -best way of verifying that your geometry is being correctly calculated -in such situations is to boot DOS (from the hard disk, not a floppy!) -and run the ``pfdisk'' utility provided in the tools/ subdirectory of -the FreeBSD CDROM or FTP site. It will report the geometry that DOS -sees, which is generally the correct one. - -If you have no DOS partition sharing the disk at all, then you may -find that you have better luck with Geometry detection if you create a -very small DOS partition first, before installing FreeBSD. Once -FreeBSD is installed you can always delete it again if you need the -space. - -It's actually not a bad idea (believe it or not) to have a small -bootable DOS partition on your FreeBSD machine anyway: Should the -machine become unstable or exhibit strange behavior at some point in -the future (which is not uncommon behavior for PC hardware!) you can -then at least use DOS for installing and running one of the -commercially available system diagnostic utilities. - -IMPORTANT NOTE: - -Any root partition you try to boot from must also reside below the -1024th cylinder. If you're using a translated geometry then this is -probably not a problem, but if you are using a native disk geometry -which exceeds 1024 cylinders then you could have a failure to boot if -you end up installing a root partition (or even just the kernel file -in a root partition) out past cylinder 1024. If you are trying to -share your first disk with FreeBSD and another OS which was installed -previously, you are particularly susceptible to this problem and should -check your disk addresses very carefully. - -If you find that you have insufficient space below cylinder 1024 to -make a root partition for FreeBSD (and again, this ONLY applies to the -root partition - once FreeBSD's kernel is loaded, it doesn't care -about the geometry issues) then you will probably need to install on a -completely different disk (see the boot manager section above) or -resize your existing partitions so that both operating systems can -have boot partitions below cylinder 1024. - -You may blame IBM for the limitations of a 10 bit cylinder address. -"No one will have a disk with more than 1024 cylinders." I'm sure -someone said. diff --git a/usr.sbin/sysinstall/help/fixit.hlp b/usr.sbin/sysinstall/help/fixit.hlp deleted file mode 100644 index 801f2589a5bec..0000000000000 --- a/usr.sbin/sysinstall/help/fixit.hlp +++ /dev/null @@ -1,3 +0,0 @@ -A special shell will be launched by this option with a fixit floppy -or a FreeBSD CD-ROM (or DVD-ROM) mounted as /mnt2. This provides -access to extra commands under /mnt2. diff --git a/usr.sbin/sysinstall/help/html.hlp b/usr.sbin/sysinstall/help/html.hlp deleted file mode 100644 index c12f82c07d3e9..0000000000000 --- a/usr.sbin/sysinstall/help/html.hlp +++ /dev/null @@ -1,20 +0,0 @@ -In this screen, you can jump to remote or local HTML -resources such as the FreeBSD Handbook & FreeBSD FAQ -(Frequently Asked Questions) documents located in: - - file:/usr/share/doc/ - -if you've loaded the doc distribution. - -The default browser package used is links (a text based -browser which can render tables), which will be -automatically loaded from the installation media if it -is available. You may change the selection of browser -& browser package to auto-load by visiting the Options -editor. - -In order to visit remote URLs, you naturally must have -some sort of working Internet connection. If you have not -yet brought up any network interfaces, please visit -the ``Networking'' item in the Configuration menu -before attempting to reference any http://.. style URLs. diff --git a/usr.sbin/sysinstall/help/media.hlp b/usr.sbin/sysinstall/help/media.hlp deleted file mode 100644 index 414a2aa208b42..0000000000000 --- a/usr.sbin/sysinstall/help/media.hlp +++ /dev/null @@ -1,54 +0,0 @@ -You can install from the following types of media: - - CDROM requires one of the following supported CDROM drives: - ATAPI - Any standard ATAPI CDROM drive hooked to - a supported controller (see Hardware Guide). - SCSI - Any standard SCSI CDROM drive hooked to - a supported controller (see Hardware Guide). - - - DOS A DOS primary partition with the required FreeBSD - distribution files copied onto it (e.g. C:\FREEBSD\) - - - FS Assuming a disk or partition with an existing - FreeBSD file system and distribution set on it, - get the distribution files from there. - - - Floppy Get distribution files from one or more DOS or UFS - formatted floppies. Such floppies are assumed to - contain the appropriate distribution pieces - see - ABOUT.TXT for more information about making floppy - distribution media. - - - FTP Get the distribution files from an anonymous ftp server - (you will be presented with a list). Please note that - you may invoke FTP in "Active" mode, "Passive" mode, or - via an HTTP proxy. - - Active mode is the standard way of fetching files and - Passive mode is for use when you're behind a firewall or - some other security mechanism that blocks active FTP - connections. Using an HTTP proxy is sometimes necessary - for firewalls which block all FTP connections. - - If you chose to enter your own URL in the FTP menu, please - note that all paths are *relative* to the home directory - of the user being logged in as. By default, this is the - user "ftp" (anonymous ftp) but you may change this in the - Options screen. - - - NFS Get the distribution files from an NFS server somewhere - (make sure that permissions on the server allow this!). - If this install method hangs on you or refuses to work - properly, you may need to set some special options for - your NFS server. See the Options screen for more details. - - - Tape Extract distribution files from tape into a temporary - directory and install from there. If the tape was created - with blocksize other than 20, you may wish to change this - in the Options screen. diff --git a/usr.sbin/sysinstall/help/network_device.hlp b/usr.sbin/sysinstall/help/network_device.hlp deleted file mode 100644 index affa86a91ec88..0000000000000 --- a/usr.sbin/sysinstall/help/network_device.hlp +++ /dev/null @@ -1,58 +0,0 @@ -You can do network installations over 3 types of communications links: - - Serial port: SLIP / PPP - Parallel port: PLIP (laplink cable) - Ethernet: A standard Ethernet controller (includes some - PCMCIA networking cards). - -SLIP support is rather primitive and limited primarily to directly -connected links, such as a serial cable running between a laptop -computer and another PC. The link must be hard-wired as the SLIP -installation doesn't currently offer a dialing capability (that -facility is offered by the PPP utility, which should be used in -preference to SLIP whenever possible). When you choose the SLIP -option, you'll be given the option of later editing the slattach -command before it's run on the serial line. It is expected that -you'll run slattach (or some equivalent command) on the other end of -the link at that time and bring up the line. FreeBSD will then -install itself at serial speeds of up to 115.2K/baud (the recommended -speed for a hardwired cable). - -If you're using a modem then PPP is almost certainly your only choice. -Make sure that you have your service provider's information handy as -you'll need to know it fairly early in the installation process. You -will need to know your service provider's IP address, the IP address -of your provider's DNS server, and possibly your own IP address unless -your ISP supports dynamic negotiation, most do. If you do not choose -a PAP or CHAP login you will also need to know how to use the various -"AT commands" to dial the ISP with your particular brand of modem as -the PPP dialer provides only a very simple terminal emulator and has no -"modem capabilities database". If you choose a PAP or CHAP login you -can simply enter `dial' (without the quotes) at the ppp prompt if your -modem uses the Hayes compatible AT command set. - -If a hard-wired connection to another FreeBSD (2.0R or later) machine -is available, you might also consider installing over a "laplink" -parallel port cable. The data rate over the parallel port is much -higher than what is typically possible over a serial line, and speeds -of over 50KB/sec are not uncommon. - -Finally, for the fastest possible network installation, an Ethernet -adaptor is always a good choice! FreeBSD supports most common PC -Ethernet cards, a table of which is provided in the FreeBSD Hardware -Guide (see the `Documentation' entry in the main menu). If you are -using one of the supported PCMCIA Ethernet cards, also be sure that -it's plugged in BEFORE the laptop is powered on! Sysinstall does not, -unfortunately, currently support "hot insertion" of PCMCIA cards. - -You will also need to know your IP address on the network, the -"netmask" value for your address class, and the name of your machine. -Your system administrator can tell you which values to use for your -particular network setup. If you will be referring to other hosts by -name rather than IP address, you'll also need a name server and -possibly the address of a gateway (if you're using PPP, it's your -provider's IP address) to use in talking to it. If you do not know -the answers to all or most of these questions then you should really -probably talk to your system administrator FIRST before trying this -type of installation! Choosing the wrong IP address on a busy network -will NOT make you popular with your systems administrator! :-) diff --git a/usr.sbin/sysinstall/help/options.hlp b/usr.sbin/sysinstall/help/options.hlp deleted file mode 100644 index e1371ff1e89b4..0000000000000 --- a/usr.sbin/sysinstall/help/options.hlp +++ /dev/null @@ -1,181 +0,0 @@ -The following options may be set from this screen. Use the SPACE key -to toggle an option's value, Q to leave when you're done. - -NFS Secure: NFS server talks only on a secure port - - This is most commonly used when talking to Sun workstations, which - will not talk NFS over "non privileged" ports. - - -NFS Slow: User is using a slow PC or Ethernet card - - Use this option if you have a slow PC (386) or an Ethernet card - with poor performance being "fed" by NFS on a higher-performance - workstation. This will throttle the workstation back to prevent - the PC from becoming swamped with data. - - -NFS TCP: Use TCP for the NFS mount - - This option can be used if your NFS server supports TCP - connections; not all do! This may be useful if your NFS server - is at a remote site in which case it may offer some additional - stability. - - -NFS version 3: Use NFS version 3 - - This option forces the use of NFS version 3 and is on by default. - If your NFS server only supports NFS version 2, disable this option. - - -Debugging: Turn on the extra debugging flag - - This turns on a lot of extra noise over on the second screen - (ALT-F2 to see it, ALT-F1 to switch back). If your installation - should fail for any reason, PLEASE turn this flag on when - attempting to reproduce the problem. It will provide a lot of - extra debugging at the failure point and may be very helpful to - the developers in tracking such problems down! - - -No Warnings: Disable some warnings - - This flag tells sysinstall, and particularly the disk editing - routines, that you consider yourself to know what you are - doing and disables various warning. It is not recommended that - you enable this option. - - -Yes To All: Assume "Yes" answers to all non-critical dialogs - - This flag should be used with caution. It will essentially - decide NOT to ask the user about any "boundary" conditions that - might not constitute actual errors but may be warnings indicative - of other problems. It's most useful to those who are doing unattended - installs. - - -DHCP: Enable DHCP configuration of interfaces - - This option specifies whether DHCP configuration of interfaces - may be attempted. The default setting is to interactively ask - the user. - - -IPv6: Enable IPv6 router solicitation configuration - - This option specifies whether automatic configuration of IPv6 - interfaces may be attempted. This uses the router solicitation - method of automatic configuration. The default setting is to - interactively ask the user. - - -FTP username: Specify username and password instead of anonymous. - - By default, the installation attempts to log in as the - anonymous user. If you wish to log in as someone else, - specify the username and password with this option. - - -Editor: Specify which screen editor to use. - - At various points during the installation it may be necessary - to customize some text file, at which point the user will be - thrown unceremoniously into a screen editor. A relatively - simplistic editor which shows its command set on-screen is - selected by default, but UNIX purists may wish to change this - setting to `/usr/bin/vi'. - - -Tape Blocksize: Specify block size in 512 byte blocks of tape. - - This defaults to 20 blocks, which should work with most - tape drive + tar combinations. It may not allow your particular - drive to win any records for speed, however, and the more - adventurous among you might try experimenting with larger sizes. - - -Extract Detail: How to show filenames on debug screen as they're extracted. - - While a distribution is being extracted, the default detail level - of "high" will show the full file names as they're extracted. - If you would prefer a more terse form for this, namely dots, select - the "medium" detail level. If you want nothing to be printed - on the debugging screen during extraction, select "low". - - -Release Name: Which release to attempt to load from installation media. - - You should only change this option if you're really sure you know - what you are doing! This will change the release name used by - sysinstall when fetching components of any distributions, and - is a useful way of using a more recent installation boot floppy - with an older release (say, on CDROM). - - -Install Root: Specify some directory other than / as your "root". - - This should be left as / unless you have a really good reason to - change it. One good reason might be if you were installing to a - disk other than your own, as might happen if you needed to prepare a - disk for another machine which couldn't load FreeBSD directly - for some reason. - - Note: If you set this option, you will only be able to install - packages if the base distribution is also installed (usually - the case anyway) since /usr/sbin/pkg_add will otherwise not be - found after the chroot() call. - - -Browser Package: Which package to load for an HTML browser. - - By default, this is set to links but may also be set to any other - text capable HTML browser for which a package exists. If you set this - to an X based browser, you will not be able to use it if you're running - in text mode! :) - - -Browser Exec: Which binary to run for the HTML browser. - - The full pathname to the main executable in Browser Package. - - -Media Type: Which media type is being used. - - This is mostly informational and indicates which media type (if any) - was last selected in the Media menu. It's also a convenient short-cut - to the media menu itself. - - -Package Temp: Where package temporary files should go - - Some packages, like emacs, can use a LOT of temporary space - up to - 20 or 30MB. If you are going to configure a small / directory and no - separate /var (and hence a small /var/tmp), then you may wish to set - this to point at another location (say, /usr/tmp). - - -Newfs Args: Specify default arguments to newfs(8) - - The default parameters used to build new filesystems. - If you will be running a service that creates millions of small - files or need to specify different default parameters for any - other reason, you may do so here. - - -Fixit Console: The location of the fixit console - - Specifies where sysinstall should start the fixit shell for - interactive repair. Valid arguments are "serial" for a serial - port, or "standard" for VTY4. - - -Re-scan Devices: - - Reprobe the system for devices. - - -Use Defaults: Use default values. - - Reset all options back to their default values. diff --git a/usr.sbin/sysinstall/help/partition.hlp b/usr.sbin/sysinstall/help/partition.hlp deleted file mode 100644 index 3d13b34afad80..0000000000000 --- a/usr.sbin/sysinstall/help/partition.hlp +++ /dev/null @@ -1,169 +0,0 @@ -This is the FreeBSD DiskLabel Editor. - -NOTE: If you're entering this editor from the update procedure then -you probably shouldn't (C)reate anything at all but rather use only -the (M)ount command to check and mount existing partitions for -upgrading. - -If you would like the label editor to do most of the following for -you, simply type `A' for automatic partitioning of the disk. - -If you wish to create partitions manually you may do so by moving the -highlighted selection bar with the arrow keys over the FreeBSD -partition(s) displayed at the top of the screen. Typing (C)reate -while a partition with available free space is selected will allow you -to create a BSD partition inside of it using some or all of its -available space. - -Typing (M)ount over an existing partition entry (displayed in the -middle of the screen) will allow you to set a mount point for it -without initializing it. If you want it initialized, use the (T)oggle -command to flip the Newfs flag. When Newfs is set to "Y", the -filesystem in question will be ERASED and rebuilt from scratch! - - -You should use this editor to create at least the following -filesystems: - - Name Purpose Min Size? Optional? - ---- ------- --------- --------- - / Root filesystem 118MB No - swap Swap space 2 * MEM No - /usr System & user files 128MB or more Yes - -Note: If you do not create a /usr filesystem then your / filesystem -will need to be bigger - at least 240MB. This is not recommended as -any media errors that may occur during disk I/O to user files will -corrupt the filesystem containing vital system files as well. It is -for this reason that / is generally kept on its own filesystem, where -it should be considered essentially "read only" in your administration -of it. - -Swap space is a little tricker, and the rule of "2 * MEM" is simply a -best-guess approximation and not necessarily accurate for your -intended usage of the system. If you intend to use the system heavily -in a server or multi-user application, you may be well advised to -increase this size. You may also create swap space on multiple drives -for a larger "total" swap and this is, in fact, recommended if you -have multiple, fast drives for which such load-balancing can only help -overall I/O performance. - -The /usr filesystem should be sized according to what kind of -distributions you're trying to load and how many packages you intend -to install in locations like /usr/local. You can also make /usr/local -a separate filesystem if you don't want to risk filling up your /usr -by mistake. - -Another useful filesystem to create is /var, which contains mail, news -printer spool files and other temporary items. It is a popular -candidate for a separate partition and should be sized according to -your estimates of the amount of mail, news or spooled print jobs that -may be stored there. - -WARNING: If you do not create a separate filesystem for /var, space -for such files will be allocated out of the root (/) filesystem -instead. You may therefore wish to make the / partition bigger if you -expect a lot of mail or news and do not want to make /var its own -partition. - -If you're new to this installation, you might also want to read the -following explanation of how FreeBSD's new "slice" paradigm for -looking at disk storage works: - - -In FreeBSD's new system, a device name can be broken up into up to 3 -parts. Take a typical name like ``/dev/da0s1a'': - - The first three characters represent the drive name. If we had - a system with two SCSI drives on it then we'd see /dev/da0 and - /dev/da1 as the device entries representing the entire drives. - - Next you have the "slice" (or "FDISK Partition") number, - as seen in the Partition Editor. Assuming that our da0 - contained two slices, a FreeBSD slice and a DOS slice, that - would give us /dev/da0s1 and /dev/da0s2 as device entries pointing - to the entire slices. - - Next, if a slice is a FreeBSD slice, you can have a number of - (confusingly named) "partitions" inside of it. - - These partitions are where various filesystems or swap areas live, - and using our hypothetical two-SCSI-disk machine again, we might - have something like the following layout on da0: - - Name Mountpoint - ---- ---------- - da0s1a / - da0s1b <swap space> - da0s1e /usr - -Once you understand all this, then the purpose of the label editor -becomes fairly clear: You're carving up the FreeBSD slices displayed -at the top of the screen into smaller pieces, which are displayed in -the middle of the screen, and then assigning FreeBSD file system names -(mount points) to them. - -You can also use the label editor to mount existing partitions/slices -into your filesystem hierarchy, as is frequently done for DOS FAT -slices. For FreeBSD partitions, you can also toggle the "newfs" state -so that the partitions are either (re)created from scratch or simply -checked and mounted (the contents are preserved). - -If you set (S)oftUpdates on a filesystem, it will cause the -"Soft Updates" policy to be in effect for it. This basically causes -both metadata and data blocks to be written asynchronously to disk, -but with extra state information which causes the metadata and any -related data blocks to be committed in a single transaction. This -results in async metadata update speeds (which are considerably -faster than the default sync) without the potential for data loss -which could occur if you simply mounted the filesystem with purely -"async" update policy and then had a power failure. If you wish -to later turn the softupdates policy back off, use the command -"tunefs -n disable devicename". NOTE: It is probably not wise -to use this on your root filesystem unless you have a large -(e.g. non-standard size) root. The reason is that smaller filesystems -with significant activity can temporarily overflow if the soft updates -policy results in free'd blocks not being "garbage collected" as fast -as they're being requested. - -The UNIX File System (UFS) on FreeBSD supports two different on-disk -layouts: UFS1 and UFS2. UFS1 was the default file system in use -through FreeBSD 5.0-RELEASE; as of FreeBSD 5.1-RELEASE, the default -is now UFS2, with the exception of the PC98 platform. UFS2 provides -sparse inode allocation (faster fsck), 64-bit storage pointers (larger -maximum size), and native extended attributes (required for ACLs, MAC, -and other advanced security and file system services). The selection -of UFS1 or UFS2 must be made when the file system is created--later -conversion is not currently possible. UFS2 is the recommended file -system, but if disks are to be used on older FreeBSD systems, UFS1 -improves portability. When dual-booting between FreeBSD 4.x or -earlier and FreeBSD 5.x, UFS1 file systems will be accessible from -both. To toggle a file system to UFS1, press '1'. To restore it to -UFS2, press '2'. - -WARNING: FreeBSD on i386 is currently unable to boot from root file -systems larger than 1.5TB. - -To add additional flags to the newfs command line for UFS file -systems, press 'N'. These options will be specified before the -device argument of the command line, but after any other options -placed there by sysinstall, such as the UFS version and soft -updates flag; as such, arguments provided may override existing -settings. To completely replace the newfs command used by -sysinstall, press 'Z' to convert a partition to a Custom -partition type. Sysinstall will prompt you with the newfs -command line that it would have used based on existing settings -prior to the change, but allow you to modify any aspect of the -command line. Once a partition has been converted to a custom -partition in the label editor, you will need to restart the -labeling process or delete and recreate the partition to restore -it to a non-custom state. Custom partitions are represented by -the letters "CST" instead of "UFS" or "FAT. - -When you're done, type `Q' to exit. - -No actual changes will be made to the disk until you (C)ommit from the -Install menu or (W)rite directly from this one. You're working with -what is essentially a copy of the disk label(s), both here and in the -FDISK Partition Editor, and the actual on-disk labels won't be -affected by any changes you make until you explicitly say so. diff --git a/usr.sbin/sysinstall/help/securelevel.hlp b/usr.sbin/sysinstall/help/securelevel.hlp deleted file mode 100644 index 27eb1ec231b91..0000000000000 --- a/usr.sbin/sysinstall/help/securelevel.hlp +++ /dev/null @@ -1,40 +0,0 @@ -This menu allows you to configure the Securelevel mechanism in FreeBSD. - -Securelevels may be used to limit the privileges assigned to the -root user in multi-user mode, which in turn may limit the effects of -a root compromise, at the cost of reducing administrative functions. -Refer to the security(7) and init(8) manual pages for complete details. - - -1 Permanently insecure mode - always run the system in level 0 - mode. This is the default initial value. - - 0 Insecure mode - immutable and append-only flags may be turned - off. All devices may be read or written subject to their - permissions. - - 1 Secure mode - the system immutable and system append-only - flags may not be turned off; disks for mounted file systems, - /dev/mem, /dev/kmem and /dev/io (if your platform has it) - may not be opened for writing; kernel modules (see kld(4)) - may not be loaded or unloaded. - - 2 Highly secure mode - same as secure mode, plus disks may not - be opened for writing (except by mount(2)) whether mounted or - not. This level precludes tampering with file systems by - unmounting them, but also inhibits running newfs(8) while the - system is multi-user. - - In addition, kernel time changes are restricted to less than - or equal to one second. Attempts to change the time by more - than this will log the message ``Time adjustment clamped to +1 - second''. - - 3 Network secure mode - same as highly secure mode, plus IP - packet filter rules (see ipfw(8), ipfirewall(4) and pfctl(8)) - cannot be changed and dummynet(4) or pf(4) configuration - cannot be adjusted. - -Securelevels must be used in combination with careful system design and -application of protective mechanisms to prevent system configuration -files from being modified in a way that compromises the protections of -the securelevel variable upon reboot. diff --git a/usr.sbin/sysinstall/help/shortcuts.hlp b/usr.sbin/sysinstall/help/shortcuts.hlp deleted file mode 100644 index 9ec03d0e1ef53..0000000000000 --- a/usr.sbin/sysinstall/help/shortcuts.hlp +++ /dev/null @@ -1,117 +0,0 @@ -sysinstall now supports command-line "shortcuts" which can -often replace outdated commands, like pkg_manage. Multiple commands -can be invoked in sequence, and variables may be set on-the-fly to -customize the installation program's behavior in various ways. - -Syntax: - -/usr/sbin/sysinstall [var=value ..] [command ..] - -Where "var" can be one or more of: - -blanktime Screen blank time setting in seconds -bootManager Select boot manager: booteasy, standard or none -browserBinary Which doc browser to use (default: links) -browserPackage Which package to get browser from (default: links) -cpioVerbose How verbose to be with cpio: high or low -debug Extra debugging? -defaultrouter IP address of default route -disk Which disk to operate on (ad0, da0, etc). -domainname Domain name -editor Which screen editor to use -ftp Which FTP site/dir to use (URL ftp://site/dir/..) -ftpDirectory Root of the FreeBSD distribution tree on FTP server -ftpHost Which FTP hostname to use (overrides ftp variable) -ftpOnError Set to retry or abort -ftpPass Which password to use when logging into FTP server -ftpPort Which FTP port to use (default: 21) -ftpRetryCount How many times to retry a fetch operation -ftpUser Which username to use when logging into FTP server -gated Use gated instead of routed -geometry Geometry to use for selected disk ("cyl/hd/sec") -hostname Fully qualified domain name for host. -ifconfig_<iface> For each <iface> in network_devices -ipaddr IP address for this host's primary interface -nameserver IP address of name server -netmask Netmask for this host's primary interface -network_interfaces Which network interfaces to configure -nfs Full host:/path/ specification to NFS media -nfsHost Host portion of nfs path -nfsSecure Use NFS secure mount (-P flag) -nfs_server Configure this machine as an NFS server -noConfirm Don't ask for confirmation on non-fatal errors -ntpDate Which ntp clock synchronization server to use -pcnfsd Install the PCNFSD package -ports Path to the ports collection -releaseName Which FreeBSD release to install -rootSize Size of the root partition to create for Auto -routedflags Which flags to pass to routed, if enabled -serialSpeed How fast to run a SLIP/PPP connection -slowEthernetCard PC ethernet card is uncommonly slow -swapSize Size of the swap partition to create for Auto -tapeBlocksize Tape size in blocks -ufs Full path to UFS media directory -usrSize Size of the /usr partition to create for Auto -varSize Size of the /var partition to create for Auto - -And "command" can be one or more of: - -addGroup Add a new group to the system -addUser Add a new user to the system -configAnonFTP Configure system for anonymous FTP -configInetd Configure the inetd super-server -configNFSServer Configure host as an NFS server -configNTP Configure host as an NTP client -configPackages Browse / install packages -configRouter Configure a routing daemon -configUsers Add users and/or groups to the system -diskLabelCommit Write out any changed label information -diskLabelEditor Label/Newfs/Mount new or existing filesystems -diskPartitionEditor Partition a new or existing disk -diskPartitionWrite Write out any changed partition information -distExtractAll Extract all selected distributions -distReset Reset distribution information -distSetDeveloper Select developer distribution -distSetEverything Select all distributions -distSetKernDeveloper Select kernel developer distribution -distSetMinimum Select minimal distribution -distSetSrc Select source sub-distributions -distSetUser Select user distribution -distSetXDeveloper Select Xorg developer distribution -distSetXOrg Select Xorg sub-distributions -distSetXUser Select Xorg user distribution -docBrowser Browse documentation -installCommit Commit any pending installation operations -installExpress Express installation -installStandard Standard installation -installUpgrade Upgrade installation -mediaGetType Prompt for media type -mediaSetCDROM Select CDROM media -mediaSetCPIOVerbosity Prompt for CPIO verbosity -mediaSetDOS Select DOS media -mediaSetFTP Select FTP media -mediaSetFTPPassive Select FTP media in passive mode -mediaSetFTPUserPass Prompt for FTP username and password -mediaSetFloppy Select floppy media -mediaSetHTTP Select FTP media via HTTP proxy -mediaSetNFS Select NFS media -mediaSetTape Select tape media -mediaSetUFS Select UFS media -optionsEditor Go to options editor -tcpMenuSelect Configure TCP/IP networking - -Examples: - -/usr/sbin/sysinstall mediaSetFTP configPackages - -Selects an FTP site and then goes to the package configuration menu. - - -/usr/sbin/sysinstall disk=da0 diskPartitionEditor - -Invokes the disk partition editor on disk da0. - - -If /usr/sbin/sysinstall is linked to another filename, say -`/usr/local/bin/configPackages', then the basename will be used -as an implicit command name. diff --git a/usr.sbin/sysinstall/help/slice.hlp b/usr.sbin/sysinstall/help/slice.hlp deleted file mode 100644 index e9f3abb6a43bd..0000000000000 --- a/usr.sbin/sysinstall/help/slice.hlp +++ /dev/null @@ -1,57 +0,0 @@ -This is the Main Slice (``FDISK'' or PC-style Partition) Editor. - -Possible commands are printed at the bottom and the Master Boot Record -contents are shown at the top. You can move up and down with the -arrow keys and (C)reate a new slice whenever the highlighted -selection bar is over a slice whose type is marked as "unused." - -You are expected to leave this screen with at least one slice -marked "FreeBSD." Note that unlike Linux, you don't need to create -multiple FreeBSD FDISK partition entries for different things like -swap, file systems, etc. The usual convention is to create ONE -FreeBSD slice (FDISK partition) per drive and then subsection this slice -into swap and file systems with the Label editor. - -No actual changes will be made to the disk until you (C)ommit from the -Install menu or use the (W)rite option here! You're working with what -is essentially a copy of the disk label(s), both here and in the Label -Editor. - -If you want to use the entire disk for FreeBSD, type `A'. Slices will -be aligned to fictitious cylinder boundaries and space will be reserved -in front of the FreeBSD slice for a [future] possible boot manager. - -For the truly dedicated disk case, type `F'. You'll be asked whether or -not you wish to keep the disk (potentially) compatible with other -operating systems, i.e. the information in the FDISK table should be -kept valid. A truly dedicated disk can be achieved by selecting `No'. -In that case, all BIOS geometry considerations will no longer be in -effect and you can safely ignore any ``The detected geometry is -invalid'' warning messages you may later see. It is also not necessary -in this case to set a slice bootable or install an MBR boot manager as -both things are then irrelevant. The FreeBSD slice will start at -absolute sector 0 of the disk (so that FreeBSD's disk label is identical -to the Master Boot Record) and extend to the very last sector of the -disk medium. Needless to say, such a disk cannot have any sort of a -boot manager, `disk manager', or anything else that has to interact with -the BIOS. This option is therefore only considered safe for SCSI disks -and most IDE disks and is primarily intended for people who are going to -set up a dedicated FreeBSD server or workstation, not a typical `home PC'. - -If you select the default of `Yes' at the compatibility, slices will be -aligned to fictitious cylinder boundaries and space will be reserved -in front of the FreeBSD slice for a [future] possible boot manager. -This is pretty much equivalent to having chosen `A' originally. - -The flags field has the following legend: - - '=' -- This slice is properly aligned. - 'A' -- This slice is marked active. - 'R' -- This slice contains the root (/) filesystem - -If no slice is marked Active, you will need to either install -a Boot Manager (the option for which will be presented later in the -installation) or set one Active before leaving this screen. - -To leave the slice editor, type `Q'. - diff --git a/usr.sbin/sysinstall/help/tcp.hlp b/usr.sbin/sysinstall/help/tcp.hlp deleted file mode 100644 index 4c86198e8b5f8..0000000000000 --- a/usr.sbin/sysinstall/help/tcp.hlp +++ /dev/null @@ -1,42 +0,0 @@ -This screen allows you to set up your general network parameters -(hostname, domain name, DNS server, etc) as well as the settings for a -given interface (which was selected from the menu before this screen). - -PLIP/SLIP users - please read through to the end of this doc! - -You can move through the fields with the TAB, BACK-TAB and ENTER -keys. To edit a field, use DELETE or BACKSPACE. You may also use ^A -(control-A) to go to the beginning of the line, ^E (control-E) to go -to the end, ^F (control-F) to go forward a character, ^B (control-B) -to go backward one character, ^D (control-D) to delete the character -under the cursor and ^K (control-K) to delete to the end of the line. -Basically, the standard EMACS motion sequences. - -The "Extra options to ifconfig" field is kind of special (read: a -hack :-): - -Any valid options to ifconfig can be specified here, so if you need -to do something "special" to get your interface working, then here -is the place to do it. - -If you're running SLIP or PLIP, you also need to use it for specifying -the remote end of the link (simply type the foreign IP address in). -In the specific case where you're running PLIP with a Linux host peer -rather than a FreeBSD one, you also must add the "-link0" flag after the -foreign address. - -If you're dealing with an ethernet adaptor with multiple media -connectors (e.g. AUI, 10BT, 10B2, etc), you can use this field to -specify which one to use. Examples of valid strings include: - - "media 10base5/AUI" - Select the AUI port. - "media 10baseT/UTP" - Select the twisted pair port. - "media 10base2/BNC" - Select the BNC connector. - "media 100baseTX" - Select 100BaseT on a 100/10 dual adaptor. - -If you have a wireless interface and must specify arguments such as a -WEP key here, you may use something like: - - "wepmode on wepkey 0xFEEDFACE" - -When you're done with this form, select OK. diff --git a/usr.sbin/sysinstall/help/usage.hlp b/usr.sbin/sysinstall/help/usage.hlp deleted file mode 100644 index 268a946bc2230..0000000000000 --- a/usr.sbin/sysinstall/help/usage.hlp +++ /dev/null @@ -1,65 +0,0 @@ -HOW TO USE THIS SYSTEM -====================== - -[press the PageDown key to go to the next screen when you finish - reading this one] - -The following keys are recognized in most of the dialogs you'll -encounter during this installation: - -KEY ACTION ---- ------ -SPACE Select or toggle the current item. -ENTER Finish with a menu or item. -UP ARROW Move to previous item (or up, in a text display box). -DOWN ARROW Move to next item (or down, in a text display box). -TAB Move to next item or group. -RIGHT ARROW Move to next item or group (same as TAB). -SHIFT-TAB Move to previous item or group. -LEFT ARROW Move to previous item or group (same as SHIFT-TAB). -PAGE UP In text display boxes, scrolls up one page. -PAGE DOWN In text display boxes, scrolls down one page. -F1 Display associated help text. - -If you see small "^(-)" or "v(+)" symbols at the edges of a menu, it -means that there are more items above or below the current one that -aren't being shown (due to insufficient screen space). In text -display boxes, the amount of text above the current point will be -displayed as a percentage in the lower right corner. Using the -Up/Down arrow keys will cause the object to scroll by line. The -PageUp and PageDown keys will scroll by entire screens. - -Selecting OK in a menu will confirm whatever action it's controlling. -Selecting Cancel will cancel the operation and generally return you to -the previous menu. Use TAB to move the cursor around and select the -buttons. - -Most screens obey the Help key (F1) - USE IT! It generally offers useful -context-specific hints on what to do at each stage of the installation, -and if you're at all unsure about what to do at a given stage in the -installation, hit F1! - - -SPECIAL FEATURES: -================= - -It is possible to select a menu item by typing the first character of -its name, if unique. This will generally be an item number. - -The console driver contains a scroll-back buffer for reviewing things -that may have scrolled off the screen. To use scroll-back, press the -"Scroll Lock" key on your keyboard and use the arrow or Page Up/Page -Down keys to move through the saved text. To leave scroll-back mode, -press the Scroll Lock key again. This feature is most useful for -reading back through your boot messages (go ahead, try it now!) though -it's also useful when dealing with sub-shells or other "expert modes" -that don't use menus and tend to scroll their output off the top of -the screen. - -FreeBSD also supports multiple "virtual consoles" which you can use -in order to have several active sessions at once. Use ALT-F<n> to -switch between screens, where `F<n>' is the function key corresponding -to the screen you wish to see. By default, the system comes with 8 -virtual consoles enabled - you can enable more by editing the -/etc/ttys file and turning the "off" field to "on" in the relevant vty -entries (up to 12). diff --git a/usr.sbin/sysinstall/help/usermgmt.hlp b/usr.sbin/sysinstall/help/usermgmt.hlp deleted file mode 100644 index fbd7cac101a04..0000000000000 --- a/usr.sbin/sysinstall/help/usermgmt.hlp +++ /dev/null @@ -1,89 +0,0 @@ -These screens allow you to add groups and users to your system. - -You can move through the fields with the TAB, BACK-TAB and ENTER -keys. To edit a field, use DELETE or BACKSPACE. You may also use ^A -(control-A) to go to the beginning of the line, ^E (control-E) to go -to the end, ^F (control-F) to go forward a character, ^B (control-B) -to go backward one character, ^D (control-D) to delete the character -under the cursor and ^K (control-K) to delete to the end of the line. -Basically, the standard EMACS motion sequences. - -When you're done with this form, select OK. - -Many of the settings get reasonable defaults if you leave them blank. -The first time you have entered the name of the new group or user, the -system will show you what it would chose for most of these fields. -You are free to change them, of course. - - -User groups -=========== - -It's certainly almost generally a good idea to first create a new -group for your users. Common names for such a group are "users", or -even simply "other". Group names are used to control file access -permissions for users that belong to the same group. Several group -names are already used for system files. - -The numerical user or group IDs are often nothing you want to care for -explicitly. If you don't fill in these fields, the system will choose -reasonable defaults. However, these numbers (rather than the -associated names) are what the operating system actually uses to -distinguish users and groups -- hence they should normally be unique -to each person or group, respectively. - -(The initial membership list for a new group is currently -unimplemented, sorry.) - - -Users -===== - -The user's login ID is a short (up to 15 characters) alphanumeric ID -that the user must enter when logging into the system. It's often the -initial letters of the user's name, and commonly used in lower case. -It's also the local mail name for this user (though it's possible to -also set up more descriptive mail alias names later). - -The user's login group determines which group access rights the user -will initially get when logging in. If an additional list of groups is -provided which the user will become a member of, (s)he will also be -able to access files of those groups later without providing any -additional password etc. Except for the "wheel" case mentioned below, -the additional group membership list should normally not contain the -login group again. - -The user's password can also be set here, and should be chosen with -care - 6 or more characters, intermixing punctuation and numerics, and -*not* a word from the dictionary or related to the username is a good -password choice. - -Some of the system's groups have a special meaning. In particular, -members of group "wheel" are the only people who are later allowed to -become superuser using the command su(1). So if you're going to add a -new user who should later perform administrative tasks, don't forget -to add him to this group! (Well, ``he'' will most likely be yourself -in the very first place. :) - -Also, members of group "operator" will by default get permissions for -minor administrative operations, like performing system backups, or -shutting down the system -- without first becoming superuser! So, -take care when adding people to this group. - -The ``full name'' field serves as a comment only. It is also used by -mail front ends to determine the real name of the user, hence you -should actually fill in the first and last name of this user. By -convention, this field can be divided into comma-separated subfields, -where the office location, the work phone number, and the home phone -number follow the full name of the user. - -The home directory is the directory in the filesystem where the user -is being logged into, and where his personalized setup files (``dot -files'', since they usually begin with a `.' and are not displayed by -the ls(1) command by default) will be looked up. It is often created -under /usr/home/ or /home/. - -Finally, the shell is the user's initial command interpreter. The -default shell is /bin/sh, some users prefer the more historic -/bin/csh. Other, often more user-friendly and comfortable shells can -be found in the ports and packages collection. |
