[thirdparty/glibc.git] / sysdeps / unix / bsd / ultrix4 / sys / mman.h

/* Definitions for BSD-style memory management.  Ultrix 4 version.
   Copyright (C) 1994, 1995, 1996 Free Software Foundation, Inc.
   This file is part of the GNU C Library.

   The GNU C Library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public License as
   published by the Free Software Foundation; either version 2 of the
   License, or (at your option) any later version.

   The GNU C Library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with the GNU C Library; see the file COPYING.LIB.  If not,
   write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
   Boston, MA 02111-1307, USA.  */

#ifndef	_SYS_MMAN_H

#define	_SYS_MMAN_H	1
#include <features.h>

#include <gnu/types.h>
#define __need_size_t
#include <stddef.h>


/* Protections are chosen from these bits, OR'd together.  The
   implementation does not necessarily support PROT_EXEC or PROT_WRITE
   without PROT_READ.  The only guarantees are that no writing will be
   allowed without PROT_WRITE and no access will be allowed for PROT_NONE. */

#define	PROT_NONE	0x00	/* No access.  */
#define	PROT_READ	0x01	/* Pages can be read.  */
#define	PROT_WRITE	0x02	/* Pages can be written.  */
#define	PROT_EXEC	0x04	/* Pages can be executed.  */


/* Sharing types (must choose one and only one of these).  */
#define	MAP_SHARED	0x01	/* Share changes.  */
#define	MAP_PRIVATE	0x02	/* Changes private; copy pages on write.  */
#define	MAP_TYPE	0x0f	/* Mask for sharing type.  */

/* Other flags.  */
#define	MAP_FIXED	0x10	/* Map address must be exactly as requested. */

/* Advice to `madvise'.  */
#define	MADV_NORMAL	0	/* No further special treatment.  */
#define	MADV_RANDOM	1	/* Expect random page references.  */
#define	MADV_SEQUENTIAL	2	/* Expect sequential page references.  */
#define	MADV_WILLNEED	3	/* Will need these pages.  */
#define	MADV_DONTNEED	4	/* Don't need these pages.  */


#include <sys/cdefs.h>

__BEGIN_DECLS
/* Map addresses starting near ADDR and extending for LEN bytes.  from
   OFFSET into the file FD describes according to PROT and FLAGS.  If ADDR
   is nonzero, it is the desired mapping address.  If the MAP_FIXED bit is
   set in FLAGS, the mapping will be at ADDR exactly (which must be
   page-aligned); otherwise the system chooses a convenient nearby address.
   The return value is the actual mapping address chosen or (caddr_t) -1
   for errors (in which case `errno' is set).  A successful `mmap' call
   deallocates any previous mapping for the affected region.  */

__caddr_t __mmap __P ((__caddr_t __addr, size_t __len,
		       int __prot, int __flags, int __fd, off_t __offset));
__caddr_t mmap __P ((__caddr_t __addr, size_t __len,
		     int __prot, int __flags, int __fd, off_t __offset));

/* Deallocate any mapping for the region starting at ADDR and extending LEN
   bytes.  Returns 0 if successful, -1 for errors (and sets errno).  */
int __munmap __P ((__caddr_t __addr, size_t __len));
int munmap __P ((__caddr_t __addr, size_t __len));

/* Change the memory protection of the region starting at ADDR and
   extending LEN bytes to PROT.  Returns 0 if successful, -1 for errors
   (and sets errno).  */
int __mprotect __P ((__caddr_t __addr, size_t __len, int __prot));
int mprotect __P ((__caddr_t __addr, size_t __len, int __prot));

/* Ultrix 4 does not implement `msync' or `madvise'.  */

/* Synchronize the region starting at ADDR and extending LEN bytes with the
   file it maps.  Filesystem operations on a file being mapped are
   unpredictable before this is done.  */
int msync __P ((caddr_t __addr, size_t __len));

/* Advise the system about particular usage patterns the program follows
   for the region starting at ADDR and extending LEN bytes.  */
int madvise __P ((__caddr_t __addr, size_t __len, int __advice));

__END_DECLS


#endif	/* sys/mman.h */
Commit	Line	Data
28f540f4	1	/* Definitions for BSD-style memory management. Ultrix 4 version.
54d79e99 UD	2	Copyright (C) 1994, 1995, 1996 Free Software Foundation, Inc.
54d79e99 UD	3	This file is part of the GNU C Library.
28f540f4	4
54d79e99 UD	5	The GNU C Library is free software; you can redistribute it and/or
	6	modify it under the terms of the GNU Library General Public License as
	7	published by the Free Software Foundation; either version 2 of the
	8	License, or (at your option) any later version.
28f540f4	9
54d79e99 UD	10	The GNU C Library is distributed in the hope that it will be useful,
	11	but WITHOUT ANY WARRANTY; without even the implied warranty of
	12	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	13	Library General Public License for more details.
28f540f4	14
54d79e99 UD	15	You should have received a copy of the GNU Library General Public
	16	License along with the GNU C Library; see the file COPYING.LIB. If not,
	17	write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
	18	Boston, MA 02111-1307, USA. */
