Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ hstrerror

Media Vault

Software Library

Restoration Projects

Artifacts Sought

hstrerror

[Previous] [Contents] [Index] [Next]

hstrerror()

Get an error message string associated with the error return status

Synopsis:

#include <netdb.h>

const char* hstrerror( int err );

Arguments:

err
The error code that you want to get the message for. For more information, see h_errno.

Library:

libsocket

Use the -l socket option to qcc to link against this library.

Description:

The hstrerror() function gets an error message string associated with the error return status from network host-related functions.

Network host-related functions such as the following can return the error status:

  • gethostbyaddr(), gethostbyaddr_r()
  • gethostbyname(), gethostbyname_r()
  • res_query()
  • res_search()

You can check the external integer h_errno to see whether this is a temporary failure or an invalid or unknown host.

Returns:

A pointer to the message string affiliated with an error number.


Note: Don't modify the message string.

Classification:

Unix

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

h_errno, herror


[Previous] [Contents] [Index] [Next]

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026