diff options
Diffstat (limited to 'usr.sbin/sysinstall/help/options.hlp')
-rw-r--r-- | usr.sbin/sysinstall/help/options.hlp | 114 |
1 files changed, 63 insertions, 51 deletions
diff --git a/usr.sbin/sysinstall/help/options.hlp b/usr.sbin/sysinstall/help/options.hlp index c30180c..689c8cb 100644 --- a/usr.sbin/sysinstall/help/options.hlp +++ b/usr.sbin/sysinstall/help/options.hlp @@ -1,4 +1,5 @@ -The following options may be set from this screen: +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 @@ -14,82 +15,93 @@ NFS Slow: User is using a slow PC or ethernet card the PC from becoming swamped with data. -FTP Abort: On transfer failure, abort +Debugging: Turn on the extra debugging flag - This is pretty self-explanatory. If you're transfering from a - host that drops the connection or cannot provide a file, abort - the installation of that piece. + 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! -FTP Reselect: On transfer failure, ask for another host +Yes To All: Assume "Yes" answers to all non-critical dialogs - This is more useful to someone doing an interactive installation. - If the current host stops working, ask for a new ftp server to - resume the installation from. The install will attempt to pick - up from where it left off on the other server, if at all possible. + This flag should be used with caution. It will essentially + decide NOT to ask the user about any "boundry" 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. -FTP Active: Use "active mode" for standard FTP +FTP OnError: What to do when FTP transfer errors occur. - For all FTP transfers, use "Active" mode. This will not work - through firewalls, but will often work with older ftp servers - that do not support passive mode. If your connection hangs - with passive mode (the default), try active! + This is pretty self-explanatory. If you're transfering from a + host that drops the connection or cannot provide a file, you can + chose to Abort the connection, Retry the request (see next option) + or Reselect another FTP host, attempting to retry the request from + a new site. Pressing SPACE will toggle through these options. -FTP Passive: Use "passive mode" for firewalled FTP +FTP Retries: How many times to retry failing FTP requests. - For all FTP transfers, use "Passive" mode. This allows the user - to pass through firewalls that do not allow incoming connections - on random port addresses. + If FTP OnError is set to `retry', this is the number of times to + loop on a failing request before giving up. If you're talking to a + site that's chronically overloaded (like ours!) you may wish to + simply set this to some large value and go to lunch or something. - NOTE: ACTIVE AND PASSIVE MODES ARE NOT THE SAME AS A `PROXY' - CONNECTION, WHERE A PROXY FTP SERVER IS LISTENING ON A DIFFERENT - PORT! - In such situations, you should specify the URL as something like: +FTP username: Specify username and password instead of anonymous. - ftp://foo.bar.com:1234/pub/FreeBSD + 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. - Where "1234" is the port number of the proxy ftp server. +Tape Blocksize: Specify block size in 512 byte blocks of tape. -Debugging: Turn on the extra debugging flag + 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. - 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! +Extract Detail: How to show filenames on debug screen as they're extracted. -Yes To All: Assume "Yes" answers to all non-critical dialogs + 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". - This flag should be used with caution. It will essentially - decide NOT to ask the user about any "boundry" conditions that - might not constitute actual errors but may be warnings indicative - of other problems. +Release Name: Which release to attempt to load from installation media. -FTP userpass: Specify username and password instead of anonymous. + 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. - 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. + +Browser Package: Which package to load for an HTML browser. + + By default, this is set to lynx 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 -Clear: Clear All Option Flags +Media Type: Which media type is being used. - Reset all option flags back to their default values. + 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. ----- -Some of these items, like "FTP Active" or "FTP Passive", are actually -mutually-exclusive even though you can turn all of them on or off at -once. This is a limitation of the menuing system, and is compensated -for by checks that ensure that the various flags are not in conflict. -If you re-enter the Options menu again after leaving it, you'll see -the settings it's actually using after checking for any possible -conflicts. +Use Defaults: Use default values. + Reset all options back to their default values. |