Node:modify-system-info, Next:, Previous:get-info, Up:Protocol Requests


modify-system-info [95] (10) Recommended


 modify-system-info [95] (( items-to-delete : ARRAY Aux-No;
                            items-to-add    : ARRAY Aux-Item-Input ))
          -> ( );

This call modifies the aux-item list of the server information (which can be retrieved using get-info.) It only succeeds when issued by a person with the admin bit set and privileges enabled.

The items in items-to-delete are removed, and the items in items-to-add are added. This call is atomic; either all deletions or additions succeeded, or none of them is made.

Error codes

login-first
Login requires before issuing this call.
permission-denied
Admin bit not set or privileges not enabled.
illegal-aux-item
Attempt to create an invalid aux item.
aux-item-permission
Attempt to delete an undeletable item or create an uncreateable item.