User commands are now available as a user manual contributed
by Ian, G0VGS. You will find it in the directory
~clx_us/doc/user.
Users can have different attributes and rights. These user flags are stored together with other user specific information like name, QTH, page length etc. in the user database. For every callsign there is exactly one database entry.
As in AX.25 users can show up with up to 16 different SSIDs (-0...-15) one set of flags is stored for every SSID. Additionally, there is one more SSID (-16) for logging in from the system console.
The following flags exist for users. These flags may either be specified for a specifiy SSID or (if the speicific SSID flag is -1) as a default for all SSIDs.
flag attribute meaning
-1 default user has default permissions
1 login_denied user will be disconnected
2 priority_login user can login even if generally not permitted
4 login_ignored login is ignored (i.e. digipeater)
8 admin user is admin
16 superuser user is superuser
The login_denied attribute is equivalent
to PacketCluster's SET/LOCKOUT command.
The user will be disconnected immediately after his connect without
any warning or informal message.
The priority_login flag is reserved for special cases, where
login is generally not permitted. Normal users are then graciously
disconnected after being informed with a message saying that the
node is not available at this time. Users with the priority_login
flag set will still be able to connect.
With the Flexnet type of net nodes
making a connect every 10 minutes or so,
it was felt necessary to add the attribute login_ignored.
The station is logged
in but --- as it is generally not interested in receiving any information
but rather checking the link connection and measuring the time --- the
login will be ignored, i.e. nothing will be written to the user database
and no greeting message is produced by CLX for such users.
The admin flag is a permission
for users who have special tasks to do.
see section
admin for more
details.
The superuser flag gives a user even more rights.
see section
superuser for more
details.
The default flag has a special meaning giving the user the
default rights as defined in the default permission flag.
With these flags it is possible to easily administer users and give special attributes to some. Normal users will have -1 as their SSID permission flag and 0 as their default permission. That means, they have no special rights.
Some examples: To exclude a ``N0CALL'' (an often-heard pirate
call) with any SSID, put the default permission to
1 and leave the ssid permissions at -1.
To give admin and priority_login
rights to DL6RAI-13, change the ssid
permission to 10 for ``DL6RAI-13'' and leave all others at -1.
To set the name of ``DJ0ZY'' to ``Franta'' you
would use the ``-n'' option.
To ignore any logins from (RMNC, Flexnet) digipeaters, let's
say for DB0PV, put the default permission to 4. This will
make both Flexnet and CLX happy.
These flags and other attributes can be looked up and changed with
the us_adm program in the tools directory. To follow the examples
above you would issue the following commands:
$ us_adm -d 1 n0call
$ us_adm -p 10 dl6rai-13
$ us_adm -n Franta dj0zy
$ us_adm -n 4 db0pv
When you call us_adm with the -v flag and a callsign, the
program lists the user's entries in the database:
$ us_adm -v dl6rai
User Information for Station dl6rai
Name: Ben
Location: 48 34 n 012 12 e
QTH: Ergolding
First login: Sat Feb 03 09:14:08 1996 GMT
Last login: Thu Feb 29 16:47:32 1996 GMT
Pagelength: [default]
Language: german
Character Set:
Exit string: /exit
Address:
SSID-Permission Flags
------------------------------------------------------------
SSID: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Permissions: -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1
------------------------------------------------------------
Default Permission: 0 Flag for dl6rai-0: -1 [default]
$
With CLX version 2.03 us_adm
was reworked and can now also create new users.
So you it's not necessary to have
a user log in before you can change his
entries. Also the output is slightly different.
You can also erase users
with the ``-e'' switch (this
was just added for symmetry). Just call the
us_adm program without any parameters
to see what you can do. When a field
has blanks in it, you must surround
it with double quotes (``48 34 N 12 12 E'').
Privileged users may use the commands disconnect,
set/lockout and set/nolockout from within
CLX to either force a disconnect or even lock out the
callsign completely. Disconnecting and locking out a station
is quite a drastic measure and should be used only in an
emergency. Both actions are logged to io.log for later
investigation. With set/nolockout the ban on the
station previously locked out is being removed.
There is also a utility called monitor which can
be used to monitor user input and output. This is described
in section
log_monitor.
With the connect command you may trigger CLX to start
up a link connection and as such avoid lengthy idle times when
the CLX timers are running.