user_mod
<login> <expire> <time_limit> [session_limit] [priority] {class_limit}
<login> <+|-><SMARTTIME>|<SSMARTTIME>|<SMARTBOOT>|<SSMARTBOOT>| <IBOOT>|<ISMARTBOOT>|<TCSMARTBOOT>|<0-15>
<login> <tLeft>|<tLimit>|<credit>|<sLeft>|<sLimit> <+=|-=|=> <minutes>
<login> <cLeft>|<cLimit> <class> <+=|-=|=> <minutes>
<login> <bTx>|<bRx>|<bTxLimit>|<bRxLimit>|<bLimit>| <bStxLimit>|<bSrxLimit>|<bSlimit> <+=|-=|=> <bytes>
<login> priority = <priority>
<login> expire <+=|-=|=> <expire>
user_mod modifies an ACUA user record.
In the first usage, directly change the expiry date and time limits of a user. See user_addrec for a description of the arguments.
In the second usage, flags are modified. Flags are asserted with + and de-asserted with -, as you might expect. The flags 0-15 are user-defined flags (meaning that you define their meaning/purpose). Currently, user_foreach and user_renew are capable of basing their actions on the value of user-defined flags.
The system-defined flags are:
- SMARTTIME - Don't deduct time unless the system is busy.
- SSMARTTIME - Don't deduct session time unless the system is busy.
- TCSMARTTIME - Don't deduct time in the current time class unless the system is busy.
- SMARTBOOT - If overall time runs out, the user may still be allowed to stay on the system provided it is not busy.
- SSMARTBOOT - If session time runs out, the user may still be allowed to stay on the system provided it is not busy.
- TCSMARTBOOT - If the user runs out of time in the current time class, they may still be allowed to stay on the system provided it is not busy.
- IBOOT - If the user is idle for longer the number of minutes specified by the IdleBoot directive in acua.config, they may be kicked off the system.
- ISMARTBOOT - If the user has the IBOOT flag set and has been idle longer than IdleBoot minutes, they may still be allowed to stay on the system provided it is not busy.
NOTE: See the IdleBoot section in acua.config for a description of when the system is considered to be busy.
In the remaining usages, specific fields are modified. Fields may be incremented (+=), decremented (-=), or directly changed (=). The fields are:
priority - Priority
tLeft - Time left
tLimit - Time limit
credit - Time credit
sLeft - Session left
sLimit - Session limit
cLeft - Class time left
cLimit - Class time limit
bTx - Bytes uploaded
bRx - Bytes downloaded
bTxLimit - Limit on bytes uploaded
bRxLimit - Limit on bytes downloaded
bLimit - Limit on bytes transferred
bStxLimit - Session limit on bytes uploaded
bSrxLimit - Session limit on bytes downloaded
bSlimit - Session limit on bytes transferred
NOTE: If a user has a subscription, any changes to their record made with user_mod will be undone when the subscription expires.
Adam McKee
Last modified: Mon Apr 7 19:49:27 CST 1997