28f540f4	19
28f540f4 RM	20	#ifndef _SYS_MMAN_H
	21
	22	#define _SYS_MMAN_H 1
	23	#include <features.h>
	24
	25	#include <gnu/types.h>
	26	#define __need_size_t
	27	#include <stddef.h>
	28
	29
	30	/* Protections are chosen from these bits, OR'd together. The
	31	implementation does not necessarily support PROT_EXEC or PROT_WRITE
	32	without PROT_READ. The only guarantees are that no writing will be
	33	allowed without PROT_WRITE and no access will be allowed for PROT_NONE. */
	34
	35	#define PROT_NONE 0x00 /* No access. */
	36	#define PROT_READ 0x01 /* Pages can be read. */
	37	#define PROT_WRITE 0x02 /* Pages can be written. */
	38	#define PROT_EXEC 0x04 /* Pages can be executed. */
	39
	40
	41	/* Sharing types (must choose one and only one of these). */
	42	#define MAP_SHARED 0x01 /* Share changes. */
	43	#define MAP_PRIVATE 0x02 /* Changes private; copy pages on write. */
	44	#define MAP_TYPE 0x0f /* Mask for sharing type. */
	45
	46	/* Other flags. */
	47	#define MAP_FIXED 0x10 /* Map address must be exactly as requested. */
	48
	49	/* Advice to `madvise'. */
	50	#define MADV_NORMAL 0 /* No further special treatment. */
	51	#define MADV_RANDOM 1 /* Expect random page references. */
	52	#define MADV_SEQUENTIAL 2 /* Expect sequential page references. */
	53	#define MADV_WILLNEED 3 /* Will need these pages. */
	54	#define MADV_DONTNEED 4 /* Don't need these pages. */
	55
	56
	57	#include <sys/cdefs.h>
	58
	59	__BEGIN_DECLS
	60	/* Map addresses starting near ADDR and extending for LEN bytes. from
	61	OFFSET into the file FD describes according to PROT and FLAGS. If ADDR
	62	is nonzero, it is the desired mapping address. If the MAP_FIXED bit is
	63	set in FLAGS, the mapping will be at ADDR exactly (which must be
	64	page-aligned); otherwise the system chooses a convenient nearby address.
	65	The return value is the actual mapping address chosen or (caddr_t) -1
	66	for errors (in which case `errno' is set). A successful `mmap' call
	67	deallocates any previous mapping for the affected region. */
	68
6408bdde RM	69	__caddr_t __mmap __P ((__caddr_t __addr, size_t __len,
6408bdde RM	70	int __prot, int __flags, int __fd, off_t __offset));
28f540f4 RM	71	__caddr_t mmap __P ((__caddr_t __addr, size_t __len,
	72	int __prot, int __flags, int __fd, off_t __offset));
	73
	74	/* Deallocate any mapping for the region starting at ADDR and extending LEN
	75	bytes. Returns 0 if successful, -1 for errors (and sets errno). */
6408bdde	76	int __munmap __P ((__caddr_t __addr, size_t __len));
28f540f4 RM	77	int munmap __P ((__caddr_t __addr, size_t __len));
	78
	79	/* Change the memory protection of the region starting at ADDR and
	80	extending LEN bytes to PROT. Returns 0 if successful, -1 for errors
	81	(and sets errno). */
564210fe	82	int __mprotect __P ((__caddr_t __addr, size_t __len, int __prot));
28f540f4 RM	83	int mprotect __P ((__caddr_t __addr, size_t __len, int __prot));
	84
	85	/* Ultrix 4 does not implement `msync' or `madvise'. */
	86
	87	/* Synchronize the region starting at ADDR and extending LEN bytes with the
	88	file it maps. Filesystem operations on a file being mapped are
	89	unpredictable before this is done. */
	90	int msync __P ((caddr_t __addr, size_t __len));
	91
	92	/* Advise the system about particular usage patterns the program follows
	93	for the region starting at ADDR and extending LEN bytes. */
	94	int madvise __P ((__caddr_t __addr, size_t __len, int __advice));
	95
	96	__END_DECLS
	97
	98
	99	#endif /* sys/mman.h */