diff options
Diffstat (limited to 'usr/src/man/man3picl')
18 files changed, 2276 insertions, 0 deletions
diff --git a/usr/src/man/man3picl/Makefile b/usr/src/man/man3picl/Makefile new file mode 100644 index 0000000000..e41dd929ad --- /dev/null +++ b/usr/src/man/man3picl/Makefile @@ -0,0 +1,54 @@ +# +# This file and its contents are supplied under the terms of the +# Common Development and Distribution License ("CDDL"), version 1.0. +# You may only use this file in accordance with the terms of version +# 1.0 of the CDDL. +# +# A full copy of the text of the CDDL should have accompanied this +# source. A copy of the CDDL is also available via the Internet +# at http://www.illumos.org/license/CDDL. +# + +# Copyright 2011, Richard Lowe + +include ../../Makefile.master + +MANSECT = 3picl + +MANFILES = libpicl.3picl \ + picl_find_node.3picl \ + picl_get_first_prop.3picl \ + picl_get_frutree_parent.3picl \ + picl_get_next_by_row.3picl \ + picl_get_node_by_path.3picl \ + picl_get_prop_by_name.3picl \ + picl_get_propinfo.3picl \ + picl_get_propinfo_by_name.3picl \ + picl_get_propval.3picl \ + picl_get_root.3picl \ + picl_initialize.3picl \ + picl_set_propval.3picl \ + picl_shutdown.3picl \ + picl_strerror.3picl \ + picl_wait.3picl \ + picl_walk_tree_by_class.3picl + +MANSOFILES = picl_get_next_by_col.3picl \ + picl_get_next_prop.3picl \ + picl_get_propval_by_name.3picl \ + picl_set_propval_by_name.3picl + +MANFILES += $(MANSOFILES) + +picl_get_next_prop.3picl := SOSRC = man3picl/picl_get_first_prop.3picl + +picl_get_next_by_col.3picl := SOSRC = man3picl/picl_get_next_by_row.3picl + +picl_get_propval_by_name.3picl := SOSRC = man3picl/picl_get_propval.3picl +picl_set_propval_by_name.3picl := SOSRC = man3picl/picl_set_propval.3picl + +.KEEP_STATE: + +include ../Makefile.man + +install: $(ROOTMANFILES) diff --git a/usr/src/man/man3picl/libpicl.3picl b/usr/src/man/man3picl/libpicl.3picl new file mode 100644 index 0000000000..18d4f0a540 --- /dev/null +++ b/usr/src/man/man3picl/libpicl.3picl @@ -0,0 +1,181 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH libpicl 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +libpicl \- PICL interface library +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR \|.\|.\|. ] \fIfile\fR \|.\|.\|. \fB-lpicl\fR [ \fIlibrary\fR \|.\|.\|. ] +#include <picl.h> +.fi + +.SH DESCRIPTION +.sp +.LP +The PICL interface is the platform-independent interface for clients to access +the platform information. The set of functions and data structures of this +interface are defined in the <\fBpicl.h\fR> header. +.sp +.LP +The information published through PICL is organized in a tree, where each node +is an instance of a well-defined PICL class. The functions in the PICL +interface allow the clients to access the properties of the nodes. +.sp +.LP +The name of the base PICL class is \fBpicl\fR, which defines a basic set of +properties that all nodes in the tree must possess. The following table shows +the property set of a \fBpicl\fR class node. +.sp + +.sp +.TS +tab() box; +cw(2.72i) |cw(2.78i) +lw(2.72i) |lw(2.78i) +. +Property NameProperty Value +_ +\fBname\fRThe name of the node +_ +\fB_class\fRThe PICL class name of the node +_ +\fB_parent\fRNode handle of the parent node +_ +\fB_child\fRNode handle of the first child node +_ +\fB_peer\fRNode handle of the next peer node +.TE + +.sp +.LP +Property names with a a leading underscore ('_') are reserved for use by the +PICL framework. The property names \fB_class\fR, \fB_parent\fR, \fB_child\fR, +and \fB_peer\fR are reserved names of the PICL framework, and are used to refer +to a node's parent, child, and peer nodes, respectively. A client shall access +a reserved property by their names only as they do not have an associated +handle. The property \fBname\fR is not a reserved property, but a mandatory +property for all nodes. +.sp +.LP +Properties are classified into different types. Properties of type integer, +unsigned-integer, and float have integer, unsigned integer, and floating-point +values, respectively. A \fBtable\fR property type has the handle to a table as +its value. A table is a matrix of properties. A \fBreference\fR property type +has a handle to a node in the tree as its value. A \fBreference\fR property may +be used to establish an association between any two nodes in the tree. A +\fBtimestamp\fR property type has the value of time in seconds since Epoch. A +\fBbytearray\fR property type has an array of bytes as its value. A +\fBcharstring\fR property type has a nul ('\0') terminated sequence of ASCII +characters. The size of a property specifies the size of its value in bytes. A +\fBvoid\fR property type denotes a property that exists but has no value. +.sp +.LP +The following table lists the different PICL property types enumerated in +\fBpicl_prop_type_t\fR. +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +Property TypeProperty Value +_ +\fBPICL_PTYPE_VOID\fRNone +_ +\fBPICL_PTYPE_INT\fRIs an integer +_ +\fBPICL_PTYPE_UNSIGNED_INT\fRIs an unsigned integer +_ +\fBPICL_PTYPE_FLOAT\fRIs a floating-point number +_ +\fBPICL_PTYPE_REFERENCE\fRIs a PICL node handle +.TE + +.SS "Reference Property Naming Convention" +.sp +.LP +Reference properties may be used by plug-ins to publish properties in nodes of +different classes. To make these property names unique, their names must be +prefixed by _\fIpicl_class_name\fR_, where \fIpicl_class_name\fR is the class +name of the node referenced by the property. Valid PICL class names are +combinations of uppercase and lowercase letters 'a' through 'z', digits '0' +through '9', and '-' (minus) characters. The string that follows +the '_\fIpicl_class_name\fR_' portion of a reference property name may be used to +indicate a specific property in the referenced class, when applicable. +.SS "Property Information" +.sp +.LP +The information about a node's property that can be accessed by PICL clients is +defined by the \fBpicl_propinfo_t\fR structure. +.sp +.in +2 +.nf +typedef struct { + picl_prop_type_t type; /* property type */ + unsigned int accessmode; /* read, write */ + size_t size; /* item size or + string size */ + char name[PICL_PROPNAMELEN_MAX]; +} picl_propinfo_t; +.fi +.in -2 + +.sp +.LP +The \fBtype\fR member specifies the property value type and the +\fBaccessmode\fR specifies the allowable access to the property. The plug-in +module that adds the property to the PICL tree also sets the access mode of +that property. The volatile nature of a property created by the plug-in is not +visible to the PICL clients. The \fBsize\fR member specifies the number of +bytes occupied by the property's value. The maximum allowable size of property +value is \fBPICL_PROPSIZE_MAX\fR, which is set to 512KB. +.SS "Property Access Modes" +.sp +.LP +The plug-in module may publish a property granting a combination of the +following access modes to the clients: +.sp +.in +2 +.nf +#define PICL_READ 0x1 /* read permission */ +#define PICL_WRITE 0x2 /* write permission */ +.fi +.in -2 + +.SS "Property Names" +.sp +.LP +The maximum length of the name of any property is specified by +\fBPICL_PROPNAMELEN_MAX\fR. +.SS "Class Names" +.sp +.LP +The maximum length of a PICL class name is specified by +\fBPICL_CLASSNAMELEN_MAX\fR. +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBlibpicl\fR(3LIB), \fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_find_node.3picl b/usr/src/man/man3picl/picl_find_node.3picl new file mode 100644 index 0000000000..678a967fd6 --- /dev/null +++ b/usr/src/man/man3picl/picl_find_node.3picl @@ -0,0 +1,119 @@ +'\" te +.\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_find_node 3PICL "5 Feb 2004" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_find_node \- find node with given property and value +.SH SYNOPSIS +.LP +.nf +cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-l\fR [ \fIlibrary\fR\&.\|.\|. ] +#include <picl.h> + +\fBint\fR \fBpicl_find_node\fR(\fBpicl_nodehdl_t\fR\fIrooth\fR, \fBchar *\fR\fIpname\fR, + \fBpicl_prop_type_t\fR \fIptype\fR, \fBvoid *\fR\fIpval\fR, \fBsize_t\fR \fIvalsize\fR, + \fBpicl_nodehdl_t *\fR\fIretnodeh\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_find_node()\fR function visits the nodes in the subtree under the +node specified by \fIrooth\fR. The handle of the node that has the property +whose name, type, and value matches the name, type, and value specified in +\fIpname\fR, \fIptype\fR, and \fIpval\fR respectively, is returned in the +location given by \fIretnodeh\fR. The \fIvalsize\fR argument specifies the size +of the value in \fIpval\fR. The first \fIvalsize\fR number of bytes of the +property value is compared with \fIpval\fR. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, 0 is returned. Otherwise a non-negative integer is +returned to indicate an error. +.sp +.LP +The value \fBPICL_NODENOTFOUND\fR is returned if no node that matches the +property criteria can be found. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 22n +.rt +General system failure +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_INVALIDHANDLE\fR\fR +.ad +.RS 22n +.rt +Invalid handle +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NODENOTFOUND\fR\fR +.ad +.RS 22n +.rt +Node not found +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTNODE\fR\fR +.ad +.RS 22n +.rt +Not a node +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_STALEHANDLE\fR\fR +.ad +.RS 22n +.rt +Stale handle +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +Interface StabilityEvolving +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBpicl_get_propinfo\fR(3PICL), \fBpicl_get_propval\fR(3PICL), +\fBpicl_get_propval_by_name\fR(3PICL), \fBpicl_get_prop_by_name\fR(3PICL), +\fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_get_first_prop.3picl b/usr/src/man/man3picl/picl_get_first_prop.3picl new file mode 100644 index 0000000000..ce8bbfdb76 --- /dev/null +++ b/usr/src/man/man3picl/picl_get_first_prop.3picl @@ -0,0 +1,166 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_get_first_prop 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_get_first_prop, picl_get_next_prop \- get a property handle of a node +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [ \fIlibrary\fR... ] +#include <picl.h> + +\fBint\fR \fBpicl_get_first_prop\fR(\fBpicl_nodehdl_t\fR \fInodeh\fR, + \fBpiclprop_hdl_t *\fR\fIproph\fR); +.fi + +.LP +.nf +\fBint\fR \fBpicl_get_next_prop\fR(\fBpicl_prophdl_t\fR \fIproph\fR, + \fBpicl_prophdl_t *\fR\fInextprop\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_get_first_prop()\fR function gets the handle of the first property +of the node specified by \fInodeh\fR and copies it into the location given by +\fIproph\fR. +.sp +.LP +The \fBpicl_get_next_prop()\fR function gets the handle of the next property +after the one specified by \fIproph\fR from the property list of the node, and +copies it into the location specified by \fInextprop\fR. +.sp +.LP +If there are no more properties, this function returns \fBPICL_ENDOFLIST\fR. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, \fB0\fR is returned. On failure, a non-negative +integer is returned to indicate an error. +.sp +.LP +\fBPICL_ENDOFLIST\fR is returned to indicate that there are no more properties. +.sp +.LP +\fBPICL_STALEHANDLE\fR is returned if the handle is no longer valid. This +occurs if the PICL tree was refreshed or reinitialized. +.sp +.LP +\fBPICL_INVALIDHANDLE\fR is returned if the specified handle never existed. +This error may be returned for a previously valid handle if the daemon was +brought down and restarted. When this occurs a client must revalidate any saved +handles. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTINITIALIZED\fR\fR +.ad +.RS 23n +.rt +Session not initialized +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NORESPONSE\fR\fR +.ad +.RS 23n +.rt +Daemon not responding +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTNODE\fR\fR +.ad +.RS 23n +.rt +Not a node +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTPROP\fR\fR +.ad +.RS 23n +.rt +Not a property +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_INVALIDHANDLE\fR\fR +.ad +.RS 23n +.rt +Invalid handle +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_STALEHANDLE\fR\fR +.ad +.RS 23n +.rt +Stale handle +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_ENDOFLIST\fR\fR +.ad +.RS 23n +.rt +End of list +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBpicl_get_prop_by_name\fR(3PICL), \fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_get_frutree_parent.3picl b/usr/src/man/man3picl/picl_get_frutree_parent.3picl new file mode 100644 index 0000000000..922ffbb800 --- /dev/null +++ b/usr/src/man/man3picl/picl_get_frutree_parent.3picl @@ -0,0 +1,102 @@ +'\" te +.\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_get_frutree_parent 3PICL "5 Feb 2004" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_get_frutree_parent \- get frutree parent node for a given device node +.SH SYNOPSIS +.LP +.nf +cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lpicl\fR [ \fIlibrary\fR\&.\|.\|. ] +#include <picl.h> + +\fBint\fR \fBpicl_get_frutree_parent\fR(\fBpicl_nodehdl_t\fR \fIdevh\fR, + \fBpicl_nodehdl_t *\fR\fIfrutreeh\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The devices under the \fB/platform\fR subtree of the PICLTREE are linked to +their FRU containers represented in the \fB/frutree\fR using PICL reference +properties. The \fBpicl_get_frutree_parent()\fR function returns the handle of +the node in the \fB/frutree\fR subtree that is the FRU parent or container of +the the device specified by the node handle, \fIdevh\fR. The handle is returned +in the \fIfrutreeh\fR argument. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, 0 is returned. Otherwise a non-negative integer is +returned to indicate an error. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 22n +.rt +General system failure +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_INVALIDHANDLE\fR\fR +.ad +.RS 22n +.rt +Invalid handle +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_PROPNOTFOUND\fR\fR +.ad +.RS 22n +.rt +Property not found +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_STALEHANDLE\fR\fR +.ad +.RS 22n +.rt +Stale handle +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +Interface StabilityEvolving +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBpicl_get_propinfo\fR(3PICL), \fBpicl_get_propval\fR(3PICL), +\fBpicl_get_propval_by_name\fR(3PICL), \fBpicl_get_prop_by_name\fR(3PICL), +\fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_get_next_by_row.3picl b/usr/src/man/man3picl/picl_get_next_by_row.3picl new file mode 100644 index 0000000000..249caf10b0 --- /dev/null +++ b/usr/src/man/man3picl/picl_get_next_by_row.3picl @@ -0,0 +1,153 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_get_next_by_row 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_get_next_by_row, picl_get_next_by_col \- access a table property +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [ \fIlibrary\fR... ] +#include <picl.h> + +\fBint\fR \fBpicl_get_next_by_row\fR(\fBpicl_prophdl_t\fR \fIproph\fR, + \fBpicl_prophdl_t *\fR\fIcolh\fR); +.fi + +.LP +.nf +\fBint\fR \fBpicl_get_next_by_col\fR(\fBpicl_prophdl_t\fR \fIproph\fR, + \fBpicl_prophdl_t *\fR\fIcolh\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_get_next_by_row()\fR function copies the handle of the property +that is in the next column of the table and on the same row as the property +\fIproph\fR. The handle is copied into the location given by \fIrowh\fR. +.sp +.LP +The \fBpicl_get_next_by_col()\fR function copies the handle of the property +that is in the next row of the table and on the same column as the property +\fIproph\fR. The handle is copied into the location given by \fIcolh\fR. +.sp +.LP +If there are no more rows or columns, this function returns the value +\fBPICL_ENDOFLIST\fR. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, \fB0\fR is returned. On failure, a non-negative +integer is returned to indicate an error. +.sp +.LP +\fBPICL_STALEHANDLE\fR is returned if the handle is no longer valid. This +occurs if the PICL tree was refreshed or reinitialized. +.sp +.LP +\fBPICL_INVALIDHANDLE\fR is returned if the specified handle never existed. +This error may be returned for a previously valid handle if the daemon was +brought down and restarted. When this occurs a client must revalidate any saved +handles. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTINITIALIZED\fR\fR +.ad +.RS 23n +.rt +Session not initialized +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NORESPONSE\fR\fR +.ad +.RS 23n +.rt +Daemon not responding +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTTABLE\fR\fR +.ad +.RS 23n +.rt +Not a table +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_INVALIDHANDLE\fR\fR +.ad +.RS 23n +.rt +Invalid handle +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_STALEHANDLE\fR\fR +.ad +.RS 23n +.rt +Stale handle +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_ENDOFLIST\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBpicl_get_propval\fR(3PICL), \fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_get_node_by_path.3picl b/usr/src/man/man3picl/picl_get_node_by_path.3picl new file mode 100644 index 0000000000..fe52c869c7 --- /dev/null +++ b/usr/src/man/man3picl/picl_get_node_by_path.3picl @@ -0,0 +1,149 @@ +'\" te +.\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_get_node_by_path 3PICL "5 Feb 2004" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_get_node_by_path \- get handle of node specified by PICL tree path +.SH SYNOPSIS +.LP +.nf +cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lpicl\fR [ \fIlibrary\fR\&.\|.\|. ] +#include <picl.h> + +\fBint\fR \fBpicl_get_node_by_path\fR(\fBconst char *\fR\fIpiclpath\fR, + \fBpicl_nodehdl_t *\fR\fInodeh\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_get_node_by_path()\fR function copies the handle of the node in the +PICL tree specified by the path given in \fIpiclpath\fR into the location +\fInodeh\fR. +.sp +.LP +The syntax of a PICL tree path is: +.sp +.in +2 +.nf +[<def_\fIpropname\fR>:]/[<\fIdef_propval\fR>[<\fImatch_cond\fR>]... ] +.fi +.in -2 + +.sp +.LP +where the <\fIdef_propname\fR> prefix is a shorthand notation to specify the +name of the property whose value is specified in <\fIdef_propval\fR>, and the +<\fImatch_cond\fR> expression specifies the matching criteria for that node in +the form of one or more pairs of property names and values such as +.sp +.in +2 +.nf +[@<address>][?<prop_name>[=<prop_val>]... ] +.fi +.in -2 + +.sp +.LP +where '@' is a shorthand notation to refer to the device address or a FRU's +location label and is followed by <\fIaddress\fR>, which gives the device +address or the location label. +.sp +.LP +For nodes under the \fB/platform\fR tree, the address value is matched with the +value of the property \fBbus-addr\fR, if it exists. If no \fBbus-addr\fR +property exists, the address value is matched with the value of the property +\fBUnitAddress\fR. To explicitly limit the comparison to \fBbus-addr\fR or +\fBUnitAddress\fR property, use the '?' notation described below. +.sp +.LP +For nodes under the \fB/frutree\fR tree, the <\fIaddress\fR> value is matched +with the value of the \fBLabel\fR property. +.sp +.LP +The expression following '?' specifies matching property name and value pairs, +where <\fIprop_name\fR> specifies the property name and <\fIprop_val\fR> +specifies the property value for properties not of type \fBPICL_PTYPE_VOID\fR. +The values for properties of type \fBPICL_PTYPE_TABLE\fR, +\fBPICL_PTYPE_BYTEARRAY\fR, and \fBPICL_PTYPE_REFERENCE\fR cannot be specified +in the <\fImatch_cond\fR> expression. +.sp +.LP +A \fB_class\fR property value of \fBpicl\fR can be used to match nodes of any +\fBPICL\fR classes. The class \fBpicl\fR is the base class of all the classes +in \fBPICL\fR. +.sp +.LP +All valid paths must begin at the root node denoted by '/'. +.sp +.LP +If no prefix is specified for the path, the prefix defaults to the \fBname\fR +property. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, 0 is returned. Otherwise a non-negative integer is +returned to indicate an error. +.sp +.LP +The value \fBPICL_NOTNODE\fR is returned if there is no node corresponding to +the specified path. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 19n +.rt +General system failure +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_INVALIDARG\fR\fR +.ad +.RS 19n +.rt +Invalid argument +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTNODE\fR\fR +.ad +.RS 19n +.rt +Not a node +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +Interface StabilityEvolving +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBpicl_get_propval_by_name\fR(3PICL), \fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_get_prop_by_name.3picl b/usr/src/man/man3picl/picl_get_prop_by_name.3picl new file mode 100644 index 0000000000..1a919c848e --- /dev/null +++ b/usr/src/man/man3picl/picl_get_prop_by_name.3picl @@ -0,0 +1,157 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_get_prop_by_name 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_get_prop_by_name \- get the handle of the property by name +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [ \fIlibrary\fR... ] +#include <picl.h> + +\fBint\fR \fBpicl_get_prop_by_name\fR(\fBpicl_nodehdl_t\fR \fInodeh\fR, \fBchar *\fR\fIname\fR, + \fBpicl_prophdl_t *\fR\fIproph\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_get_prop_by_name()\fR function gets the handle of the property of +node \fInodeh\fR whose name is specified in \fIname\fR. The handle is copied +into the location specified by \fIproph\fR. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, \fB0\fR is returned. On failure, a non-negative +integer is returned to indicate an error. +.sp +.LP +\fBPICL_PROPNOTFOUND\fR is returned if the property of the specified name does +not exist. +.sp +.LP +\fBPICL_RESERVEDNAME\fR is returned if the property name specified is one of +the reserved property names. +.sp +.LP +\fBPICL_STALEHANDLE\fR is returned if the handle is no longer valid. This +occurs if the PICL tree was refreshed or reinitialized. +.sp +.LP +\fBPICL_INVALIDHANDLE\fR is returned if the specified handle never existed. +This error may be returned for a previously valid handle if the daemon was +brought down and restarted. When this occurs a client must revalidate any saved +handles. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTINITIALIZED\fR\fR +.ad +.RS 23n +.rt +Session not initialized +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NORESPONSE\fR\fR +.ad +.RS 23n +.rt +Daemon not responding +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTNODE\fR\fR +.ad +.RS 23n +.rt +Not a node +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_PROPNOTFOUND\fR\fR +.ad +.RS 23n +.rt +Property not found +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_RESERVEDNAME\fR\fR +.ad +.RS 23n +.rt +Reserved property name specified +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_INVALIDHANDLE\fR\fR +.ad +.RS 23n +.rt +Invalid handle +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_STALEHANDLE\fR\fR +.ad +.RS 23n +.rt +Stale handle +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_get_propinfo.3picl b/usr/src/man/man3picl/picl_get_propinfo.3picl new file mode 100644 index 0000000000..e6e2ca9d16 --- /dev/null +++ b/usr/src/man/man3picl/picl_get_propinfo.3picl @@ -0,0 +1,134 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_get_propinfo 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_get_propinfo \- get the information about a property +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [ \fIlibrary\fR... ] +#include <picl.h> + +\fBint\fR \fBpicl_get_propinfo\fR(\fBpicl_prophdl_t\fR \fIproph\fR, + \fBpicl_propinfo_t *\fR\fIpinfo\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_get_propinfo()\fR function gets the information about the property +specified by handle \fIproph\fR and copies it into the location specified by +\fIpinfo\fR. The property information includes the property type, access mode, +size, and the name of the property as described on \fBlibpicl\fR(3PICL) manual +page. +.sp +.LP +The maximum size of a property value is specified by \fBPICL_PROPSIZE_MAX\fR. +It is currently set to 512KB. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, \fB0\fR is returned. On failure, a non-negative +integer is returned to indicate an error. +.sp +.LP +\fBPICL_STALEHANDLE\fR is returned if the handle is no longer valid. This +occurs if the PICL tree was refreshed or reinitialized. +.sp +.LP +\fBPICL_INVALIDHANDLE\fR is returned if the specified handle never existed. +This error may be returned for a previously valid handle if the daemon was +brought down and restarted. When this occurs a client must revalidate any saved +handles. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTINITIALIZED\fR\fR +.ad +.RS 23n +.rt +Session not initialized +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NORESPONSE\fR\fR +.ad +.RS 23n +.rt +Daemon not responding +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTPROP\fR\fR +.ad +.RS 23n +.rt +Not a property +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_INVALIDHANDLE\fR\fR +.ad +.RS 23n +.rt +Invalid handle specified +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_STALEHANDLE\fR\fR +.ad +.RS 23n +.rt +Stale handle specifie +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBlibpicl\fR(3PICL), \fBpicl_get_propval\fR(3PICL), +\fBpicl_get_propval_by_name\fR(3PICL), \fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_get_propinfo_by_name.3picl b/usr/src/man/man3picl/picl_get_propinfo_by_name.3picl new file mode 100644 index 0000000000..48bd6d6fa8 --- /dev/null +++ b/usr/src/man/man3picl/picl_get_propinfo_by_name.3picl @@ -0,0 +1,161 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_get_propinfo_by_name 3PICL "1 Aug 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_get_propinfo_by_name \- get property information and handle of named +property +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [\fIlibrary\fR... ] +#include <picl.h> + +\fBint\fR \fBpicl_get_propinfo_by_name\fR(\fBpicl_nodehdl_t\fR \fInodeh\fR, + \fBconst char *\fR\fIpname\fR, \fBpicl_propinfo_t *\fR\fIpinfo\fR, + \fBpicl_prophdl_t *\fR\fIproph\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_get_propinfo_by_name()\fR function copies the property information +of the property specified by \fIpname\fR in the node \fInodeh\fR into the +location given by \fIpinfo\fR. The handle of the property is returned in the +location \fIproph\fR. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, \fB0\fR is returned. On failure, a non-negative +integer is returned to indicate an error. +.sp +.LP +\fBPICL_PROPNOTFOUND\fR is returned if the property of the specified name does +not exist. +.sp +.LP +\fBPICL_RESERVEDNAME\fR is returned if the property name specified is one of +the reserved property names. +.sp +.LP +\fBPICL_STALEHANDLE\fR is returned if the handle is no longer valid. This +occurs if the PICL tree was refreshed or reinitialized. +.sp +.LP +\fBPICL_INVALIDHANDLE\fR is returned if the specified handle never existed. +This error may be returned for a previously valid handle if the daemon was +brought down and restarted. When this occurs a client must revalidate any saved +handles. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTINITIALIZED\fR\fR +.ad +.RS 23n +.rt +Session not initialized +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NORESPONSE\fR\fR +.ad +.RS 23n +.rt +Daemon not responding +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTNODE\fR\fR +.ad +.RS 23n +.rt +Not a node +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_PROPNOTFOUND\fR\fR +.ad +.RS 23n +.rt +Property not found +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_RESERVEDNAME\fR\fR +.ad +.RS 23n +.rt +Reserved property name specified +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_INVALIDHANDLE\fR\fR +.ad +.RS 23n +.rt +Invalid handle +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_STALEHANDLE\fR\fR +.ad +.RS 23n +.rt +Stale handle +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBpicl_get_propinfo\fR(3PICL), \fBpicl_get_prop_by_name\fR(3PICL), +\fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_get_propval.3picl b/usr/src/man/man3picl/picl_get_propval.3picl new file mode 100644 index 0000000000..432170bfd3 --- /dev/null +++ b/usr/src/man/man3picl/picl_get_propval.3picl @@ -0,0 +1,197 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_get_propval 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_get_propval, picl_get_propval_by_name \- get the value of a property +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [ \fIlibrary\fR... ] +#include <picl.h> + +\fBint\fR \fBpicl_get_propval\fR(\fBpicl_prophdl_t\fR \fIproph\fR, \fBvoid *\fR\fIvalbuf\fR, + \fBsize_t\fR \fInbytes\fR); +.fi + +.LP +.nf +\fBint\fR \fBpicl_get_propval_by_name\fR(\fBpicl_nodehdl_t\fR \fInodeh\fR, + \fBchar *\fR\fIpropname\fR, \fBvoid *\fR\fIvalbuf\fR, \fBsize_t\fR \fInbytes\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_get_propval()\fR function copies the value of the property +specified by the handle \fIproph\fR into the buffer location given by +\fIvalbuf\fR. The size of the buffer \fIvalbuf\fR in bytes is specified in +\fInbytes\fR. +.sp +.LP +The \fBpicl_get_propval_by_name()\fR function gets the value of property named +\fIpropname\fR of the node specified by handle \fInodeh\fR. The value is copied +into the buffer location given by \fIvalbuf\fR. The size of the buffer +\fIvalbuf\fR in bytes is specified in \fInbytes\fR. +.sp +.LP +The \fBpicl_get_propval_by_name()\fR function is used to get a reserved +property's value. An example of a reserved property is "\fB_parent\fR". Please +refer to \fBlibpicl\fR(3PICL) for a complete list of reserved property names. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, \fB0\fR is returned. On failure, a non-negative +integer is returned to indicate an error. +.sp +.LP +\fBPICL_PROPNOTFOUND\fR is returned if the property of the specified name does +not exist. +.sp +.LP +\fBPICL_PERMDENIED\fR is returned if the client does not have sufficient +permission to access the property. +.sp +.LP +\fBPICL_STALEHANDLE\fR is returned if the handle is no longer valid. This +occurs if the PICL tree was refreshed or reinitialized. +.sp +.LP +\fBPICL_INVALIDHANDLE\fR is returned if the specified handle never existed. +This error may be returned for a previously valid handle if the daemon was +brought down and restarted. When this occurs a client must revalidate any saved +handles. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTINITIALIZED\fR\fR +.ad +.RS 23n +.rt +Session not initialized +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NORESPONSE\fR\fR +.ad +.RS 23n +.rt +Daemon not responding +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_PERMDENIED\fR\fR +.ad +.RS 23n +.rt +Insufficient permission +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_VALUETOOBIG\fR\fR +.ad +.RS 23n +.rt +Value too big for buffer +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTPROP\fR\fR +.ad +.RS 23n +.rt +Not a property +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_PROPNOTFOUND\fR\fR +.ad +.RS 23n +.rt +Property node found +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTNODE\fR\fR +.ad +.RS 23n +.rt +Not a node +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_INVALIDHANDLE\fR\fR +.ad +.RS 23n +.rt +Invalid handle specified +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_STALEHANDLE\fR\fR +.ad +.RS 23n +.rt +Stale handle specified +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBlibpicl\fR(3PICL), \fBpicl_get_propinfo\fR(3PICL), \fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_get_root.3picl b/usr/src/man/man3picl/picl_get_root.3picl new file mode 100644 index 0000000000..f7b17f19d1 --- /dev/null +++ b/usr/src/man/man3picl/picl_get_root.3picl @@ -0,0 +1,82 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_get_root 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_get_root \- get the root handle of the PICL tree +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [ \fIlibrary\fR... ] +#include <picl.h> + +\fBint\fR \fBpicl_get_root\fR(\fBpicl_nodehdl_t *\fR\fInodehandle\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_get_root()\fR function gets the handle of the root node of the PICL +tree and copies it into the location given by \fInodehandle\fR. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, \fB0\fR is returned. On failure, a non-negative +integer is returned to indicate an error. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTINITIALIZED\fR\fR +.ad +.RS 23n +.rt +Session not initialized +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NORESPONSE\fR\fR +.ad +.RS 23n +.rt +Daemon not responding +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBpicl_initialize\fR(3PICL), \fBpicl_shutdown\fR(3PICL), \fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_initialize.3picl b/usr/src/man/man3picl/picl_initialize.3picl new file mode 100644 index 0000000000..e6ef6229ec --- /dev/null +++ b/usr/src/man/man3picl/picl_initialize.3picl @@ -0,0 +1,82 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_initialize 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_initialize \- initiate a session with the PICL daemon +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [ \fIlibrary\fR... ] +#include <picl.h> + +\fBint\fR \fBpicl_initialize\fR(\fBvoid\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_initialize()\fR function opens the daemon door file and initiates a +session with the PICL daemon running on the system. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, \fB0\fR is returned. On failure, this function +returns a non-negative integer, \fBPICL_FAILURE\fR. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTSUPPORTED\fR\fR +.ad +.RS 21n +.rt +Version not supported +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 21n +.rt +General system failure +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NORESPONSE\fR\fR +.ad +.RS 21n +.rt +Daemon not responding +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBpicl_shutdown\fR(3PICL), \fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_set_propval.3picl b/usr/src/man/man3picl/picl_set_propval.3picl new file mode 100644 index 0000000000..7f22e9a287 --- /dev/null +++ b/usr/src/man/man3picl/picl_set_propval.3picl @@ -0,0 +1,188 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_set_propval 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_set_propval, picl_set_propval_by_name \- set the value of a property to +the specified value +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [ \fIlibrary\fR... ] +#include <picl.h> + +\fBint\fR \fBpicl_set_propval\fR(\fBpicl_prophdl_t\fR \fIproph\fR, \fBvoid *\fR\fIvalbuf\fR, + \fBsize_t\fR \fInbytes\fR); +.fi + +.LP +.nf +\fBint\fR \fBpicl_set_propval_by_name\fR(\fBpicl_nodehdl_t\fR \fInodeh\fR, + \fBconst char *\fR\fIpname\fR, \fBvoid *\fR\fIvalbuf\fR, \fBsize_t\fR \fInbytes\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_set_propval()\fR function sets the value of the property specified +by the handle \fIproph\fR to the value contained in the buffer \fIvalbuf\fR. +The argument \fInbytes\fR specifies the size of the buffer \fIvalbuf\fR. +.sp +.LP +The \fBpicl_set_propval_by_name()\fR function sets the value of the property +named \fIpname\fR of the node specified by the handle \fInodeh\fR to the value +contained in the buffer \fIvalbuf\fR. The argument \fInbytes\fR specifies the +size of the buffer \fIvalbuf\fR. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, \fB0\fR is returned. On failure, a non-negative +integer is returned to indicate an error. +.sp +.LP +\fBPICL_PERMDENIED\fR is returned if the client does not have sufficient +permission to access the property. +.sp +.LP +\fBPICL_STALEHANDLE\fR is returned if the handle is no longer valid. This +occurs if the PICL tree was refreshed or reinitialized. +.sp +.LP +\fBPICL_INVALIDHANDLE\fR is returned if the specified handle never existed. +This error may be returned for a previously valid handle if the daemon was +brought down and restarted. When this occurs a client must revalidate any saved +handles. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTINITIALIZED\fR\fR +.ad +.RS 23n +.rt +Session not initialized +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NORESPONSE\fR\fR +.ad +.RS 23n +.rt +Daemon not responding +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_PERMDENIED\fR\fR +.ad +.RS 23n +.rt +Insufficient permission +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTWRITABLE\fR\fR +.ad +.RS 23n +.rt +Property is read-only +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_VALUETOOBIG\fR\fR +.ad +.RS 23n +.rt +Value too big +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTPROP\fR\fR +.ad +.RS 23n +.rt +Not a property +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTNODE\fR\fR +.ad +.RS 23n +.rt +Not a node +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_INVALIDHANDLE\fR\fR +.ad +.RS 23n +.rt +Invalid handle specified +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_STALEHANDLE\fR\fR +.ad +.RS 23n +.rt +Stale handle specified +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_shutdown.3picl b/usr/src/man/man3picl/picl_shutdown.3picl new file mode 100644 index 0000000000..797908d677 --- /dev/null +++ b/usr/src/man/man3picl/picl_shutdown.3picl @@ -0,0 +1,70 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_shutdown 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_shutdown \- shutdown the session with the PICL daemon +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [ \fIlibrary\fR... ] +#include <picl.h> + +\fBvoid\fR \fBpicl_shutdown\fR(\fBvoid\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_shutdown()\fR function terminates the session with the PICL daemon +and frees up any resources allocated. +.SH RETURN VALUES +.sp +.LP +The \fBpicl_shutdown()\fR function does not return a value. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTINITIALIZED\fR\fR +.ad +.RS 23n +.rt +Session not initialized +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBpicl_initialize\fR(3PICL), \fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_strerror.3picl b/usr/src/man/man3picl/picl_strerror.3picl new file mode 100644 index 0000000000..90e04b8083 --- /dev/null +++ b/usr/src/man/man3picl/picl_strerror.3picl @@ -0,0 +1,49 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_strerror 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_strerror \- get error message string +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile \fR\&.\|.\|. \fB-lpicl\fR [\fIlibrary \&.\|.\|.\fR] +#include <picl.h> + +\fBchar *\fR\fBpicl_strerror\fR(\fBint\fR \fIerrnum\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_strerror()\fR function maps the error number in \fIerrnum\fR to an +error message string, and returns a pointer to that string. The returned string +should not be overwritten. +.SH RETURN VALUES +.sp +.LP +The \fBpicl_strerror()\fR function returns \fINULL\fR if \fIerrnum\fR is +out-of-range. +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBlibpicl\fR(3PICL), \fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_wait.3picl b/usr/src/man/man3picl/picl_wait.3picl new file mode 100644 index 0000000000..ec31c9742d --- /dev/null +++ b/usr/src/man/man3picl/picl_wait.3picl @@ -0,0 +1,94 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_wait 3PICL "28 Mar 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_wait \- wait for PICL tree to refresh +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [ \fIlibrary\fR... ] +#include <picl.h> + +\fBint\fR \fBpicl_wait\fR(\fBint\fR \fIto_secs\fR); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_wait()\fR function blocks the calling thread until the PICL tree is +refreshed. The \fIto_secs\fR argument specifies the timeout for the call in +number of seconds. A value of \(mi1 for \fIto_secs\fR specifies no timeout. +.SH RETURN VALUES +.sp +.LP +The \fBpicl_wait()\fR function returns \fB0\fR to indicate that PICL tree has +refreshed. Otherwise, a non-negative integer is returned to indicate error. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTINITIALIZED\fR\fR +.ad +.RS 23n +.rt +Session not initialized +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NORESPONSE\fR\fR +.ad +.RS 23n +.rt +Daemon not responding +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_TIMEDOUT\fR\fR +.ad +.RS 23n +.rt +Timed out waiting for refresh +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBattributes\fR(5) diff --git a/usr/src/man/man3picl/picl_walk_tree_by_class.3picl b/usr/src/man/man3picl/picl_walk_tree_by_class.3picl new file mode 100644 index 0000000000..eca7cf2147 --- /dev/null +++ b/usr/src/man/man3picl/picl_walk_tree_by_class.3picl @@ -0,0 +1,138 @@ +'\" te +.\" Copyright (c) 2000, Sun Microsystems, Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH picl_walk_tree_by_class 3PICL "1 Aug 2000" "SunOS 5.11" "PICL Library Functions" +.SH NAME +picl_walk_tree_by_class \- walk subtree by class +.SH SYNOPSIS +.LP +.nf +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lpicl\fR [ \fIlibrary\fR... ] +#include <picl.h> + +\fBint\fR \fBpicl_walk_tree_by_class\fR(\fBpicl_nodehdl_t\fR \fIrooth\fR, + \fBconst char *\fR\fIclassname\fR, \fBvoid *\fR\fIc_args\fR, + \fBint (*\fR\fIcallback\fR)(picl_nodehdl_t \fInodeh\fR, \fBvoid *\fR\fIc_args\fR)); +.fi + +.SH DESCRIPTION +.sp +.LP +The \fBpicl_walk_tree_by_class()\fR function visits all the nodes of the +subtree under the node specified by \fIrooth\fR. The PICL class name of the +visited node is compared with the class name specified by \fIclassname\fR. If +the class names match, then the callback function specified by \fIcallback\fR +is called with the matching node handle and the argument provided in +\fIc_args\fR. If the class name specified in \fIclassname\fR is \fINULL\fR, +then the callback function is invoked for all the nodes. +.sp +.LP +The return value from the callback function is used to determine whether to +continue or terminate the tree walk. The callback function returns +\fBPICL_WALK_CONTINUE\fR or \fBPICL_WALK_TERMINATE\fR to continue or terminate +the tree walk. +.SH RETURN VALUES +.sp +.LP +Upon successful completion, \fB0\fR is returned. On failure, a non-negative +integer is returned to indicate an error. +.sp +.LP +\fBPICL_STALEHANDLE\fR is returned if the handle is no longer valid. This +occurs if the PICL tree was refreshed or reinitialized. +.sp +.LP +\fBPICL_INVALIDHANDLE\fR is returned if the specified handle never existed. +This error may be returned for a previously valid handle if the daemon was +brought down and restarted. When this occurs a client must revalidate any saved +handles. +.SH ERRORS +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTINITIALIZED\fR\fR +.ad +.RS 23n +.rt +Session not initialized +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NORESPONSE\fR\fR +.ad +.RS 23n +.rt +Daemon not responding +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_NOTNODE\fR\fR +.ad +.RS 23n +.rt +Not a node +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_INVALIDHANDLE\fR\fR +.ad +.RS 23n +.rt +Invalid handle specified +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_STALEHANDLE\fR\fR +.ad +.RS 23n +.rt +Stale handle specified +.RE + +.sp +.ne 2 +.mk +.na +\fB\fBPICL_FAILURE\fR\fR +.ad +.RS 23n +.rt +General system failure +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +tab() box; +cw(2.75i) |cw(2.75i) +lw(2.75i) |lw(2.75i) +. +ATTRIBUTE TYPEATTRIBUTE VALUE +_ +MT-LevelMT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBpicl_get_propval_by_name\fR(3PICL), \fBattributes\fR(5) |