getcdf(3C)

NAME

getcdf(), hidecdf() − manipulate CDF path names

SYNOPSIS

#include <unistd.h>

char *getcdf(const char *path, char *buf, size_t size);

char *hidecdf(const char *path, char *buf, size_t size);

DESCRIPTION

getcdf() and hidecdf() manipulate path names possibly containing CDF (hidden directory) components.

getcdf() Returns a pointer to the expanded path matching the path name in path. The path argument can be a context dependent file (CDF) in which case a path name with all hidden directories expanded is returned. If path is not a CDF, a copy of the original path name is returned.

hidecdf() Returns a pointer to the simplified path corresponding to path. Any context-dependent components in the original path that match the current context (see context(5)) are removed from the resulting path.

The value of size must be at least one greater than the length of the path name to be returned.

If buf is not a NULL pointer, getcdf() and hidecdf() copy the expanded path name into array buf. If buf is a NULL pointer, getcdf() and hidecdf() obtain size bytes of space using malloc() (see malloc(3C)). In this case, the pointer returned by getcdf() and hidecdf() can be used as an argument in a subsequent call to free() (see malloc(3C)).

RETURN VALUE

Upon successful completion, getcdf() and hidecdf() return a pointer to the resulting path name. Otherwise, a value of NULL is returned and errno is set to indicate the error.

ERRORS

If either getcdf() or hidecdf() fails, it will set errno to one of the following values:

[ENOENT] A component of path does not exist.

[EACCES] Read or search permission is denied for one of the directories given in path.

[ENAMETOOLONG] size is not large enough to hold the resulting path.

EXAMPLES

#include <stdio.h>
char *path, *cdf, *getcdf();
int size;
...
if ((cdf = getcdf(path, NULL, size)) == NULL) {
perror("getcdf");
exit(1);
}
printf("%s\n", cdf);
free(cdf);

AUTHOR

getcdf() and hidecdf() were developed by HP.

Museum

Related Articles