@Database Config.guide @master Inet:docs/I-Net.guide @index "Inet:docs/Index.guide/main" @Author Michael B. Smith @$VER: Config.guide 6.5 (6.11.95) @Width 80 @SmartWrap @Node Main "Config" @{b}Config@{ub} @{b}Config@{ub} NAME @{b}Config@{ub} - Setup configuration for I-Net 225 TCP/IP Stack SYNOPSIS Config [-R=-M=RECONFIG] [-U=USER] [-H=HOSTNAME] [-V=value] DESCRIPTION The @{b}Config@{ub} utility is used to query certain internal parameters for the I-Net 225 TCP/IP Stack. It is also used to reconfigure those parameters. Both a menu and a batch interface are available via this command. Most parameters for I-Net 225 are stored in a file named @{b}INet:s/inet.config.@{ub} The @{b}RECONFIG@{ub} parameter causes the file to be re-read and the new values applied. The @{b}MENU@{ub} parameter causes a GUI interface to setting the values in the file to be executed (@{b}INet:c/WConfig@{ub}) and after it is complete, the file is re-read and the new values applied. When the @{b}USER@{ub} parameter is set, @{b}Config@{ub} will interrogate the TCP/IP stack to determine what the current user is (based on the current configuration) and set the global environment variable USER to the corresponding string for that uid. When the @{b}HOSTNAME@{ub} parameter is set, @{b}Config@{ub} will interrogate the TCP/IP stack to determine the current hostname (based on the current configuration) and set the global environment variable HOSTNAME to that value. Valid "values" for the @{b}-V@{ub} parameter are "host" and "user". When set, @{b}Config@{ub} performs the activities described above for each. The valid entries in @{b}INet:s/inet.config@{ub} and their types are: domain <256-char-string> gid gids host <256-char-string> tz tzname <8-char-string> uid umask usedns <"true"-or-"false"> user <32-char-string> Local syslog information is also configured in this file. The valid entries for that are: filepri <0-to-7> windowpri <0-to-7> syslogconsole <256-char-string> syslogfilename <256-char-string> Comment lines are allowed, and are any line which begins with a '#' or a ';' character. Empty lines are accepted as well. Each other line should consist of entry = value and if duplicate entries are present, the last one found is utilized. Some examples: usedns=true syslogconsole=CON:0/0/670/100/ My Syslog /CLOSE/WAIT/INACTIVE syslogfilename=INet:Logfile The @{b}domain@{ub} string should define the domain name for the system. This is used by DNS to determine the default domain for name searches. If @{b}domain@{ub} is not set, and the @{b}host@{ub} value (described below) contains a period, then @{b}domain@{ub} is initialized to the portion of the @{b}host@{ub} string, after the first period. If the user sets this value, it should not begin with a period. This value is available for programs to use via the getdomainname() API function. The @{b}gid@{ub} is a number which defines the primary group id for this user. On the Amiga, it is arbitrary, but should match with the @{b}user@{ub} and @{b}uid@{ub} that is specified. This is not used by I-Net 225, but is used by NFS. The value is available via the getgid() API function. @{b}gids@{ub} are additional group ids to which the user belongs to. Up to NGROUPS (currently 8) @{b}gids@{ub} lines may be present, each showing one additional group that the user belongs to. This is not used by I-Net 225, but is used by NFS. The value is available via the getgroups() API function. The @{b}host@{ub} parameter defines the hostname used for this computer when connected to the network. Depending on your local setup, this may be any of a single name, a fully-qualified domain name, or an IP address. This is used by I-Net 225, and it available via the gethostname() API function. The @{b}tz@{ub} parameter is an integer which defines the hours offset from GMT where this computer resides. This value is used to adjust time values in NFS and in the @{b}timed@{ub} daemon, but is not required by I-Net 225. It is available via the get_tz() API function. The @{b}tzname@{ub} parameter should contain the name of the timezone where this computer resides. This may not be longer than seven characters. This is not used anywhere, and is not currently available via any API function. The @{b}uid@{ub} parameter is a number defining the userid for this user. It should be consistent with the @{b}gid@{ub} and @{b}user@{ub} parameters, and should contain a value for a user present in @{b}INet:db/passwd@{ub}. This value is used in various places by I-Net 225, and is available via the getuid() API function. The @{b}umask@{ub} parameter sets the file creation protection mask. This should be in Unix format. This is used by NFS, and is available via the umask() and getumask() API functions. The @{b}usedns@{ub} flag controls whether a nameserver is queried for more information about computers which cannot be located in the @{b}INet:db/hosts@{ub} file. If set, additional information requests are sent to the nameserver(s) which may be specified in @{b}INet:db/resolv.conf@{ub}. The @{b}user@{ub} parameter defines the text-string representing @{b}uid@{ub}. It is not used by I-Net 225 directly, but is used by many applications. It should match the uid value in @{b}INet:db/passwd@{ub}. It is available via the getlogin() API function. The @{b}filepri@{ub} parameter defines the level of syslog messages which should be written to the logfile. All messages at that value, or less, are saved to @{b}syslogfilename@{ub}. The @{b}windowpri@{ub} parameter defines the level of syslog messages which should be displayed in a console window. All messages at that value, or less, are displayed in @{b}syslogconsole@{ub}. The @{b}syslogconsole@{ub} parameter defines the console window used to display system logging messages. An example can be found above. The default is a reasonable value for most system. The @{b}syslogfilename@{ub} parameter defines the name of the file used to store system logging messages. An example can be found above. The default is "RAM:syslog.dat". The <0-to-7> priorities for syslog are (lower numbers are more important): 0 Emergency - system is unusable 1 Alert - action must be taken immediately 2 Critical - action must be taken soon 3 Error - an error occurred 4 Warning - the user should be informed 5 Notice - normal but significant information 6 Information - may be interesting 7 Debug - helps authors debug programs Program authors determine these values when they write programs. SEE ALSO @{b}ConfigInet@{ub} @EndNode