NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | RETURN VALUES | FILES | SEE ALSO | NOTES
#include <stdio.h> #include <tsol/vfstab_adjunct.h>int getvfsaent(FILE *fp, struct vfsaent **vp);
getvfsaent() and getvfsafile() each fill in the structure pointed to by vp with the broken-out fields of a line in the /etc/security/tsol/vfstab_adjunct file. Each line in the file contains a vfstab_adjunct structure, declared in the <tsol/vfstab_adjunct.h> header:
struct vfsaent { char *vfsa_fsname; char *vfsa_attrs; };
The vfsa_fsname contains the full pathname of the file system as listed in vfstab(4). The vfsa_attrs points to the attribute string composed of keyword/value assignments of the form keyword=value separated by semicolons as described in vfstab_adjunct(4).
getvfsaent() returns a pointer to the next vfsaent structure in the file; so successive calls can be used to search the entire file. getvfsafile() searches the file referred to by fp until a mount point matching file is found.
On successful return, the locations referred to by *vp, *vp~>vfsa_fsname, and *vp~>vfsa_attrs have been separately allocated and may be independently released by calls to free(3C).
Note that these routines do not open, close, or rewind the file.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Availability | SUNWtsu |
MT-Level | MT-Safe |
If the next entry is successfully read by getvfsaent() or a match is found with getvfsafile(), 0 is returned. If an end-of-file is encountered on reading, these functions return -1. If an error is encountered, a value greater than 0 is returned. The possible error values are:
Memory cannot be allocated for an entry.
Attribute data file for mounting a file system in the Trusted Solaris environment.
These interfaces are uncommitted, which means that even though they are not expected to change, they may change between minor releases of the Trusted Solaris environment.
NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | RETURN VALUES | FILES | SEE ALSO | NOTES