1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
/*
* Copyright (c) 2004-2005 The Trustees of Indiana University and Indiana
* University Research and Technology
* Corporation. All rights reserved.
* Copyright (c) 2004-2005 The University of Tennessee and The University
* of Tennessee Research Foundation. All rights
* reserved.
* Copyright (c) 2004-2005 High Performance Computing Center Stuttgart,
* University of Stuttgart. All rights reserved.
* Copyright (c) 2004-2005 The Regents of the University of California.
* All rights reserved.
* Copyright (c) 2018 Cisco Systems, Inc. All rights reserved.
* $COPYRIGHT$
*
* Additional copyrights may follow
*
* $HEADER$
*/
/** @file:
* Creates an operating system-acceptable path name.
*
* The opal_os_path() function takes a variable number of string arguments and
* concatenates them into a path name using the path separator character appropriate
* to the local operating system. NOTE: the string returned by this function has been
* malloc'd - thus, the user is responsible for free'ing the memory used by
* the string.
*
* CRITICAL NOTE: The input variable list MUST be terminated by a NULL value. Failure
* to do this will cause the program to suffer a catastrophic failure - usually a
* segmentation violation or bus error.
*
* The function calls orte_sys_info() to ensure that the path separator character
* has been identified. If that value cannot be identified for some reason,
* the function will return a NULL value. Likewise, specifying a path name that
* exceeds the maximum allowable path name length on the local system will result
* in the return of a NULL value.
*
*
*/
#ifndef OPAL_OS_PATH_H
#define OPAL_OS_PATH_H
#include "opal_config.h"
#include <stdarg.h>
#include <stdio.h>
BEGIN_C_DECLS
/**
* @param relative A boolean that specifies if the path name is to be constructed
* relative to the current directory or as an absolute path. If no path
* elements are included in the function call, then the function returns
* "." for a relative path name and "<path separator char>" -
* the top of the directory tree - for an absolute path name.
* @param elem1,elem2,... A variable number of (char *)path_elements
* can be provided to the function, terminated by a NULL value. These
* elements will be concatenated, each separated by the path separator
* character, into a path name and returned.
* @retval path_name A pointer to a fully qualified path name composed of the
* provided path elements, separated by the path separator character
* appropriate to the local operating system. The path_name string has been malloc'd
* and therefore the user is responsible for free'ing the field.
*
* Note that the "relative" argument is int instead of bool, because
* passing a parameter that undergoes default argument promotion to
* va_start() has undefined behavior (according to clang warnings on
* MacOS High Sierra).
*/
OPAL_DECLSPEC char *opal_os_path(int relative, ...)
__opal_attribute_malloc__ __opal_attribute_sentinel__ __opal_attribute_warn_unused_result__;
/**
* Convert the path to be OS friendly. On UNIX this function will
* be empty.
*/
#define opal_make_filename_os_friendly(PATH) (PATH)
END_C_DECLS
#endif /* OPAL_OS_PATH_H */
|
