19b50d902SRodney W. Grimes.\" Copyright (c) 1992, 1993 29b50d902SRodney W. Grimes.\" The Regents of the University of California. All rights reserved. 39b50d902SRodney W. Grimes.\" 49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without 59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions 69b50d902SRodney W. Grimes.\" are met: 79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright 89b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer. 99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright 109b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer in the 119b50d902SRodney W. Grimes.\" documentation and/or other materials provided with the distribution. 12fbbd9655SWarner Losh.\" 3. Neither the name of the University nor the names of its contributors 139b50d902SRodney W. Grimes.\" may be used to endorse or promote products derived from this software 149b50d902SRodney W. Grimes.\" without specific prior written permission. 159b50d902SRodney W. Grimes.\" 169b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 179b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 189b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 199b50d902SRodney W. Grimes.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 209b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 219b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 229b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 239b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 249b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 259b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 269b50d902SRodney W. Grimes.\" SUCH DAMAGE. 279b50d902SRodney W. Grimes.\" 289b50d902SRodney W. Grimes.Dd June 9, 1993 299b50d902SRodney W. Grimes.Dt ZOPEN 3 309b50d902SRodney W. Grimes.Os 319b50d902SRodney W. Grimes.Sh NAME 329b50d902SRodney W. Grimes.Nm zopen 339b50d902SRodney W. Grimes.Nd compressed stream open function 349b50d902SRodney W. Grimes.Sh SYNOPSIS 356846c174SRuslan Ermilov.Fd #include \&"zopen.h\&" 369b50d902SRodney W. Grimes.Ft FILE * 379b50d902SRodney W. Grimes.Fn zopen "const char *path" "const char *mode" "int bits" 389b50d902SRodney W. Grimes.Sh DESCRIPTION 399b50d902SRodney W. GrimesThe 409b50d902SRodney W. Grimes.Fn zopen 419b50d902SRodney W. Grimesfunction 429b50d902SRodney W. Grimesopens the compressed file whose name is the string pointed to by 439b50d902SRodney W. Grimes.Fa path 449b50d902SRodney W. Grimesand associates a stream with it. 459b50d902SRodney W. Grimes.Pp 469b50d902SRodney W. GrimesThe argument 479b50d902SRodney W. Grimes.Fa mode 489b50d902SRodney W. Grimespoints to one of the following one-character strings: 499b50d902SRodney W. Grimes.Bl -tag -width indent 509b50d902SRodney W. Grimes.It Dq Li r 519b50d902SRodney W. GrimesOpen compressed file for reading. 529b50d902SRodney W. GrimesThe stream is positioned at the beginning of the file. 539b50d902SRodney W. Grimes.It Dq Li w 549b50d902SRodney W. GrimesTruncate file to zero length or create compressed file for writing. 559b50d902SRodney W. GrimesThe stream is positioned at the beginning of the file. 569b50d902SRodney W. Grimes.El 579b50d902SRodney W. Grimes.Pp 589b50d902SRodney W. GrimesAny created files will have mode 599b50d902SRodney W. Grimes.Pf \\*q Dv S_IRUSR 609b50d902SRodney W. Grimes\&| 619b50d902SRodney W. Grimes.Dv S_IWUSR 629b50d902SRodney W. Grimes\&| 639b50d902SRodney W. Grimes.Dv S_IRGRP 649b50d902SRodney W. Grimes\&| 659b50d902SRodney W. Grimes.Dv S_IWGRP 669b50d902SRodney W. Grimes\&| 679b50d902SRodney W. Grimes.Dv S_IROTH 689b50d902SRodney W. Grimes\&| 699b50d902SRodney W. Grimes.Dv S_IWOTH Ns \\*q 709b50d902SRodney W. Grimes.Pq Li 0666 , 719b50d902SRodney W. Grimesas modified by the process' 729b50d902SRodney W. Grimesumask value (see 739b50d902SRodney W. Grimes.Xr umask 2 ) . 749b50d902SRodney W. Grimes.Pp 759b50d902SRodney W. GrimesFiles may only be read or written. 769b50d902SRodney W. GrimesSeek operations are not allowed. 779b50d902SRodney W. Grimes.Pp 789b50d902SRodney W. GrimesThe 799b50d902SRodney W. Grimes.Fa bits 809b50d902SRodney W. Grimesargument, if non-zero, is set to the bits code limit. 819b50d902SRodney W. GrimesIf zero, the default is 16. 829b50d902SRodney W. GrimesSee 83fae643c5SPhilippe Charnier.Xr compress 1 849b50d902SRodney W. Grimesfor more information. 859b50d902SRodney W. Grimes.Sh RETURN VALUES 869b50d902SRodney W. GrimesUpon successful completion 879b50d902SRodney W. Grimes.Fn zopen 889b50d902SRodney W. Grimesreturns a 899b50d902SRodney W. Grimes.Tn FILE 909b50d902SRodney W. Grimespointer. 919b50d902SRodney W. GrimesOtherwise, 929b50d902SRodney W. Grimes.Dv NULL 939b50d902SRodney W. Grimesis returned and the global variable 949b50d902SRodney W. Grimes.Va errno 959b50d902SRodney W. Grimesis set to indicate the error. 969b50d902SRodney W. Grimes.Sh ERRORS 979b50d902SRodney W. Grimes.Bl -tag -width [EINVAL] 989b50d902SRodney W. Grimes.It Bq Er EINVAL 999b50d902SRodney W. GrimesThe 1009b50d902SRodney W. Grimes.Fa mode 1019b50d902SRodney W. Grimesor 1029b50d902SRodney W. Grimes.Fa bits 1039b50d902SRodney W. Grimesarguments specified to 1049b50d902SRodney W. Grimes.Fn zopen 1059b50d902SRodney W. Grimeswere invalid. 1069b50d902SRodney W. Grimes.It Bq Er EFTYPE 1079b50d902SRodney W. GrimesThe compressed file starts with an invalid header, or the compressed 1089b50d902SRodney W. Grimesfile is compressed with more bits than can be handled. 1099b50d902SRodney W. Grimes.El 1109b50d902SRodney W. Grimes.Pp 1119b50d902SRodney W. GrimesThe 1129b50d902SRodney W. Grimes.Fn zopen 1139b50d902SRodney W. Grimesfunction may also fail and set 1149b50d902SRodney W. Grimes.Va errno 1159b50d902SRodney W. Grimesfor any of the errors specified for the routines 1169b50d902SRodney W. Grimes.Xr fopen 3 1179b50d902SRodney W. Grimesor 1189b50d902SRodney W. Grimes.Xr funopen 3 . 1199b50d902SRodney W. Grimes.Sh SEE ALSO 1209b50d902SRodney W. Grimes.Xr compress 1 , 1219b50d902SRodney W. Grimes.Xr fopen 3 , 1229b50d902SRodney W. Grimes.Xr funopen 3 1239b50d902SRodney W. Grimes.Sh HISTORY 1249b50d902SRodney W. GrimesThe 1258fe908efSRuslan Ermilov.Nm 1269b50d902SRodney W. Grimesfunction 127c0b0bcf4SMike Pritchardfirst appeared in 128c0b0bcf4SMike Pritchard.Bx 4.4 . 1299b50d902SRodney W. Grimes.Sh BUGS 1309b50d902SRodney W. GrimesThe 1319b50d902SRodney W. Grimes.Fn zopen 1329b50d902SRodney W. Grimesfunction 1339b50d902SRodney W. Grimesmay not be portable to systems other than 1349b50d902SRodney W. Grimes.Bx . 135