---
name: "hal_param_alias"
section: "3hal"
platform: "linux"
package: "linuxcnc-uspace-dev"
version: "1:2.9.4-2+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/hal_param_alias"
---

# hal\_param\_alias(3hal)

create an alternate name for a param

## NAME

hal\_param\_alias - create an alternate name for a param

## SYNTAX

int **hal\_param\_alias**(const char \***original\_name**, const char \***alias**);

## ARGUMENTS

- *original\_name*

  The original name of the param

- *alias*

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

## DESCRIPTION

A param may have two names: the original name (the one that was passed to a **hal\_param\_new** 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 param is renamed, to preserve compatibility with old versions.

## RETURN VALUE

Returns a HAL status code.

## SEE ALSO

**hal\_pin\_alias**(3)