Node:set-client-version, Next:, Previous:lookup-conf, Up:Protocol Requests


set-client-version [69] (6) Recommended


        set-client-version [69] (( client-name      :   HOLLERITH;
                                   client-version   :   HOLLERITH ))
                -> ( );

This call is used to tell the server which client and which version of that client is being used. The name of the client is passed in client-name and the version in client-version. The information sent in this call is made available to other sessions through the get-client-name and get-client-version

calls. This call should be used exactly once per session.

The following names are currently registered:

elisp-client The famous CPU hog.
nilkom C++ experiment
tkom C++ experiment
getmail Postmaster
ttykom The one and second tty client by Linus
WinKOM Windows client
JySKom JSK Web Client

Example: 

        1 56
        =1 7
        2 69 11Helisp-client 4H0.45
        =2
        3 70 7
        =3 11Helisp-client
        4 71 7
        =4 4H0.45

In this example the who-am-i call is used to find the ID of the current session. Next, set-client-version is used to set the name of the client to "elisp-client" and the version to "0.45". The third call is to get-client-name , which returns the string just sent to the server. Finally get-client-version is used to retrieve the client version of session number 7, which is, as expected, the string "0.45".

Error codes

string-too-long
The string client-name or client-version is too long.
client-is-crazy
The client attempted to use this call more than once. The error-status is undefined.