mas_put(3mas)
mas_put --
write metrics and metric registration information for provider use
Synopsis
cc [options] file -lmas
#include <mas.h>
int mas_put(void);
Description
The function mas_put writes metric registration information to
the metric registration file(s).
The file name(s) and permissions are
those that were previously passed to mas_init during MAS
provider initialization.
The first time mas_put is called, it
creates the metric registration file(s).
On subsequent invocations
the metric registration files are rewritten with the updated
registration information.
If a provider is using an internal metric segment within the metric
registration header file, or if dynamic registration was not
requested by calling mas_init with file names for the metric
registration table, metadata, and strings table, then
mas_put should not be called more than once.
Return values
On success, mas_put returns 0.
On failure, mas_put returns -1 and sets mas_errno to identify the error.
Errors
- MAS_USAGE - mas not initialized
-
mas_init was not called prior to calling mas_put.
- MAS_SYSERR - can't create mas file
-
The open system call failed.
- MAS_SYSERR - cannot malloc space for mas_buf
-
The malloc library call failed.
- MAS_SYSERR - write of mas header failed
-
The write system call failed.
- MAS_SYSERR - write of mas buf failed
-
The write system call failed.
- MAS_SYSERR - write of metric reg header failed
-
The write system call failed.
- MAS_SYSERR - can't create metric registration table file
-
The open system call failed.
- MAS_SYSERR - write of met reg table failed
-
The write system call failed.
- MAS_SYSERR - can't create strings file
-
The open system call failed.
- MAS_SYSERR - write of string table failed
-
The write system call failed.
- MAS_SYSERR - can't create metadata file
-
The open system call failed.
- MAS_SYSERR - write of meta data failed
-
The write system call failed.
- MAS_SYSERR - can't create metrics file
-
The open system call failed.
- MAS_SYSERR - can't seek to start of mas file
-
The lseek system call failed.
- MAS_SYSERR - write of mas header failed
-
The write system call failed.
References
Intro(3mas)
Notices
Future directions
Currently, mas_put does not notify active consumers that a change
in registration information has occurred.
This may be supported in a future release.
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.