--- name: "tcpquota.cf" section: "5" platform: "linux" package: "tcpquota" version: "1.6.15-5" release: "Debian 2.1 (Slink)" platforms: ["linux"] url: "https://new.carta.tech/tcpquota.cf" --- # tcpquota.cf(5) The configuration file for the TCPQuota programs. ## NAME **tcpquota.cf** - The configuration file for the TCPQuota programs. ## SYNOPSIS /etc/tcpquota/tcpquota.cf ## DESCRIPTION **tcpquota.cf** contains various pieces of information used by the TCPQuota programs. It is used by the daemon,\ **[tcpquotad(8)](/tcpquotad/8.md)** to find out to which mSQL database to store it's values in, and which users/hosts that is grouped together. It is used by most of the program suite, to find out **where** to find the mSQL server. ### Variables - PROTOCOL What kind of network protocol are we using? Availible choises are **PPP** or **ISDN.** When using *PPP,* it checks for a link by checking if there is a route on *ppp0.* and if we are using *ISDN,* it checks the file **/dev/isdninfo** which contains the status of the *ISDN* channels. - **Example:** *PROTOCOL=ISDN* - LOC\_ADDR Only used if we are using *ISDN* as network protocol, ignored if we are using *PPP* since when using PPP, one usually have a dynamic IP address...\ This is the address on the local side of the link (our address). - **Example:** *LOC\_ADDR=195.100.20.3* - REM\_ADDR Only used if we are using *ISDN* as network protocol, ignored if we are using *PPP* since when using PPP, one usually have a dynamic IP address...\ This is the address on the remote side of the link (the ISP's address). - **Example:** *REM\_ADDR=195.100.170.187* - SERVER This is the machine/host which is running the mSQL server, could be IP address or FQDN address. - **Example:** *SERVER=42.42.40.42*\ - **Example:** *SERVER=stalin.ccw.se* - CHECK\_REMOTE Should we check if we have remote connects (if someone is connecting **to** us, via telnet/ssh/rlogin etc)? This is a boolean value, true/false, 1/0 or yes/no - **Example:** *CHECK\_REMOTE=yes* - CHECK\_FTP Should we check if we have remote connects (if someone is connecting **to** us, via FTP)? This is a boolean value, true/false, 1/0 or yes/no - **Example:** *CHECK\_FTP=yes* - CHECK\_MASQ Should we check any computers which is masqueraded? This is a boolean value, true/false, 1/0 or yes/no. - **Example:** *CHECK\_MASQ=yes* - GROUPS With this variable, one can group computers (masqueraded) together, and open each group separate. For example, we have three rooms, with eight computers in each room and one teacher in each. If the teacher have a class in 'Using the Internet safely', and 'net time is included in the class fee, he/she wants to be able to open only that room for free 'net access. We then write (in the config file) the folloing: - GROUPS=GROUP1 GROUP2 GROUP3\ GROUP1=machiavelli kaddaffi karadicz semin khomeini muboto chauchesko baptista\ GROUP2=idiamin saddam mao lenin adolf kim pinochet castro\ GROUP3=cleon indbur loris wienis asper stettin gilmer stannell\ - This would mean that if the teacher is sitting on khomeini, and runs the program **[openfw(8)](/openfw/8.md),** He or she will open the following computers for free 'net access: *machiavelli,*kaddaffi,*karadicz,*semin,*khomeini,*muboto,*chauchesko* and *baptista.* - USERS This is the same as the **GROUPS** variable, only for user group allowed free 'net access - **Example:** *USERS=free turbo* - LANGUAGE What language we should use for the output. So far the programs have only been translated to Swedish and English (with a lot of spelling errors in the English version, I reckon :) - **Example:** *LANGUAGE=svenska* - MONEY\_VALUE What type of money we are using. - **Example:** *MONEY\_VALUE=SEk* - LOGFILE Where should we write our log file? - **Example:** *LOGFILE=/var/log/tcpquotad.log* - PIDFILE Where should we write our pid? - **Example:** *PIDFILE=/var/run/tcpquota.pid* - NOQUOTAFILE What file should we output to a user if he/she have gone below the minimum amount of allowed quota? - **Example:** *NOQUOTAFILE=/etc/msgs/no-tcp-allowed* - MIN\_QUOTA What is the minimum amount of quota, before we 'cut the link' for the user? If the value is 0, then the user can not owe you anything, but if the value is, say, 200, then the user can owe you a maximum of 200 \. - **Example:** *MIN\_QUOTA=150* - RATE\_QUOTA How much does the one minute cost under the cheap tarrif. In Sweden we have two different tarrifs, high and low. - **Example:** *RATE\_QUOTA=0.1* - MIN\_UID Above what UID should we care about connects? If we set zero (0) here, even root have to pay... This may not a good option, since the mailer daemon, and the news daemon etc might do outside connects. We are working on a way to make each user pay for it's own mail connect, but we have yet to find out a way... - **Example:** *MIN\_UID=1000* - TICS Number of tcpquotad passes an 'out' session can be unconnected to the database before tcpquotad gets tired of waiting and throws it out. It is modified in relation to 'tcpquotad.PERIOD'... - **Example:** *TICS=10* - HIGH\_START - HIGH\_STOP When does the low rate resp high rate begins and ends? (Hour of the day, in Sweden that is between 08.00 and 18.00 weekdays, and low rate on weekends) - **Example:** *HIGH\_START=08*\ - **Example:** *HIGH\_TOP=18* - HIGH\_RATE - LOW\_RATE Weight for each second under resp period. What is the difference between high and low rate? (In Sweden the high rate is twice as expensive as the low rate) - **Example:** *HIGH\_RATE=2*\ - **Example:** *LOW\_RATE=1* - tcpquotad.PERIOD How often should the main daemon check for connections? We have discovered, that on a 386 one might need to have a number higher than 30 (seconds), so that the machine is not **to** heavily loaded, and on a Pentium, one can check every five seconds without any problems... - **Example:** *tcpquotad.PERIOD=5*\ - **Example:** *tcpquotad.PERIOD=30* - tcp\_masq\_openhost.PERIOD How often should the 'log daemon' **tcpquotatop (1)** check for connections? - **Example:** *tcp\_masq\_openhost.PERIOD=10*\ - **Example:** *tcp\_masq\_openhost.PERIOD=30* ## FILES /etc/tcpquota/tcpquota.cf ## SEE ALSO **tcpquotad (8), tcpquotatop (1)** ## AUTHOR Turbo Fredriksson, \\ Martin Budsjoe, \