A-32
A4
C.7
hostname
The hostname procedure is used to read/modify the hostname used by the Ede-
vice. The hostname is only applicable if a dynamic DNS service is available.
struct Hostname_Parms {
unsigned
int
action;
unsigned
int
length;
opaque
name<>;
};
struct Hostname_Resp {
unsigned
int
error;
unsigned int length;
opaque
name<>;
};
Hostname_Resp hostname (Hostname_Parms) = 7;
The action value determines whether the client wishes to execute a read of the
current setting, or a modification of the current value.
action = 0 = read of current value
action = 1 = modify current value
If the action value is other than 0 or 1, then an error value of 5 is returned.
If the RPC message is of insufficient length to satisfy the required length, an
error value of 1 is returned.
The name string must be a NULL terminated string with a 32-byte maximum
length (exclusive of the NULL). An error of 5 is returned and the Interface
Name is unchanged if the name field exceeds 32-bytes.
The returned Hostname_Resp structure will always contain the current hostname
value, irrespective of the error value.
error Meaning
0
No error
1
Syntax error
5
Parameter error