Commands related to Users Access Control table

Revised for CPX 4.7.0.
Users Access Control table

Other commands

Users Access Control table top


A USER: Add User entry (Administrator)
A USER:username [par:val]

This command adds a new entry in the Users Access Control Table with "USER:" parameter equal to "username" and, eventually, it sets the indicated parameters to the specified values.

There can be up to 151 entries in the Users Access Control Table, each of one is unambiguously identified by the "USER:" parameter value. The table is alphabetically sorted on the base of the "USER:" parameter value and it is automatically resorted each time an entry is added or removed.

Valid "USER:" names are strings of up to 32 ASCII characters in the range [33..126]. Spaces are not allowed. Case is preserved.

There is no difference between lowercase and uppercase characters. For example the following strings "MyUser", "MYUSER", "myuser" are equivalent.

Two or more entries with the same "USER:" value cannot be defined. If an entry with the specified "USER:username" already exists in the table, the following message is generated "USER ALREADY EXISTS".

If the table is full and a new entry is going to be added, then an error message will be displayed "USERs ACCESS CONTROL TABLE IS FULL, COMMAND NOT EXECUTED"

Changes made on the Users Access Control Table are immediately active, they do not require any initialization command to be operative.

The "Not Saved (SAVE CONF)" message is displayed every time the table is modified but not saved with the SAVE CONF command.

If the Abilis CPX version, currently in use, does not support Users Service, the following message will be shown "USERs ACCESS CONTROL SERVICE NOT PRESENT".


C USER: Clear User entry (Administrator)
C USER:username

This command removes from the Users Access Control Table the entry identified by the specified user name value. Because the table is alphabetically sorted on the base of the "USER:" parameter value, it is automatically resorted as soon as the entry is removed.

The "USER:" parameter identifies unambiguously an entry in the system. Two or more entries with the same "USER:" value cannot be present in the same time in the table.

Valid "USER:" names are strings of up to 32 ASCII characters in the range [33..126]. Spaces are not allowed. Case is preserved.

There is no difference between lowercase and uppercase characters. For example the following strings "MyUser", "MYUSER", "myuser" are equivalent.

If the indicated user name does not match an already existing entry, the following message will be displayed "USER NOT PRESENT".

If the table is empty, the following message is generated: "USERs ACCESS CONTROL TABLE IS EMPTY".

Changes made on the Users Access Control Table are immediately active, they do not require any initialization command to be operative.

The "Not Saved (SAVE CONF)" message is displayed every time the table is modified but not saved with the SAVE CONF command.

If the Abilis CPX version, currently in use, does not support Users Service, the following message will be shown "USERs ACCESS CONTROL SERVICE NOT PRESENT".


D USER Display Users Access Control table summary (User)
D USER

This command shows the content of the Users Access Control Table in a synthetic format.

All the users defined with their most important configuration information are displayed.

Here is an example of the information shown by the command:

[12:18:37] ABILIS_CPX: D USER

- Not Saved (SAVE CONF) -------------------------------------------------------

USER:                             PASSWORD:  ENABLED: PPP: FTP: HTTP: 
------------------------------------------------------------------------------
admin                                        NO       YES  YES  YES    
Leo                                          YES      YES  YES  YES    
Konstantin                        *********  YES      NO   YES  YES   
test                                         YES      YES  NO   NO     

The "Not Saved (SAVE CONF)" message is displayed every time the table is modified but not saved with the SAVE CONF command.

For a detailed description of the information displayed, please refer to Configuration of Users Access Control table section of Users Access Control table.

If the Abilis CPX version, currently in use, does not support Users Service, the following message will be shown "USERs ACCESS CONTROL SERVICE NOT PRESENT".


D USER: Display User entry in synthetic format (User)
D USER:username

This command shows the Users Access Control Table entry identified by the "USER:username" in a synthetic format, i.e. the parameters of the services that are not enabled are omitted.

The "USER:" parameter identifies unambiguously an entry in the system. Two or more entries with the same "USER:" value cannot be present in the same time in the table.

Valid "USER:" names are strings of up to 32 ASCII characters in the range [33..126]. Spaces are not allowed. Case is preserved.

There is no difference between lowercase and uppercase characters. For example the following strings "MyUser", "MYUSER", "myuser" are equivalent.

If the indicated user name does not match an already existing entry, the following message will be displayed "USER NOT PRESENT".

Here is an example of the information shown by the command:

[15:45:19] ABILIS_CPX: D USER:Konstantin

Parameter    |Value                           
-------------------------------------------------------------------------------
USER:         Konstantin                              
PASSWORD:     *********
ENABLED:      YES
FTP:          YES
FTP-HOMEDIR:  /user/konstt/
FTP-PROT:     PLAIN,SSL
HTTP:         YES
-------------------------------------------------------------------------------

As it can be seen from the previous example, the parameters of the services that are not enabled are omitted.

For a detailed description of the displayed information, please refer to Configuration of Users Access Control table section of Users Access Control table.

If the Abilis CPX version, currently in use, does not support Users Service, the following message will be shown "USERs ACCESS CONTROL SERVICE NOT PRESENT".


D USERE Display Users Access Control table in extended format (User)
D USERE

This command shows the content of the Users Access Control Table in extended format, i.e. all the users defined with their full set of configuration information are displayed.

Here is an example of the information shown by the command:

[15:18:36] ABILIS_CPX: D USERE

- Not Saved (SAVE CONF) -------------------------------------------------------

