GETHOSTIDENT(3C) — Silicon Graphics

NAME

gethostident − get the host’s unique identification

SYNOPSIS

rv = gethostident(addr)
int rv;
char addr[64];

DESCRIPTION

gethostident returns the unique identifier for the given processor. This identifier is guaranteed to be unique within the Silicon Graphics workstation product family. This call is provided to support a rudimentary form of software protection.

Upon successful completion, the 64 bytes pointed to by addr will be filled with the identifier, and 0 will be returned. If the memory at addr is inaccessable, then -1 will be returned and errno will be set to EFAULT. If the machine is an IRIS 2000 or 3000 series workstation and the machine has no ethernet interface, -1 will be returned and errno will be set to ENODEV.

CAVEAT

gethostident is not suitable for serious software protection schemes. For the IRIS 2000 and 3000 series, the 64 bytes contain a constant pattern that is overwritten by the ethernet address of the IRIS’s original ethernet interface. If the IRIS is serviced and has its ethernet interface replaced, it is likely that the software protection schemes will disallow further use of the protected software.

NOTE

gethostident requires the 2.5 or 3.5 (or later) kernels.