getvfsaent(3TSOL)

NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | RETURN VALUES | FILES | SEE ALSO | NOTES

NAME

getvfsaent, getvfsafile- Get vfstab_adjunct file entry

SYNOPSIS

cc [flags...] file... -ltsol


#include <stdio.h> 
#include <tsol/vfstab_adjunct.h> 

int getvfsaent(FILE *fp, struct vfsaent **vp);
int getvfsafile(FILE *fp, struct vfsaent **vp, char *file);

DESCRIPTION

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.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWtsu
MT-Level	MT-Safe

RETURN VALUES

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:

ENOMEM

Memory cannot be allocated for an entry.

FILES

/etc/security/tsol/vfstab_adjunct

Attribute data file for mounting a file system in the Trusted Solaris environment.

SEE ALSO

Trusted Solaris 8 4/01 Reference Manual

vfstab_adjunct(4)

SunOS 5.8 Reference Manual

>attributes(5)

NOTES

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.

SunOS 5.8  Last Revised 1 Mar 1996

NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | RETURN VALUES | FILES | SEE ALSO | NOTES