---
name: "genders_getnodename"
section: "3"
platform: "linux"
package: "libgenders0-dev"
version: "1.27-3-3.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/genders_getnodename"
---

# genders\_getnodename(3)

get the current node name

## NAME

genders\_getnodename - get the current node name

## SYNOPSIS

**#include \<genders.h\>**

**int genders\_getnodename(genders\_t handle, char \*node, int len);**\

## DESCRIPTION

**genders\_getnodename()** retrieves the name of the node that the function is being called from.  The node name returned is the shortened hostname of the node and is stored in the buffer pointed to be *node*.  *len* should indicate the length of the buffer. The node returned by **genders\_getnodename()** is the shortened hostname of the node.

To avoid passing in a buffer that is not large enough to store the node name, [**genders\_getmaxnodelen**(3)](/genders_getmaxnodelen/3.md) should be used to determine the minimum buffer size that should be used. \

## RETURN VALUES

On success, 0 is returned.  On error, -1 is returned, and an error code is returned in *handle*.  The error code can be retrieved via [**genders\_errnum**(3)](/genders_errnum/3.md) , and a description of the error code can be retrieved via  [**genders\_strerror**(3)](/genders_strerror/3.md). Error codes are defined in genders.h.\

## ERRORS

- **GENDERS\_ERR\_NULLHANDLE**

  The *handle* parameter is NULL.  The genders handle must be created with [**genders\_handle\_create**(3)](/genders_handle_create/3.md).

- **GENDERS\_ERR\_NOTLOADED**

  [**genders\_load\_data**(3)](/genders_load_data/3.md) has not been called to load genders data.

- **GENDERS\_ERR\_OVERFLOW**

  The buffer pointed to by *node* is not large enough to store the node name.

- **GENDERS\_ERR\_PARAMETERS**

  An incorrect parameter has been passed in.

- **GENDERS\_ERR\_MAGIC**

  *handle* has an incorrect magic number.  *handle* does not point to a genders handle or *handle* has been destroyed by [**genders\_handle\_destroy**(3)](/genders_handle_destroy/3.md).\

## FILES

/usr/include/genders.h

## SEE ALSO

[libgenders(3)](/libgenders/3.md), [genders\_handle\_create(3)](/genders_handle_create/3.md), [genders\_load\_data(3)](/genders_load_data/3.md), [genders\_getmaxnodelen(3)](/genders_getmaxnodelen/3.md), [genders\_errnum(3)](/genders_errnum/3.md), [genders\_strerror(3)](/genders_strerror/3.md)