m_setvalues_layout(3layout) [opensolaris man page]

m_setvalues_layout(3LAYOUT)				 Layout Service Library Functions			       m_setvalues_layout(3LAYOUT)

NAME

       m_setvalues_layout - set layout values of a LayoutObject

SYNOPSIS

       cc [ flag... ] file... -llayout [ library... ]
       #include <sys/layout.h>

       int m_setvalues_layout(LayoutObject layout_object,
	    const LayoutValues values, int *index_returned);

DESCRIPTION

       The m_setvalues_layout() function changes the layout values of a LayoutObject.

       The layout_object argument specifies a LayoutObject returned by the m_create_layout(3LAYOUT) function.

       The values argument specifies the list of layout values that are to be changed. The values are written into the LayoutObject and may affect
       the behavior of subsequent layout functions.  Some layout values do alter internal states maintained by a LayoutObject.

       The m_setvalues_layout() function can be implemented as a macro that evaluates the first argument twice.

RETURN VALUES

       Upon successful completion, the requested layout values are set and 0 is returned. Otherwise -1 is returned and errno is  set  to  indicate
       the  error.  If	any  value  cannot be set, none of the layout values are changed and the (zero-based) index of the first value causing the
       error is returned in index_returned.

ERRORS

       The m_setvalues_layout() function may fail if:

       EINVAL	 The layout value specified by index_returned is unknown, its value is invalid, or the layout_object argument is invalid.

       EMFILE	 There are {OPEN_MAX} file descriptors currently open in the calling process.

USAGE

       Do not use expressions with side effects such as auto-increment or auto-decrement within the first  argument  to  the  m_setvalues_layout()
       function.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       m_create_layout(3LAYOUT), attributes(5), standards(5)

SunOS 5.11							    7 Aug 2006					       m_setvalues_layout(3LAYOUT)

m_getvalues_layout(3LAYOUT)				 Layout Service Library Functions			       m_getvalues_layout(3LAYOUT)

NAME

       m_getvalues_layout - query layout values of a LayoutObject

SYNOPSIS

       cc [ flag... ] file... -llayout [ library... ]
       #include <sys/layout.h>

       int m_getvalues_layout(const LayoutObject
	    layout_object, LayoutValues values, int *index_returned);

DESCRIPTION

       The m_getvalues_layout() function queries the current setting of layout values within a LayoutObject.

       The layout_object argument specifies a LayoutObject returned by the m_create_layout(3LAYOUT) function.

       The  values  argument  specifies  the  list of layout values that are to be queried. Each value element of a LayoutValueRec must point to a
       location where the layout value is stored. That is, if the layout value is of type T, the argument must be  of  type  T*.  The  values  are
       queried from the LayoutObject and represent its current state.

       It  is  the user's responsibility to manage the space allocation for the layout values queried. If the layout value name has QueryValueSize
       OR-ed to it, instead of the value of the layout value, only its size is returned. The caller can use this option to determine the amount of
       memory needed to be allocated for the layout values queried.

RETURN VALUES

       Upon successful completion, the m_getvalues_layout() function returns 0. If any value cannot be queried, the index of the value causing the
       error is returned in index_returned, -1 is returned and errno is set to indicate the error.

ERRORS

       The m_getvalues_layout() function may fail if:

       EINVAL	 The layout value specified by index_returned is unknown, its value is invalid, or the layout_object argument is invalid.  In  the
		 case of an invalid layout_object argument, the value returned in index_returned is -1.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       m_create_layout(3LAYOUT), attributes(5), standards(5)

SunOS 5.11							    7 Aug 2006					       m_getvalues_layout(3LAYOUT)