.\"##
.\" $XConsortium: p400,v 5.2 94/04/17 20:59:07 rws Exp $
.\"##
.\"## 
$XMCOPY
.\"## Copyright (c) 1990, 1991 by Sun Microsystems, Inc. 
.\"## 
.\"##                         All Rights Reserved
.\"## 
.\"## Permission to use, copy, modify, and distribute this software and its 
.\"## documentation for any purpose and without fee is hereby granted, 
.\"## provided that the above copyright notice appear in all copies and that
.\"## both that copyright notice and this permission notice appear in 
.\"## supporting documentation, and that the name of Sun Microsystems,
.\"## not be used in advertising or publicity 
.\"## pertaining to distribution of the software without specific, written 
.\"## prior permission.  
.\"## 
.\"## SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
.\"## INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\"## EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\"## CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\"## USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\"## OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\"## PERFORMANCE OF THIS SOFTWARE.
.TH "UNPOST ALL STRUCTURES" 3P "29 February 1991"
.SH NAME
UNPOST ALL STRUCTURES \- unpost all structures posted to the
specified workstation
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
punpost_all_structs ( ws_id )
Pint	ws_id;	\fIworkstation identifier\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, WSOP, *, *)
.SH DESCRIPTION
.SS Purpose
\s-2UNPOST ALL STRUCTURES\s+2 unposts all of the structures posted to a
specified workstation. Following \s-2UNPOST ALL STRUCTURES\s+2,
no structure networks remain eligible for display on the workstation.
The immediate effect of the function on the display surface will
depend on the workstation's display update state.
.SS C Input Parameter
.IP \fIws_id\fP
All structures are to be unposted from the workstation with this identifier.
.SS Execution
\s-2UNPOST ALL STRUCTURES\s+2 removes all the structures from the
\fItable of posted structures\fP on the specified workstation.
.LP
The unposted structures are not deleted from the Central Structure Store,
and may again be posted to this or another workstation.
No other workstations are affected.
.SH ERRORS
.IP 003
Ignoring function, function requires state (\s-2PHOP, WSOP, *, *\s+2)
.IP 054
Ignoring function, the specified workstation is not open
.IP 059
Ignoring function, the specified workstation does not have output capability
(i.e., the workstation category is neither \s-2OUTPUT\s+2, \s-2OUTIN\s+2, nor \s-2MO\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "POST STRUCTURE (3P)"
.SM "INQUIRE POSTED STRUCTURES (3P)"
.SM "CLOSE WORKSTATION (3P)"
.SM "UNPOST STRUCTURE (3P)"
.fi