/**
 * @file rtems/posix/posixapi.h
 *
 * This include file defines the top level interface to the POSIX API
 * implementation in RTEMS.
 */

/*
 *  COPYRIGHT (c) 1989-2011.
 *  On-Line Applications Research Corporation (OAR).
 *
 *  The license and distribution terms for this file may be
 *  found in the file LICENSE in this distribution or at
 *  http://www.rtems.com/license/LICENSE.
 *
 *  $Id$
 */

#ifndef _RTEMS_POSIX_POSIXAPI_H
#define _RTEMS_POSIX_POSIXAPI_H

#include <rtems/config.h>
#include <rtems/score/object.h>

/**
 *  @brief Initialize POSIX API
 *
 *  This method is responsible for initializing each of the POSIX
 *  API managers.
 */
void _POSIX_API_Initialize(void);

/**
 *  @brief Queries the object identifier @a id for a @a name.
 *
 *  @param[in] information Object information.
 *  @param[in] name Zero terminated name string to look up.
 *  @param[out] id Pointer for identifier.  The pointer must be valid.
 *  @param[out] len Pointer for string length.  The pointer must be valid.
 *
 *  @retval 0 Successful operation.
 *  @retval EINVAL The @a name pointer is @c NULL or the @a name string has
 *  zero length.
 *  @retval ENAMETOOLONG The @a name string length is greater than or equal to
 *  @c NAME_MAX.
 *  @retval ENOENT Found no corresponding identifier.
 */
int _POSIX_Name_to_id(
  Objects_Information *information,
  const char          *name,
  Objects_Id          *id,
  size_t              *len
);

#endif
/* end of include file */