xref: /titanic_41/usr/src/uts/common/os/shm.c (revision dfaab43a45f1b5f0689624fe908cad9da2ad4a05)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 
22 /*
23  * Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 
27 /*	Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T */
28 /*	  All Rights Reserved	*/
29 
30 /*
31  * University Copyright- Copyright (c) 1982, 1986, 1988
32  * The Regents of the University of California
33  * All Rights Reserved
34  *
35  * University Acknowledgment- Portions of this document are derived from
36  * software developed by the University of California, Berkeley, and its
37  * contributors.
38  */
39 
40 /*
41  * Inter-Process Communication Shared Memory Facility.
42  *
43  * See os/ipc.c for a description of common IPC functionality.
44  *
45  * Resource controls
46  * -----------------
47  *
48  * Control:      zone.max-shm-ids (rc_zone_shmmni)
49  * Description:  Maximum number of shared memory ids allowed a zone.
50  *
51  *   When shmget() is used to allocate a shared memory segment, one id
52  *   is allocated.  If the id allocation doesn't succeed, shmget()
53  *   fails and errno is set to ENOSPC.  Upon successful shmctl(,
54  *   IPC_RMID) the id is deallocated.
55  *
56  * Control:      project.max-shm-ids (rc_project_shmmni)
57  * Description:  Maximum number of shared memory ids allowed a project.
58  *
59  *   When shmget() is used to allocate a shared memory segment, one id
60  *   is allocated.  If the id allocation doesn't succeed, shmget()
61  *   fails and errno is set to ENOSPC.  Upon successful shmctl(,
62  *   IPC_RMID) the id is deallocated.
63  *
64  * Control:      zone.max-shm-memory (rc_zone_shmmax)
65  * Description:  Total amount of shared memory allowed a zone.
66  *
67  *   When shmget() is used to allocate a shared memory segment, the
68  *   segment's size is allocated against this limit.  If the space
69  *   allocation doesn't succeed, shmget() fails and errno is set to
70  *   EINVAL.  The size will be deallocated once the last process has
71  *   detached the segment and the segment has been successfully
72  *   shmctl(, IPC_RMID)ed.
73  *
74  * Control:      project.max-shm-memory (rc_project_shmmax)
75  * Description:  Total amount of shared memory allowed a project.
76  *
77  *   When shmget() is used to allocate a shared memory segment, the
78  *   segment's size is allocated against this limit.  If the space
79  *   allocation doesn't succeed, shmget() fails and errno is set to
80  *   EINVAL.  The size will be deallocated once the last process has
81  *   detached the segment and the segment has been successfully
82  *   shmctl(, IPC_RMID)ed.
83  */
84 
85 #include <sys/types.h>
86 #include <sys/param.h>
87 #include <sys/cred.h>
88 #include <sys/errno.h>
89 #include <sys/time.h>
90 #include <sys/kmem.h>
91 #include <sys/user.h>
92 #include <sys/proc.h>
93 #include <sys/systm.h>
94 #include <sys/prsystm.h>
95 #include <sys/sysmacros.h>
96 #include <sys/tuneable.h>
97 #include <sys/vm.h>
98 #include <sys/mman.h>
99 #include <sys/swap.h>
100 #include <sys/cmn_err.h>
101 #include <sys/debug.h>
102 #include <sys/lwpchan_impl.h>
103 #include <sys/avl.h>
104 #include <sys/modctl.h>
105 #include <sys/syscall.h>
106 #include <sys/task.h>
107 #include <sys/project.h>
108 #include <sys/policy.h>
109 #include <sys/zone.h>
110 #include <sys/rctl.h>
111 
112 #include <sys/ipc.h>
113 #include <sys/ipc_impl.h>
114 #include <sys/shm.h>
115 #include <sys/shm_impl.h>
116 
117 #include <vm/hat.h>
118 #include <vm/seg.h>
119 #include <vm/as.h>
120 #include <vm/seg_vn.h>
121 #include <vm/anon.h>
122 #include <vm/page.h>
123 #include <vm/vpage.h>
124 #include <vm/seg_spt.h>
125 
126 #include <c2/audit.h>
127 
128 static int shmem_lock(kshmid_t *sp, struct anon_map *amp);
129 static void shmem_unlock(kshmid_t *sp, struct anon_map *amp);
130 static void sa_add(struct proc *pp, caddr_t addr, size_t len, ulong_t flags,
131 	kshmid_t *id);
132 static void shm_rm_amp(kshmid_t *sp);
133 static void shm_dtor(kipc_perm_t *);
134 static void shm_rmid(kipc_perm_t *);
135 static void shm_remove_zone(zoneid_t, void *);
136 
137 /*
138  * Semantics for share_page_table and ism_off:
139  *
140  * These are hooks in /etc/system - only for internal testing purpose.
141  *
142  * Setting share_page_table automatically turns on the SHM_SHARE_MMU (ISM) flag
143  * in a call to shmat(2). In other words, with share_page_table set, you always
144  * get ISM, even if say, DISM is specified. It should really be called "ism_on".
145  *
146  * Setting ism_off turns off the SHM_SHARE_MMU flag from the flags passed to
147  * shmat(2).
148  *
149  * If both share_page_table and ism_off are set, share_page_table prevails.
150  *
151  * Although these tunables should probably be removed, they do have some
152  * external exposure; as long as they exist, they should at least work sensibly.
153  */
154 
155 int share_page_table;
156 int ism_off;
157 
158 /*
159  * The following tunables are obsolete.  Though for compatibility we
160  * still read and interpret shminfo_shmmax and shminfo_shmmni (see
161  * os/project.c), the preferred mechanism for administrating the IPC
162  * Shared Memory facility is through the resource controls described at
163  * the top of this file.
164  */
165 size_t	shminfo_shmmax = 0x800000;	/* (obsolete) */
166 int	shminfo_shmmni = 100;		/* (obsolete) */
167 size_t	shminfo_shmmin = 1;		/* (obsolete) */
168 int	shminfo_shmseg = 6;		/* (obsolete) */
169 
170 extern rctl_hndl_t rc_zone_shmmax;
171 extern rctl_hndl_t rc_zone_shmmni;
172 extern rctl_hndl_t rc_project_shmmax;
173 extern rctl_hndl_t rc_project_shmmni;
174 static ipc_service_t *shm_svc;
175 static zone_key_t shm_zone_key;
176 
177 /*
178  * Module linkage information for the kernel.
179  */
180 static uintptr_t shmsys(int, uintptr_t, uintptr_t, uintptr_t);
181 
182 static struct sysent ipcshm_sysent = {
183 	4,
184 #ifdef	_SYSCALL32_IMPL
185 	SE_ARGC | SE_NOUNLOAD | SE_64RVAL,
186 #else	/* _SYSCALL32_IMPL */
187 	SE_ARGC | SE_NOUNLOAD | SE_32RVAL1,
188 #endif	/* _SYSCALL32_IMPL */
189 	(int (*)())shmsys
190 };
191 
192 #ifdef	_SYSCALL32_IMPL
193 static struct sysent ipcshm_sysent32 = {
194 	4,
195 	SE_ARGC | SE_NOUNLOAD | SE_32RVAL1,
196 	(int (*)())shmsys
197 };
198 #endif	/* _SYSCALL32_IMPL */
199 
200 static struct modlsys modlsys = {
201 	&mod_syscallops, "System V shared memory", &ipcshm_sysent
202 };
203 
204 #ifdef	_SYSCALL32_IMPL
205 static struct modlsys modlsys32 = {
206 	&mod_syscallops32, "32-bit System V shared memory", &ipcshm_sysent32
207 };
208 #endif	/* _SYSCALL32_IMPL */
209 
210 static struct modlinkage modlinkage = {
211 	MODREV_1,
212 	&modlsys,
213 #ifdef	_SYSCALL32_IMPL
214 	&modlsys32,
215 #endif
216 	NULL
217 };
218 
219 
220 int
221 _init(void)
222 {
223 	int result;
224 
225 	shm_svc = ipcs_create("shmids", rc_project_shmmni, rc_zone_shmmni,
226 	    sizeof (kshmid_t), shm_dtor, shm_rmid, AT_IPC_SHM,
227 	    offsetof(ipc_rqty_t, ipcq_shmmni));
228 	zone_key_create(&shm_zone_key, NULL, shm_remove_zone, NULL);
229 
230 	if ((result = mod_install(&modlinkage)) == 0)
231 		return (0);
232 
233 	(void) zone_key_delete(shm_zone_key);
234 	ipcs_destroy(shm_svc);
235 
236 	return (result);
237 }
238 
239 int
240 _fini(void)
241 {
242 	return (EBUSY);
243 }
244 
245 int
246 _info(struct modinfo *modinfop)
247 {
248 	return (mod_info(&modlinkage, modinfop));
249 }
250 
251 /*
252  * Shmat (attach shared segment) system call.
253  */
254 static int
255 shmat(int shmid, caddr_t uaddr, int uflags, uintptr_t *rvp)
256 {
257 	kshmid_t *sp;	/* shared memory header ptr */
258 	size_t	size;
259 	int	error = 0;
260 	proc_t *pp = curproc;
261 	struct as *as = pp->p_as;
262 	struct segvn_crargs	crargs;	/* segvn create arguments */
263 	kmutex_t	*lock;
264 	struct seg 	*segspt = NULL;
265 	caddr_t		addr = uaddr;
266 	int		flags = (uflags & SHMAT_VALID_FLAGS_MASK);
267 	int		useISM;
268 	uchar_t		prot = PROT_ALL;
269 	int result;
270 
271 	if ((lock = ipc_lookup(shm_svc, shmid, (kipc_perm_t **)&sp)) == NULL)
272 		return (EINVAL);
273 	if (error = ipcperm_access(&sp->shm_perm, SHM_R, CRED()))
274 		goto errret;
275 	if ((flags & SHM_RDONLY) == 0 &&
276 	    (error = ipcperm_access(&sp->shm_perm, SHM_W, CRED())))
277 		goto errret;
278 	if (spt_invalid(flags)) {
279 		error = EINVAL;
280 		goto errret;
281 	}
282 	if (ism_off)
283 		flags = flags & ~SHM_SHARE_MMU;
284 	if (share_page_table) {
285 		flags = flags & ~SHM_PAGEABLE;
286 		flags = flags | SHM_SHARE_MMU;
287 	}
288 	useISM = (spt_locked(flags) || spt_pageable(flags));
289 	if (useISM && (error = ipcperm_access(&sp->shm_perm, SHM_W, CRED())))
290 		goto errret;
291 	if (useISM && isspt(sp)) {
292 		uint_t newsptflags = flags | spt_flags(sp->shm_sptseg);
293 		/*
294 		 * If trying to change an existing {D}ISM segment from ISM
295 		 * to DISM or vice versa, return error. Note that this
296 		 * validation of flags needs to be done after the effect of
297 		 * tunables such as ism_off and share_page_table, for
298 		 * semantics that are consistent with the tunables' settings.
299 		 */
300 		if (spt_invalid(newsptflags)) {
301 			error = EINVAL;
302 			goto errret;
303 		}
304 	}
305 	ANON_LOCK_ENTER(&sp->shm_amp->a_rwlock, RW_WRITER);
306 	size = sp->shm_amp->size;
307 	ANON_LOCK_EXIT(&sp->shm_amp->a_rwlock);
308 
309 	/* somewhere to record spt info for final detach */
310 	if (sp->shm_sptinfo == NULL)
311 		sp->shm_sptinfo = kmem_zalloc(sizeof (sptinfo_t), KM_SLEEP);
312 
313 	as_rangelock(as);
314 
315 	if (useISM) {
316 		/*
317 		 * Handle ISM
318 		 */
319 		uint_t	share_szc;
320 		size_t	share_size;
321 		struct	shm_data ssd;
322 		uintptr_t align_hint;
323 
324 		/*
325 		 * Pick a share pagesize to use, if (!isspt(sp)).
326 		 * Otherwise use the already chosen page size.
327 		 *
328 		 * For the initial shmat (!isspt(sp)), where sptcreate is
329 		 * called, map_pgsz is called to recommend a [D]ISM pagesize,
330 		 * important for systems which offer more than one potential
331 		 * [D]ISM pagesize.
332 		 * If the shmat is just to attach to an already created
333 		 * [D]ISM segment, then use the previously selected page size.
334 		 */
335 		if (!isspt(sp)) {
336 			share_size = map_pgsz(MAPPGSZ_ISM, pp, addr, size, 0);
337 			if (share_size == 0) {
338 				as_rangeunlock(as);
339 				error = EINVAL;
340 				goto errret;
341 			}
342 			share_szc = page_szc(share_size);
343 		} else {
344 			share_szc = sp->shm_sptseg->s_szc;
345 			share_size = page_get_pagesize(share_szc);
346 		}
347 		size = P2ROUNDUP(size, share_size);
348 
349 		align_hint = share_size;
350 #if defined(__i386) || defined(__amd64)
351 		/*
352 		 * For x86, we want to share as much of the page table tree
353 		 * as possible. We use a large align_hint at first, but
354 		 * if that fails, then the code below retries with align_hint
355 		 * set to share_size.
356 		 *
357 		 * The explicit extern here is due to the difficulties
358 		 * of getting to platform dependent includes. When/if the
359 		 * platform dependent bits of this function are cleaned up,
360 		 * another way of doing this should found.
361 		 */
362 		{
363 			extern uint_t ptes_per_table;
364 
365 			while (size >= ptes_per_table * (uint64_t)align_hint)
366 				align_hint *= ptes_per_table;
367 		}
368 #endif /* __i386 || __amd64 */
369 
370 #if defined(__sparcv9)
371 		if (addr == 0 &&
372 		    pp->p_model == DATAMODEL_LP64 && AS_TYPE_64BIT(as)) {
373 			/*
374 			 * If no address has been passed in, and this is a
375 			 * 64-bit process, we'll try to find an address
376 			 * in the predict-ISM zone.
377 			 */
378 			caddr_t predbase = (caddr_t)PREDISM_1T_BASE;
379 			size_t len = PREDISM_BOUND - PREDISM_1T_BASE;
380 
381 			as_purge(as);
382 			if (as_gap(as, size + share_size, &predbase, &len,
383 			    AH_LO, (caddr_t)NULL) != -1) {
384 				/*
385 				 * We found an address which looks like a
386 				 * candidate.  We want to round it up, and
387 				 * then check that it's a valid user range.
388 				 * This assures that we won't fail below.
389 				 */
390 				addr = (caddr_t)P2ROUNDUP((uintptr_t)predbase,
391 				    share_size);
392 
393 				if (valid_usr_range(addr, size, prot,
394 				    as, as->a_userlimit) != RANGE_OKAY) {
395 					addr = 0;
396 				}
397 			}
398 		}
399 #endif /* __sparcv9 */
400 
401 		if (addr == 0) {
402 			for (;;) {
403 				addr = (caddr_t)align_hint;
404 				map_addr(&addr, size, 0ll, 1, MAP_ALIGN);
405 				if (addr != NULL || align_hint == share_size)
406 					break;
407 				align_hint = share_size;
408 			}
409 			if (addr == NULL) {
410 				as_rangeunlock(as);
411 				error = ENOMEM;
412 				goto errret;
413 			}
414 			ASSERT(((uintptr_t)addr & (align_hint - 1)) == 0);
415 		} else {
416 			/* Use the user-supplied attach address */
417 			caddr_t base;
418 			size_t len;
419 
420 			/*
421 			 * Check that the address range
422 			 *  1) is properly aligned
423 			 *  2) is correct in unix terms
424 			 *  3) is within an unmapped address segment
425 			 */
426 			base = addr;
427 			len = size;		/* use spt aligned size */
428 			/* XXX - in SunOS, is sp->shm_segsz */
429 			if ((uintptr_t)base & (share_size - 1)) {
430 				error = EINVAL;
431 				as_rangeunlock(as);
432 				goto errret;
433 			}
434 			result = valid_usr_range(base, len, prot, as,
435 			    as->a_userlimit);
436 			if (result == RANGE_BADPROT) {
437 				/*
438 				 * We try to accomodate processors which
439 				 * may not support execute permissions on
440 				 * all ISM segments by trying the check
441 				 * again but without PROT_EXEC.
442 				 */
443 				prot &= ~PROT_EXEC;
444 				result = valid_usr_range(base, len, prot, as,
445 				    as->a_userlimit);
446 			}
447 			as_purge(as);
448 			if (result != RANGE_OKAY ||
449 			    as_gap(as, len, &base, &len, AH_LO,
450 			    (caddr_t)NULL) != 0) {
451 				error = EINVAL;
452 				as_rangeunlock(as);
453 				goto errret;
454 			}
455 		}
456 
457 		if (!isspt(sp)) {
458 			error = sptcreate(size, &segspt, sp->shm_amp, prot,
459 			    flags, share_szc);
460 			if (error) {
461 				as_rangeunlock(as);
462 				goto errret;
463 			}
464 			sp->shm_sptinfo->sptas = segspt->s_as;
465 			sp->shm_sptseg = segspt;
466 			sp->shm_sptprot = prot;
467 		} else if ((prot & sp->shm_sptprot) != sp->shm_sptprot) {
468 			/*
469 			 * Ensure we're attaching to an ISM segment with
470 			 * fewer or equal permissions than what we're
471 			 * allowed.  Fail if the segment has more
472 			 * permissions than what we're allowed.
473 			 */
474 			error = EACCES;
475 			as_rangeunlock(as);
476 			goto errret;
477 		}
478 
479 		ssd.shm_sptseg = sp->shm_sptseg;
480 		ssd.shm_sptas = sp->shm_sptinfo->sptas;
481 		ssd.shm_amp = sp->shm_amp;
482 		error = as_map(as, addr, size, segspt_shmattach, &ssd);
483 		if (error == 0)
484 			sp->shm_ismattch++; /* keep count of ISM attaches */
485 	} else {
486 
487 		/*
488 		 * Normal case.
489 		 */
490 		if (flags & SHM_RDONLY)
491 			prot &= ~PROT_WRITE;
492 
493 		if (addr == 0) {
494 			/* Let the system pick the attach address */
495 			map_addr(&addr, size, 0ll, 1, 0);
496 			if (addr == NULL) {
497 				as_rangeunlock(as);
498 				error = ENOMEM;
499 				goto errret;
500 			}
501 		} else {
502 			/* Use the user-supplied attach address */
503 			caddr_t base;
504 			size_t len;
505 
506 			if (flags & SHM_RND)
507 				addr = (caddr_t)((uintptr_t)addr &
508 				    ~(SHMLBA - 1));
509 			/*
510 			 * Check that the address range
511 			 *  1) is properly aligned
512 			 *  2) is correct in unix terms
513 			 *  3) is within an unmapped address segment
514 			 */
515 			base = addr;
516 			len = size;		/* use aligned size */
517 			/* XXX - in SunOS, is sp->shm_segsz */
518 			if ((uintptr_t)base & PAGEOFFSET) {
519 				error = EINVAL;
520 				as_rangeunlock(as);
521 				goto errret;
522 			}
523 			result = valid_usr_range(base, len, prot, as,
524 			    as->a_userlimit);
525 			if (result == RANGE_BADPROT) {
526 				prot &= ~PROT_EXEC;
527 				result = valid_usr_range(base, len, prot, as,
528 				    as->a_userlimit);
529 			}
530 			as_purge(as);
531 			if (result != RANGE_OKAY ||
532 			    as_gap(as, len, &base, &len,
533 			    AH_LO, (caddr_t)NULL) != 0) {
534 				error = EINVAL;
535 				as_rangeunlock(as);
536 				goto errret;
537 			}
538 		}
539 
540 		/* Initialize the create arguments and map the segment */
541 		crargs = *(struct segvn_crargs *)zfod_argsp;
542 		crargs.offset = 0;
543 		crargs.type = MAP_SHARED;
544 		crargs.amp = sp->shm_amp;
545 		crargs.prot = prot;
546 		crargs.maxprot = crargs.prot;
547 		crargs.flags = 0;
548 
549 		error = as_map(as, addr, size, segvn_create, &crargs);
550 	}
551 
552 	as_rangeunlock(as);
553 	if (error)
554 		goto errret;
555 
556 	/* record shmem range for the detach */
557 	sa_add(pp, addr, (size_t)size, useISM ? SHMSA_ISM : 0, sp);
558 	*rvp = (uintptr_t)addr;
559 
560 	sp->shm_atime = gethrestime_sec();
561 	sp->shm_lpid = pp->p_pid;
562 	ipc_hold(shm_svc, (kipc_perm_t *)sp);
563 errret:
564 	mutex_exit(lock);
565 	return (error);
566 }
567 
568 static void
569 shm_dtor(kipc_perm_t *perm)
570 {
571 	kshmid_t *sp = (kshmid_t *)perm;
572 	uint_t cnt;
573 	size_t rsize;
574 
575 	if (sp->shm_lkcnt > 0) {
576 		shmem_unlock(sp, sp->shm_amp);
577 		sp->shm_lkcnt = 0;
578 	}
579 
580 	if (sp->shm_sptinfo) {
581 		if (isspt(sp))
582 			sptdestroy(sp->shm_sptinfo->sptas, sp->shm_amp);
583 		kmem_free(sp->shm_sptinfo, sizeof (sptinfo_t));
584 	}
585 
586 	ANON_LOCK_ENTER(&sp->shm_amp->a_rwlock, RW_WRITER);
587 	cnt = --sp->shm_amp->refcnt;
588 	ANON_LOCK_EXIT(&sp->shm_amp->a_rwlock);
589 	ASSERT(cnt == 0);
590 	shm_rm_amp(sp);
591 
592 	if (sp->shm_perm.ipc_id != IPC_ID_INVAL) {
593 		rsize = ptob(btopr(sp->shm_segsz));
594 		ipcs_lock(shm_svc);
595 		sp->shm_perm.ipc_proj->kpj_data.kpd_shmmax -= rsize;
596 		sp->shm_perm.ipc_zone->zone_shmmax -= rsize;
597 		ipcs_unlock(shm_svc);
598 	}
599 }
600 
601 /* ARGSUSED */
602 static void
603 shm_rmid(kipc_perm_t *perm)
604 {
605 	/* nothing to do */
606 }
607 
608 /*
609  * Shmctl system call.
610  */
611 /* ARGSUSED */
612 static int
613 shmctl(int shmid, int cmd, void *arg)
614 {
615 	kshmid_t		*sp;	/* shared memory header ptr */
616 	STRUCT_DECL(shmid_ds, ds);	/* for SVR4 IPC_SET */
617 	int			error = 0;
618 	struct cred 		*cr = CRED();
619 	kmutex_t		*lock;
620 	model_t			mdl = get_udatamodel();
621 	struct shmid_ds64	ds64;
622 	shmatt_t		nattch;
623 
624 	STRUCT_INIT(ds, mdl);
625 
626 	/*
627 	 * Perform pre- or non-lookup actions (e.g. copyins, RMID).
628 	 */
629 	switch (cmd) {
630 	case IPC_SET:
631 		if (copyin(arg, STRUCT_BUF(ds), STRUCT_SIZE(ds)))
632 			return (EFAULT);
633 		break;
634 
635 	case IPC_SET64:
636 		if (copyin(arg, &ds64, sizeof (struct shmid_ds64)))
637 			return (EFAULT);
638 		break;
639 
640 	case IPC_RMID:
641 		return (ipc_rmid(shm_svc, shmid, cr));
642 	}
643 
644 	if ((lock = ipc_lookup(shm_svc, shmid, (kipc_perm_t **)&sp)) == NULL)
645 		return (EINVAL);
646 
647 	switch (cmd) {
648 	/* Set ownership and permissions. */
649 	case IPC_SET:
650 		if (error = ipcperm_set(shm_svc, cr, &sp->shm_perm,
651 		    &STRUCT_BUF(ds)->shm_perm, mdl))
652 				break;
653 		sp->shm_ctime = gethrestime_sec();
654 		break;
655 
656 	case IPC_STAT:
657 		if (error = ipcperm_access(&sp->shm_perm, SHM_R, cr))
658 			break;
659 
660 		nattch = sp->shm_perm.ipc_ref - 1;
661 
662 		ipcperm_stat(&STRUCT_BUF(ds)->shm_perm, &sp->shm_perm, mdl);
663 		STRUCT_FSET(ds, shm_segsz, sp->shm_segsz);
664 		STRUCT_FSETP(ds, shm_amp, NULL);	/* kernel addr */
665 		STRUCT_FSET(ds, shm_lkcnt, sp->shm_lkcnt);
666 		STRUCT_FSET(ds, shm_lpid, sp->shm_lpid);
667 		STRUCT_FSET(ds, shm_cpid, sp->shm_cpid);
668 		STRUCT_FSET(ds, shm_nattch, nattch);
669 		STRUCT_FSET(ds, shm_cnattch, sp->shm_ismattch);
670 		STRUCT_FSET(ds, shm_atime, sp->shm_atime);
671 		STRUCT_FSET(ds, shm_dtime, sp->shm_dtime);
672 		STRUCT_FSET(ds, shm_ctime, sp->shm_ctime);
673 
674 		mutex_exit(lock);
675 		if (copyout(STRUCT_BUF(ds), arg, STRUCT_SIZE(ds)))
676 			return (EFAULT);
677 
678 		return (0);
679 
680 	case IPC_SET64:
681 		if (error = ipcperm_set64(shm_svc, cr,
682 		    &sp->shm_perm, &ds64.shmx_perm))
683 			break;
684 		sp->shm_ctime = gethrestime_sec();
685 		break;
686 
687 	case IPC_STAT64:
688 		nattch = sp->shm_perm.ipc_ref - 1;
689 
690 		ipcperm_stat64(&ds64.shmx_perm, &sp->shm_perm);
691 		ds64.shmx_segsz = sp->shm_segsz;
692 		ds64.shmx_lkcnt = sp->shm_lkcnt;
693 		ds64.shmx_lpid = sp->shm_lpid;
694 		ds64.shmx_cpid = sp->shm_cpid;
695 		ds64.shmx_nattch = nattch;
696 		ds64.shmx_cnattch = sp->shm_ismattch;
697 		ds64.shmx_atime = sp->shm_atime;
698 		ds64.shmx_dtime = sp->shm_dtime;
699 		ds64.shmx_ctime = sp->shm_ctime;
700 
701 		mutex_exit(lock);
702 		if (copyout(&ds64, arg, sizeof (struct shmid_ds64)))
703 			return (EFAULT);
704 
705 		return (0);
706 
707 	/* Lock segment in memory */
708 	case SHM_LOCK:
709 		if ((error = secpolicy_lock_memory(cr)) != 0)
710 			break;
711 
712 		/* protect against overflow */
713 		if (sp->shm_lkcnt >= USHRT_MAX) {
714 			error = ENOMEM;
715 			break;
716 		}
717 		if (!isspt(sp) && (sp->shm_lkcnt++ == 0)) {
718 			if (error = shmem_lock(sp, sp->shm_amp)) {
719 				ANON_LOCK_ENTER(&sp->shm_amp->a_rwlock,
720 				    RW_WRITER);
721 				cmn_err(CE_NOTE, "shmctl - couldn't lock %ld"
722 				    " pages into memory", sp->shm_amp->size);
723 				ANON_LOCK_EXIT(&sp->shm_amp->a_rwlock);
724 				error = ENOMEM;
725 				sp->shm_lkcnt--;
726 			}
727 		}
728 		break;
729 
730 	/* Unlock segment */
731 	case SHM_UNLOCK:
732 		if ((error = secpolicy_lock_memory(cr)) != 0)
733 			break;
734 
735 		if (sp->shm_lkcnt && (--sp->shm_lkcnt == 0)) {
736 			shmem_unlock(sp, sp->shm_amp);
737 		}
738 		break;
739 
740 	default:
741 		error = EINVAL;
742 		break;
743 	}
744 	mutex_exit(lock);
745 	return (error);
746 }
747 
748 static void
749 shm_detach(proc_t *pp, segacct_t *sap)
750 {
751 	kshmid_t	*sp = sap->sa_id;
752 	size_t		len = sap->sa_len;
753 	caddr_t		addr = sap->sa_addr;
754 
755 	/*
756 	 * Discard lwpchan mappings.
757 	 */
758 	if (pp->p_lcp != NULL)
759 		lwpchan_delete_mapping(pp, addr, addr + len);
760 	(void) as_unmap(pp->p_as, addr, len);
761 
762 	/*
763 	 * Perform some detach-time accounting.
764 	 */
765 	(void) ipc_lock(shm_svc, sp->shm_perm.ipc_id);
766 	if (sap->sa_flags & SHMSA_ISM)
767 		sp->shm_ismattch--;
768 	sp->shm_dtime = gethrestime_sec();
769 	sp->shm_lpid = pp->p_pid;
770 	ipc_rele(shm_svc, (kipc_perm_t *)sp);	/* Drops lock */
771 
772 	kmem_free(sap, sizeof (segacct_t));
773 }
774 
775 static int
776 shmdt(caddr_t addr)
777 {
778 	proc_t *pp = curproc;
779 	segacct_t *sap, template;
780 
781 	mutex_enter(&pp->p_lock);
782 	prbarrier(pp);			/* block /proc.  See shmgetid(). */
783 
784 	template.sa_addr = addr;
785 	template.sa_len = 0;
786 	if ((pp->p_segacct == NULL) ||
787 	    ((sap = avl_find(pp->p_segacct, &template, NULL)) == NULL)) {
788 		mutex_exit(&pp->p_lock);
789 		return (EINVAL);
790 	}
791 	if (sap->sa_addr != addr) {
792 		mutex_exit(&pp->p_lock);
793 		return (EINVAL);
794 	}
795 	avl_remove(pp->p_segacct, sap);
796 	mutex_exit(&pp->p_lock);
797 
798 	shm_detach(pp, sap);
799 
800 	return (0);
801 }
802 
803 /*
804  * Remove all shared memory segments associated with a given zone.
805  * Called by zone_shutdown when the zone is halted.
806  */
807 /*ARGSUSED1*/
808 static void
809 shm_remove_zone(zoneid_t zoneid, void *arg)
810 {
811 	ipc_remove_zone(shm_svc, zoneid);
812 }
813 
814 /*
815  * Shmget (create new shmem) system call.
816  */
817 static int
818 shmget(key_t key, size_t size, int shmflg, uintptr_t *rvp)
819 {
820 	proc_t		*pp = curproc;
821 	kshmid_t	*sp;
822 	kmutex_t	*lock;
823 	int		error;
824 
825 top:
826 	if (error = ipc_get(shm_svc, key, shmflg, (kipc_perm_t **)&sp, &lock))
827 		return (error);
828 
829 	if (!IPC_FREE(&sp->shm_perm)) {
830 		/*
831 		 * A segment with the requested key exists.
832 		 */
833 		if (size > sp->shm_segsz) {
834 			mutex_exit(lock);
835 			return (EINVAL);
836 		}
837 	} else {
838 		/*
839 		 * A new segment should be created.
840 		 */
841 		size_t npages = btopr(size);
842 		size_t rsize = ptob(npages);
843 
844 		/*
845 		 * Check rsize and the per-project and per-zone limit on
846 		 * shared memory.  Checking rsize handles both the size == 0
847 		 * case and the size < ULONG_MAX & PAGEMASK case (i.e.
848 		 * rounding up wraps a size_t).
849 		 */
850 		if (rsize == 0 ||
851 		    (rctl_test(rc_project_shmmax,
852 		    pp->p_task->tk_proj->kpj_rctls, pp, rsize,
853 		    RCA_SAFE) & RCT_DENY) ||
854 		    (rctl_test(rc_zone_shmmax,
855 		    pp->p_zone->zone_rctls, pp, rsize,
856 		    RCA_SAFE) & RCT_DENY)) {
857 
858 			mutex_exit(&pp->p_lock);
859 			mutex_exit(lock);
860 			ipc_cleanup(shm_svc, (kipc_perm_t *)sp);
861 			return (EINVAL);
862 		}
863 		mutex_exit(&pp->p_lock);
864 		mutex_exit(lock);
865 
866 		if (anon_resv(rsize) == 0) {
867 			ipc_cleanup(shm_svc, (kipc_perm_t *)sp);
868 			return (ENOMEM);
869 		}
870 
871 		/*
872 		 * If any new failure points are introduced between the
873 		 * the above anon_resv() and the below ipc_commit_begin(),
874 		 * these failure points will need to unreserve the anon
875 		 * reserved using anon_unresv().
876 		 *
877 		 * Once ipc_commit_begin() is called, the anon reserved
878 		 * above will be automatically unreserved by future calls to
879 		 * ipcs_cleanup() -> shm_dtor() -> shm_rm_amp().  If
880 		 * ipc_commit_begin() fails, it internally calls shm_dtor(),
881 		 * unreserving the above anon, and freeing the below amp.
882 		 */
883 
884 		sp->shm_amp = anonmap_alloc(rsize, rsize, ANON_SLEEP);
885 		sp->shm_amp->a_sp = sp;
886 		/*
887 		 * Store the original user's requested size, in bytes,
888 		 * rather than the page-aligned size.  The former is
889 		 * used for IPC_STAT and shmget() lookups.  The latter
890 		 * is saved in the anon_map structure and is used for
891 		 * calls to the vm layer.
892 		 */
893 		sp->shm_segsz = size;
894 		sp->shm_atime = sp->shm_dtime = 0;
895 		sp->shm_ctime = gethrestime_sec();
896 		sp->shm_lpid = (pid_t)0;
897 		sp->shm_cpid = curproc->p_pid;
898 		sp->shm_ismattch = 0;
899 		sp->shm_sptinfo = NULL;
900 		/*
901 		 * Check limits one last time, push id into global
902 		 * visibility, and update resource usage counts.
903 		 */
904 		if (error = ipc_commit_begin(shm_svc, key, shmflg,
905 		    (kipc_perm_t *)sp)) {
906 			if (error == EAGAIN)
907 				goto top;
908 			return (error);
909 		}
910 
911 		if ((rctl_test(rc_project_shmmax,
912 		    sp->shm_perm.ipc_proj->kpj_rctls, pp, rsize,
913 		    RCA_SAFE) & RCT_DENY) ||
914 		    (rctl_test(rc_zone_shmmax,
915 		    sp->shm_perm.ipc_zone->zone_rctls, pp, rsize,
916 		    RCA_SAFE) & RCT_DENY)) {
917 			ipc_cleanup(shm_svc, (kipc_perm_t *)sp);
918 			return (EINVAL);
919 		}
920 		sp->shm_perm.ipc_proj->kpj_data.kpd_shmmax += rsize;
921 		sp->shm_perm.ipc_zone->zone_shmmax += rsize;
922 
923 		lock = ipc_commit_end(shm_svc, &sp->shm_perm);
924 	}
925 
926 	if (audit_active)
927 		audit_ipcget(AT_IPC_SHM, (void *)sp);
928 
929 	*rvp = (uintptr_t)(sp->shm_perm.ipc_id);
930 
931 	mutex_exit(lock);
932 	return (0);
933 }
934 
935 /*
936  * shmids system call.
937  */
938 static int
939 shmids(int *buf, uint_t nids, uint_t *pnids)
940 {
941 	return (ipc_ids(shm_svc, buf, nids, pnids));
942 }
943 
944 /*
945  * System entry point for shmat, shmctl, shmdt, and shmget system calls.
946  */
947 static uintptr_t
948 shmsys(int opcode, uintptr_t a0, uintptr_t a1, uintptr_t a2)
949 {
950 	int	error;
951 	uintptr_t r_val = 0;
952 
953 	switch (opcode) {
954 	case SHMAT:
955 		error = shmat((int)a0, (caddr_t)a1, (int)a2, &r_val);
956 		break;
957 	case SHMCTL:
958 		error = shmctl((int)a0, (int)a1, (void *)a2);
959 		break;
960 	case SHMDT:
961 		error = shmdt((caddr_t)a0);
962 		break;
963 	case SHMGET:
964 		error = shmget((key_t)a0, (size_t)a1, (int)a2, &r_val);
965 		break;
966 	case SHMIDS:
967 		error = shmids((int *)a0, (uint_t)a1, (uint_t *)a2);
968 		break;
969 	default:
970 		error = EINVAL;
971 		break;
972 	}
973 
974 	if (error)
975 		return ((uintptr_t)set_errno(error));
976 
977 	return (r_val);
978 }
979 
980 /*
981  * segacct_t comparator
982  * This works as expected, with one minor change: the first of two real
983  * segments with equal addresses is considered to be 'greater than' the
984  * second.  We only return equal when searching using a template, in
985  * which case we explicitly set the template segment's length to 0
986  * (which is invalid for a real segment).
987  */
988 static int
989 shm_sacompar(const void *x, const void *y)
990 {
991 	segacct_t *sa1 = (segacct_t *)x;
992 	segacct_t *sa2 = (segacct_t *)y;
993 
994 	if (sa1->sa_addr < sa2->sa_addr) {
995 		return (-1);
996 	} else if (sa2->sa_len != 0) {
997 		if (sa1->sa_addr >= sa2->sa_addr + sa2->sa_len) {
998 			return (1);
999 		} else if (sa1->sa_len != 0) {
1000 			return (1);
1001 		} else {
1002 			return (0);
1003 		}
1004 	} else if (sa1->sa_addr > sa2->sa_addr) {
1005 		return (1);
1006 	} else {
1007 		return (0);
1008 	}
1009 }
1010 
1011 /*
1012  * add this record to the segacct list.
1013  */
1014 static void
1015 sa_add(struct proc *pp, caddr_t addr, size_t len, ulong_t flags, kshmid_t *id)
1016 {
1017 	segacct_t *nsap;
1018 	avl_tree_t *tree = NULL;
1019 	avl_index_t where;
1020 
1021 	nsap = kmem_alloc(sizeof (segacct_t), KM_SLEEP);
1022 	nsap->sa_addr = addr;
1023 	nsap->sa_len  = len;
1024 	nsap->sa_flags = flags;
1025 	nsap->sa_id = id;
1026 
1027 	if (pp->p_segacct == NULL)
1028 		tree = kmem_alloc(sizeof (avl_tree_t), KM_SLEEP);
1029 
1030 	mutex_enter(&pp->p_lock);
1031 	prbarrier(pp);			/* block /proc.  See shmgetid(). */
1032 
1033 	if (pp->p_segacct == NULL) {
1034 		avl_create(tree, shm_sacompar, sizeof (segacct_t),
1035 		    offsetof(segacct_t, sa_tree));
1036 		pp->p_segacct = tree;
1037 	} else if (tree) {
1038 		kmem_free(tree, sizeof (avl_tree_t));
1039 	}
1040 
1041 	/*
1042 	 * We can ignore the result of avl_find, as the comparator will
1043 	 * never return equal for segments with non-zero length.  This
1044 	 * is a necessary hack to get around the fact that we do, in
1045 	 * fact, have duplicate keys.
1046 	 */
1047 	(void) avl_find(pp->p_segacct, nsap, &where);
1048 	avl_insert(pp->p_segacct, nsap, where);
1049 
1050 	mutex_exit(&pp->p_lock);
1051 }
1052 
1053 /*
1054  * Duplicate parent's segacct records in child.
1055  */
1056 void
1057 shmfork(struct proc *ppp, struct proc *cpp)
1058 {
1059 	segacct_t *sap;
1060 	kshmid_t *sp;
1061 	kmutex_t *mp;
1062 
1063 	ASSERT(ppp->p_segacct != NULL);
1064 
1065 	/*
1066 	 * We are the only lwp running in the parent so nobody can
1067 	 * mess with our p_segacct list.  Thus it is safe to traverse
1068 	 * the list without holding p_lock.  This is essential because
1069 	 * we can't hold p_lock during a KM_SLEEP allocation.
1070 	 */
1071 	for (sap = (segacct_t *)avl_first(ppp->p_segacct); sap != NULL;
1072 	    sap = (segacct_t *)AVL_NEXT(ppp->p_segacct, sap)) {
1073 		sa_add(cpp, sap->sa_addr, sap->sa_len, sap->sa_flags,
1074 		    sap->sa_id);
1075 		sp = sap->sa_id;
1076 		mp = ipc_lock(shm_svc, sp->shm_perm.ipc_id);
1077 		if (sap->sa_flags & SHMSA_ISM)
1078 			sp->shm_ismattch++;
1079 		ipc_hold(shm_svc, (kipc_perm_t *)sp);
1080 		mutex_exit(mp);
1081 	}
1082 }
1083 
1084 /*
1085  * Detach shared memory segments from exiting process.
1086  */
1087 void
1088 shmexit(struct proc *pp)
1089 {
1090 	segacct_t *sap;
1091 	avl_tree_t *tree;
1092 	void *cookie = NULL;
1093 
1094 	ASSERT(pp->p_segacct != NULL);
1095 
1096 	mutex_enter(&pp->p_lock);
1097 	prbarrier(pp);
1098 	tree = pp->p_segacct;
1099 	pp->p_segacct = NULL;
1100 	mutex_exit(&pp->p_lock);
1101 
1102 	while ((sap = avl_destroy_nodes(tree, &cookie)) != NULL)
1103 		(void) shm_detach(pp, sap);
1104 
1105 	avl_destroy(tree);
1106 	kmem_free(tree, sizeof (avl_tree_t));
1107 }
1108 
1109 /*
1110  * At this time pages should be in memory, so just lock them.
1111  */
1112 static void
1113 lock_again(size_t npages, kshmid_t *sp, struct anon_map *amp)
1114 {
1115 	struct anon *ap;
1116 	struct page *pp;
1117 	struct vnode *vp;
1118 	u_offset_t off;
1119 	ulong_t anon_idx;
1120 	anon_sync_obj_t cookie;
1121 
1122 	mutex_enter(&sp->shm_mlock);
1123 	ANON_LOCK_ENTER(&amp->a_rwlock, RW_READER);
1124 	for (anon_idx = 0; npages != 0; anon_idx++, npages--) {
1125 
1126 		anon_array_enter(amp, anon_idx, &cookie);
1127 		ap = anon_get_ptr(amp->ahp, anon_idx);
1128 		ASSERT(ap != NULL);
1129 		swap_xlate(ap, &vp, &off);
1130 		anon_array_exit(&cookie);
1131 
1132 		pp = page_lookup(vp, off, SE_SHARED);
1133 		if (pp == NULL) {
1134 			panic("lock_again: page not in the system");
1135 			/*NOTREACHED*/
1136 		}
1137 		/* page should already be locked by caller */
1138 		ASSERT(pp->p_lckcnt > 0);
1139 		(void) page_pp_lock(pp, 0, 0);
1140 		page_unlock(pp);
1141 	}
1142 	ANON_LOCK_EXIT(&amp->a_rwlock);
1143 	mutex_exit(&sp->shm_mlock);
1144 }
1145 
1146 /*
1147  * Attach the shared memory segment to the process
1148  * address space and lock the pages.
1149  */
1150 static int
1151 shmem_lock(kshmid_t *sp, struct anon_map *amp)
1152 {
1153 	size_t npages = btopr(amp->size);
1154 	struct as *as;
1155 	struct segvn_crargs crargs;
1156 	uint_t error;
1157 
1158 	/*
1159 	 * A later ISM/DISM attach may increase the size of the amp, so
1160 	 * cache the number of pages locked for the future shmem_unlock()
1161 	 */
1162 	sp->shm_lkpages = npages;
1163 
1164 	as = as_alloc();
1165 	/* Initialize the create arguments and map the segment */
1166 	crargs = *(struct segvn_crargs *)zfod_argsp;	/* structure copy */
1167 	crargs.offset = (u_offset_t)0;
1168 	crargs.type = MAP_SHARED;
1169 	crargs.amp = amp;
1170 	crargs.prot = PROT_ALL;
1171 	crargs.maxprot = crargs.prot;
1172 	crargs.flags = 0;
1173 	error = as_map(as, 0x0, amp->size, segvn_create, &crargs);
1174 	if (!error) {
1175 		if ((error = as_ctl(as, 0x0, amp->size, MC_LOCK, 0, 0,
1176 		    NULL, 0)) == 0) {
1177 			lock_again(npages, sp, amp);
1178 		}
1179 		(void) as_unmap(as, 0x0, amp->size);
1180 	}
1181 	as_free(as);
1182 	return (error);
1183 }
1184 
1185 
1186 /*
1187  * Unlock shared memory
1188  */
1189 static void
1190 shmem_unlock(kshmid_t *sp, struct anon_map *amp)
1191 {
1192 	struct anon *ap;
1193 	pgcnt_t npages = sp->shm_lkpages;
1194 	struct vnode *vp;
1195 	struct page *pp;
1196 	u_offset_t off;
1197 	ulong_t anon_idx;
1198 	size_t unlocked_bytes = 0;
1199 	kproject_t	*proj;
1200 	anon_sync_obj_t cookie;
1201 
1202 	proj = sp->shm_perm.ipc_proj;
1203 	mutex_enter(&sp->shm_mlock);
1204 	ANON_LOCK_ENTER(&amp->a_rwlock, RW_READER);
1205 	for (anon_idx = 0; anon_idx < npages; anon_idx++) {
1206 
1207 		anon_array_enter(amp, anon_idx, &cookie);
1208 		if ((ap = anon_get_ptr(amp->ahp, anon_idx)) == NULL) {
1209 			panic("shmem_unlock: null app");
1210 			/*NOTREACHED*/
1211 		}
1212 		swap_xlate(ap, &vp, &off);
1213 		anon_array_exit(&cookie);
1214 		pp = page_lookup(vp, off, SE_SHARED);
1215 		if (pp == NULL) {
1216 			panic("shmem_unlock: page not in the system");
1217 			/*NOTREACHED*/
1218 		}
1219 		/*
1220 		 * Page should at least have once lock from previous
1221 		 * shmem_lock
1222 		 */
1223 		ASSERT(pp->p_lckcnt > 0);
1224 		page_pp_unlock(pp, 0, 0);
1225 		if (pp->p_lckcnt == 0)
1226 			unlocked_bytes += PAGESIZE;
1227 
1228 		page_unlock(pp);
1229 	}
1230 
1231 	if (unlocked_bytes > 0) {
1232 		rctl_decr_locked_mem(NULL, proj, unlocked_bytes, 0);
1233 	}
1234 
1235 	ANON_LOCK_EXIT(&amp->a_rwlock);
1236 	mutex_exit(&sp->shm_mlock);
1237 }
1238 
1239 /*
1240  * We call this routine when we have removed all references to this
1241  * amp.  This means all shmdt()s and the IPC_RMID have been done.
1242  */
1243 static void
1244 shm_rm_amp(kshmid_t *sp)
1245 {
1246 	struct anon_map *amp = sp->shm_amp;
1247 	zone_t *zone;
1248 
1249 	zone = sp->shm_perm.ipc_zone;
1250 	ASSERT(zone != NULL);
1251 	/*
1252 	 * Free up the anon_map.
1253 	 */
1254 	lgrp_shm_policy_fini(amp, NULL);
1255 	ANON_LOCK_ENTER(&amp->a_rwlock, RW_WRITER);
1256 	anonmap_purge(amp);
1257 	if (amp->a_szc != 0) {
1258 		anon_shmap_free_pages(amp, 0, amp->size);
1259 	} else {
1260 		anon_free(amp->ahp, 0, amp->size);
1261 	}
1262 	ANON_LOCK_EXIT(&amp->a_rwlock);
1263 	anon_unresv_zone(amp->swresv, zone);
1264 	anonmap_free(amp);
1265 }
1266 
1267 /*
1268  * Return the shared memory id for the process's virtual address.
1269  * Return SHMID_NONE if addr is not within a SysV shared memory segment.
1270  * Return SHMID_FREE if addr's SysV shared memory segment's id has been freed.
1271  *
1272  * shmgetid() is called from code in /proc with the process locked but
1273  * with pp->p_lock not held.  The address space lock is held, so we
1274  * cannot grab pp->p_lock here due to lock-ordering constraints.
1275  * Because of all this, modifications to the p_segacct list must only
1276  * be made after calling prbarrier() to ensure the process is not locked.
1277  * See shmdt() and sa_add(), above. shmgetid() may also be called on a
1278  * thread's own process without the process locked.
1279  */
1280 int
1281 shmgetid(proc_t *pp, caddr_t addr)
1282 {
1283 	segacct_t *sap, template;
1284 
1285 	ASSERT(MUTEX_NOT_HELD(&pp->p_lock));
1286 	ASSERT((pp->p_proc_flag & P_PR_LOCK) || pp == curproc);
1287 
1288 	if (pp->p_segacct == NULL)
1289 		return (SHMID_NONE);
1290 
1291 	template.sa_addr = addr;
1292 	template.sa_len = 0;
1293 	if ((sap = avl_find(pp->p_segacct, &template, NULL)) == NULL)
1294 		return (SHMID_NONE);
1295 
1296 	if (IPC_FREE(&sap->sa_id->shm_perm))
1297 		return (SHMID_FREE);
1298 
1299 	return (sap->sa_id->shm_perm.ipc_id);
1300 }
1301