Parameter:   |Value:
------------------------------------------------------------------------------
USER:         admin
PASSWORD:
ENABLED:      NO
PPP:          YES
PPP-AUTH:     CHAP
PPP-PO:       ANY
FTP:          YES
FTP-HOMEDIR:
FTP-PROT:     PLAIN,SSL
HTTP:         YES
------------------------------------------------------------------------------
USER:         test
PASSWORD:
ENABLED:      YES
PPP:          YES
PPP-AUTH:     ALL
PPP-PO:       541
FTP:          NO
FTP-HOMEDIR:
FTP-PROT:     PLAIN,SSL
HTTP:         NO
------------------------------------------------------------------------------

The "Not Saved (SAVE CONF)" message is displayed every time the table is modified but not saved with the SAVE CONF command.

For a detailed description of the information displayed, please refer to Configuration of Users Access Control table section of Users Access Control table.

If the Abilis CPX version, currently in use, does not support Users Service, the following message will be shown "USERs ACCESS CONTROL SERVICE NOT PRESENT".


D USERE: Display User entry in extended format (User)
D USERE:username

This command shows the Users Access Control Table entry identified by the "USER:username" in an extended format.

The "USER:" parameter identifies unambiguously an entry in the system. Two or more entries with the same "USER:" value cannot be present in the same time in the table.

Valid "USER:" names are strings of up to 32 ASCII characters in the range [33..126]. Spaces are not allowed. Case is preserved.

There is no difference between lowercase and uppercase characters. For example the following strings "MyUser", "MYUSER", "myuser" are equivalent.

If the indicated user name does not match an already existing entry, the following message will be displayed "USER NOT PRESENT".

Here is an example of the information shown by the command:

[15:18:38] ABILIS_CPX: D USERE:test

Parameter:   |Value:
------------------------------------------------------------------------------
USER:         test
PASSWORD:
ENABLED:      YES
PPP:          YES
PPP-AUTH:     ALL
PPP-PO:       541
FTP:          NO
FTP-HOMEDIR:
FTP-PROT:     PLAIN,SSL
HTTP:         NO
------------------------------------------------------------------------------

For a detailed description of the information displayed, please refer to Configuration of Users Access Control table section of Users Access Control table.

If the Abilis CPX version, currently in use, does not support Users Service, the following message will be shown "USERs ACCESS CONTROL SERVICE NOT PRESENT".


S USER: Set User entry (Administrator)
S USER:username par:val [par:val]

It sets to new values the parameters of the Users Access Control Table entry specified by "USER:username".

The "USER:" parameter identifies unambiguously an entry in the system. Two or more entries with the same "USER:" value cannot be present in the same time in the table.

Valid "USER:" names are strings of up to 32 ASCII characters in the range [33..126]. Spaces are not allowed. Case is preserved.

There is no difference between lowercase and uppercase characters. For example the following strings "MyUser", "MYUSER", "myuser" are equivalent.

If the indicated user name does not match an already existing entry, the following message will be displayed "USER NOT PRESENT".

If the table is empty, the following message is generated: "USERs ACCESS CONTROL TABLE IS EMPTY".

The parameters list, defined in the command, is left to right evaluated: the parameters are set one after the other, starting from the leftmost.

If a parameter is bad or its value out of the allowed range or if it is in conflict with the current value of any other parameter, then the command evaluation will terminate: all the parameters evaluated, before the error occurrence, will get the new value, the other ones will not be changed.

For a detailed description of the user's entry parameters, please refer to Configuration of Users Access Control table section of Users Access Control table.

Changes made on the Users Access Control Table are immediately active, they do not require any initialization command to be operative.

The "Not Saved (SAVE CONF)" message is displayed every time the table is modified but not saved with the SAVE CONF command.

If the Abilis CPX version, currently in use, does not support Users Service, the following message will be shown "USERs ACCESS CONTROL SERVICE NOT PRESENT".


F USER Find entry in Users Access Control table (User)
F USER:username PPP [port]
F USER:username FTP
F USER:username HTTP

It allows to verify the presence of a certain user in the Users Access Control Table by the specification of a "username" value.

Valid "USER:" names are strings of up to 32 ASCII characters in the range [33..126]. Spaces are not allowed. The search i case insensitive, i.e. there is no difference between lower case and uppercase characters.

In addition the command checks the acceptance of the specified user by the specified protocol/service:

The following example show possible results of the command:

[16:14:43] ABILIS_CPX: D USER:A

Parameter:   |Value:
------------------------------------------------------------------------------
USER:         admin
PASSWORD:      
ENABLED:      NO
PPP:          YES
PPP-AUTH:     CHAP
PPP-PO:       ANY
FTP:          YES
FTP-HOMEDIR:  
FTP-PROT:     PLAIN,SSL
HTTP:         YES
------------------------------------------------------------------------------
USER:         my_user
PASSWORD:      
ENABLED:      YES
PPP:          YES
PPP-AUTH:     CHAP
PPP-PO:       542
------------------------------------------------------------------------------
USER:         user_1
PASSWORD:      
ENABLED:      YES
PPP:          YES
PPP-AUTH:     CHAP
PPP-PO:       541
------------------------------------------------------------------------------
USER:         user_2
PASSWORD:      
ENABLED:      YES
PPP:          YES
PPP-AUTH:     PAP
PPP-PO:       541
------------------------------------------------------------------------------
USER:         user_3
PASSWORD:      
ENABLED:      YES
PPP:          YES
PPP-AUTH:     CHAP,PAP
PPP-PO:       542
------------------------------------------------------------------------------

[16:14:48] ABILIS_CPX: F USER:user_1 PPP 542 

USER NOT FOUND

[16:15:06] ABILIS_CPX: F USER:user_1 PPP 541

USER FOUND

[16:17:44] ABILIS_CPX: F USER:user_1 FTP 

USER NOT FOUND

If the Abilis CPX version, currently in use, does not support Users Service, the following message will be shown "USERs ACCESS CONTROL SERVICE NOT PRESENT".

printPrint this page