LinuxCNC Documentation

SYNOPSIS

#include <hal.h>

int hal_pin_alias(const char *original_name, const char *alias);

ARGUMENTS

original_name

The original name of the pin.

alias

The alternate name that may be used to refer to the pin, or NULL to remove any alternate name.

DESCRIPTION

A pin may have two names: the original name (the one that was passed to a hal_pin_new(3) function) and an alias.

Usually, aliases are for the convenience of users and should be created and destroyed via halcmd. However, in some cases it is sensible to create aliases directly in a component. These cases include the case where a pin is renamed, to preserve compatibility with old versions.

RETURN VALUE

Returns a HAL status code.

SEE ALSO