Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   9087 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

STACK(9)		 BSD Kernel Developer's Manual		      STACK(9)

NAME
     STACK — stack macros

SYNOPSIS
     #include <sys/param.h>

     type
     STACK_ALLOC(sp, size);

     type
     STACK_MAX(sp, size);

     type
     STACK_ALIGN(sp, bytes);

     type
     STACK_GROW(sp, size);

     type
     STACK_SHRINK(sp, size);

DESCRIPTION
     A stack is an area of memory with a fixed origin but with a variable
     size.  A stack pointer points to the most recently referenced location on
     the stack.	 Initially, when the stack has a size of zero, the stack
     pointer points to the origin of the stack.	 When data items are added to
     the stack, the stack pointer moves away from the origin.

     The STACK_ALLOC() macro returns a pointer to allocated stack space of
     some size.	 Given the returned pointer sp and size, STACK_MAX() returns
     the maximum stack address of the allocated stack space.  The
     STACK_ALIGN() macro can be used to align the stack pointer sp by the
     specified amount of bytes.

     Two basic operations are common to all stacks: a data item is added
     (“push”) to the location pointed by sp or a data item is removed (“pop”)
     from the stack.  The stack pointer must be subsequently adjusted by the
     size of the data item.  The STACK_GROW() and STACK_SHRINK() macros adjust
     the stack pointer sp by given size.

     A stack may grow either up or down.  The described macros take this into
     account by using the __MACHINE_STACK_GROWS_UP preprocessor define.

SEE ALSO
     param(3), queue(3)

BSD				 April 8, 2011				   BSD

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome