RTEMS 4.9.2 On-Line Library

Object Services OBJECT_SET_NAME - Set object name

RTEMS C User's Guide

27.4.4: OBJECT_SET_NAME - Set object name

CALLING SEQUENCE:

rtems_status_code rtems_object_set_name(
  rtems_id       id,
  const char    *name
);

DIRECTIVE STATUS CODES

RTEMS_SUCCESSFUL - name looked up successfully
RTEMS_INVALID_ADDRESS - invalid name pointer
RTEMS_INVALID_ID - invalid object id

DESCRIPTION:

This service sets the name of id to that specified by the string located at name.

NOTES:

This directive is strictly local and does not impact task scheduling.

If the object specified by id is of a class that has a string name, this method will free the existing name to the RTEMS Workspace and allocate enough memory from the RTEMS Workspace to make a copy of the string located at name.

If the object specified by id is of a class that has a thirty-two bit integer style name, then the first four characters in *name will be used to construct the name. name to the RTEMS Workspace and allocate enough memory from the RTEMS Workspace to make a copy of the string

RTEMS C User's Guide