| /* |
| * Copyright (c) 2000 Silicon Graphics, Inc. |
| * All Rights Reserved. |
| * |
| * This program is free software; you can redistribute it and/or |
| * modify it under the terms of the GNU General Public License as |
| * published by the Free Software Foundation. |
| * |
| * This program is distributed in the hope that it would be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| * GNU General Public License for more details. |
| * |
| * You should have received a copy of the GNU General Public License |
| * along with this program; if not, write the Free Software Foundation, |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA |
| */ |
| #ifndef _OPEN_FLAGS_H_ |
| #define _OPEN_FLAGS_H_ |
| |
| /*********************************************************************** |
| * This function attempts to convert open flag bits into human readable |
| * symbols (i.e. O_TRUNC). If there are more than one symbol, |
| * the <sep> string will be placed as a separator between symbols. |
| * Commonly used separators would be a comma "," or pipe "|". |
| * If <mode> is one and not all <openflags> bits can be converted to |
| * symbols, the "UNKNOWN" symbol will be added to return string. |
| * |
| * Return Value |
| * openflags2symbols will return the indentified symbols. |
| * If no symbols are recognized the return value will be a empty |
| * string or the "UNKNOWN" symbol. |
| * |
| * Limitations |
| * Currently (05/96) all known symbols are coded into openflags2symbols. |
| * If new open flags are added this code will have to updated |
| * to know about them or they will not be recognized. |
| * |
| * The Open_symbols must be large enough to hold all possible symbols |
| * for a given system. |
| * |
| ***********************************************************************/ |
| char *openflags2symbols( int, char *, int ); |
| |
| /*********************************************************************** |
| * This function will take a string of comma separated open flags symbols |
| * and translate them into an open flag bitmask. |
| * If any symbol is not valid, -1 is returned. On this error condition |
| * the badname pointer is updated if not NULL. badname will point |
| * to the beginning location of where the invalid symbol was found. |
| * string will be returned unchanged. |
| * |
| * A signal received while parsing string could cause the string to |
| * contain a NULL character in the middle of it. |
| * |
| ***********************************************************************/ |
| int parse_open_flags( char *, char ** ); |
| |
| #endif |