/**************************************************************************** * libs/libc/grp/lib_getgrnamr.c * * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. The * ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the * License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations * under the License. * ****************************************************************************/ /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include "grp/lib_grp.h" /**************************************************************************** * Public Functions ****************************************************************************/ /**************************************************************************** * Name: getgrnam_r * * Description: * The getgrnam_r() function searches the group database for an entry with * a matching name and stores the retrieved group structure in the space * pointed to by grp. * * Input Parameters: * name - The name of the group to return a group structure for. * grp - Pointer to the space to store the retrieved group structure in. * buf - The string fields pointed to by the group struct are stored here. * buflen - The length of buf in bytes. * result - Pointer to the resulting group struct, or NULL in case of fail. * * Returned Value: * On success getgrnam_r returns 0 and sets *result to grp. If no match * is found, 0 is returned and *result is set to NULL. In case of failure * an error number is returned. * ****************************************************************************/ int getgrnam_r(FAR const char *name, FAR struct group *grp, FAR char *buf, size_t buflen, FAR struct group **result) { #ifdef CONFIG_LIBC_GROUP_FILE int ret; ret = grp_findby_name(name, grp, buf, buflen); if (ret != 1) { *result = NULL; return ret < 0 ? -ret : 0; } *result = grp; return 0; #else if (strcmp(name, ROOT_NAME)) { /* The only known group is 'root', which has a gid of 0. Thus, report * back that no match was found. */ *result = NULL; return 0; } return getgrbuf_r(ROOT_GID, ROOT_NAME, ROOT_PASSWD, grp, buf, buflen, result); #endif }