Back to home page

LXR

 
 

    


File indexing completed on 2025-05-11 08:24:26

0001 /* SPDX-License-Identifier: BSD-2-Clause */
0002 
0003 /**
0004  * @file
0005  *
0006  * @ingroup RTEMSScoreObject
0007  *
0008  * @brief This source file contains the implementation of
0009  *   _Objects_Get_by_name().
0010  */
0011 
0012 /*
0013  *  COPYRIGHT (c) 1989-2010.
0014  *  On-Line Applications Research Corporation (OAR).
0015  *
0016  * Redistribution and use in source and binary forms, with or without
0017  * modification, are permitted provided that the following conditions
0018  * are met:
0019  * 1. Redistributions of source code must retain the above copyright
0020  *    notice, this list of conditions and the following disclaimer.
0021  * 2. Redistributions in binary form must reproduce the above copyright
0022  *    notice, this list of conditions and the following disclaimer in the
0023  *    documentation and/or other materials provided with the distribution.
0024  *
0025  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
0026  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
0027  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
0028  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
0029  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
0030  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
0031  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
0032  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
0033  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
0034  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
0035  * POSSIBILITY OF SUCH DAMAGE.
0036  */
0037 
0038 #ifdef HAVE_CONFIG_H
0039 #include "config.h"
0040 #endif
0041 
0042 #include <rtems/score/objectimpl.h>
0043 
0044 #include <string.h>
0045 
0046 Objects_Control *_Objects_Get_by_name(
0047   const Objects_Information *information,
0048   const char                *name,
0049   size_t                    *name_length_p,
0050   Objects_Get_by_name_error *error
0051 )
0052 {
0053   size_t          name_length;
0054   size_t          max_name_length;
0055   Objects_Maximum maximum;
0056   Objects_Maximum index;
0057 
0058   _Assert( _Objects_Has_string_name( information ) );
0059   _Assert( _Objects_Allocator_is_owner() );
0060 
0061   if ( name == NULL ) {
0062     *error = OBJECTS_GET_BY_NAME_INVALID_NAME;
0063     return NULL;
0064   }
0065 
0066   name_length = strnlen( name, information->name_length + 1 );
0067   max_name_length = information->name_length;
0068   if ( name_length > max_name_length ) {
0069     *error = OBJECTS_GET_BY_NAME_NAME_TOO_LONG;
0070     return NULL;
0071   }
0072 
0073   if ( name_length_p != NULL ) {
0074     *name_length_p = name_length;
0075   }
0076 
0077   maximum = _Objects_Get_maximum_index( information );
0078 
0079   for ( index = 0; index < maximum; ++index ) {
0080     Objects_Control *the_object;
0081 
0082     the_object = information->local_table[ index ];
0083 
0084     if ( the_object == NULL )
0085       continue;
0086 
0087     if ( the_object->name.name_p == NULL )
0088       continue;
0089 
0090     if ( strncmp( name, the_object->name.name_p, max_name_length ) == 0 ) {
0091       return the_object;
0092     }
0093   }
0094 
0095   *error = OBJECTS_GET_BY_NAME_NO_OBJECT;
0096   return NULL;
0097 }