root/sys/arch/mips/include/mips_param.h
/*      $NetBSD: mips_param.h,v 1.57 2026/05/10 16:07:56 thorpej Exp $  */

/*-
 * Copyright (c) 2013 The NetBSD Foundation, Inc.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef _MIPS_MIPS_PARAM_H_
#define _MIPS_MIPS_PARAM_H_

#ifdef _KERNEL_OPT
#include "opt_cputype.h"
#include "opt_param.h"
#endif

/*
 * No reason this can't be common
 */
#if defined(__MIPSEB__)
# define _MACHINE_SUFFIX eb
# define MACHINE_SUFFIX "eb"
#elif defined(__MIPSEL__)
# define _MACHINE_SUFFIX el
# define MACHINE_SUFFIX "el"
#else
# error neither __MIPSEL__ nor __MIPSEB__ are defined.
#endif

#define ___MACHINE32_OARCH              mips##_MACHINE_SUFFIX
#define __MACHINE32_OARCH               "mips" MACHINE_SUFFIX
#define ___MACHINE32_NARCH              mips64##_MACHINE_SUFFIX
#define __MACHINE32_NARCH               "mips64" MACHINE_SUFFIX
#define ___MACHINE64_NARCH              mipsn64##_MACHINE_SUFFIX
#define __MACHINE64_NARCH               "mipsn64" MACHINE_SUFFIX

#if defined(__mips_n32) || defined(__mips_n64)
# if defined(__mips_n32)
#  define       _MACHINE_ARCH           ___MACHINE32_NARCH
#  define       MACHINE_ARCH            __MACHINE32_NARCH
# else /* __mips_n64 */
#  define       _MACHINE_ARCH           ___MACHINE64_NARCH
#  define       MACHINE_ARCH            __MACHINE64_NARCH
#  define       _MACHINE32_NARCH        ___MACHINE32_NARCH
#  define       MACHINE32_NARCH         __MACHINE32_NARCH
# endif
# define        _MACHINE32_OARCH        ___MACHINE32_OARCH
# define        MACHINE32_OARCH         __MACHINE32_OARCH
#else /* o32 */
# define        _MACHINE_ARCH           ___MACHINE32_OARCH
# define        MACHINE_ARCH            __MACHINE32_OARCH
#endif

/*
 * Userland code should be using uname/sysctl to get MACHINE so simply
 * export a generic MACHINE of "mips"
 */
#ifndef _KERNEL
#undef MACHINE
#define MACHINE "mips"
#endif

#if defined(__mips_n64) || defined(__mips_n32)
#define STACK_ALIGNBYTES        (16 - 1)
#else
#define STACK_ALIGNBYTES        (8 - 1)
#endif

#define STACK_ALIGNBYTES_O32    (8 - 1)

#define ALIGNBYTES32            (sizeof(double) - 1)
#define ALIGN32(p)              (((uintptr_t)(p) + ALIGNBYTES32) &~ALIGNBYTES32)

/*
 * On mips, UPAGES is fixed by sys/arch/mips/mips/locore code
 * to be the number of per-process-wired kernel-stack pages/PTES.
 */

#if (ENABLE_MIPS_16KB_PAGE + ENABLE_MIPS_8KB_PAGE + ENABLE_MIPS_4KB_PAGE) > 1
#error only one of ENABLE_MIPS_{4,8,16}KB_PAGE can be defined.
#endif

#ifndef MSGBUFSIZE
#define MSGBUFSIZE      NBPG            /* default message buffer size */
#endif

/*
 * Most MIPS have a cache line size of 32 bytes, but Cavium chips
 * have a line size 128 bytes and we need to cover the larger size.
 */
#define COHERENCY_UNIT  128
#define CACHE_LINE_SIZE 128

#ifdef ENABLE_MIPS_16KB_PAGE
#define PGSHIFT         14              /* LOG2(NBPG) */
#elif defined(ENABLE_MIPS_8KB_PAGE) \
    || (!defined(ENABLE_MIPS_4KB_PAGE) && __mips >= 3)
#define PGSHIFT         13              /* LOG2(NBPG) */
#else
#define PGSHIFT         12              /* LOG2(NBPG) */
#endif
#define NBPG            (1 << PGSHIFT)  /* bytes/page */
#define PGOFSET         (NBPG - 1)      /* byte offset into page */
#define PTPSHIFT        2
#define PTPLENGTH       (PGSHIFT - PTPSHIFT)
#define NPTEPG          (1 << PTPLENGTH)

#define SEGSHIFT        (PGSHIFT + PTPLENGTH)   /* LOG2(NBSEG) */
#define NBSEG           (1 << SEGSHIFT) /* bytes/segment */
#define SEGOFSET        (NBSEG - 1)     /* byte offset into segment */

#ifdef _LP64
#define SEGLENGTH       (PGSHIFT - 3)
#define XSEGSHIFT       (SEGSHIFT + SEGLENGTH)  /* LOG2(NBXSEG) */
#define NBXSEG          (1UL << XSEGSHIFT)      /* bytes/xsegment */
#define XSEGOFSET       (NBXSEG - 1)    /* byte offset into xsegment */
#define XSEGLENGTH      (PGSHIFT - 3)
#define NXSEGPG         (1 << XSEGLENGTH)
#else
#define SEGLENGTH       (31 - SEGSHIFT)
#endif
#define NSEGPG          (1 << SEGLENGTH)

#ifdef _LP64
#define __MIN_USPACE    16384           /* LP64 needs a 16kB stack */
#else
/*
 * Note for the non-LP64 case, cpu_switch_resume has the assumption
 * that UPAGES == 2.  For MIPS-I we wire USPACE in TLB #0 and #1.
 * For MIPS3+ we wire USPACE in the TLB #0 pair.
 */
#define __MIN_USPACE    8192            /* otherwise use an 8kB stack */
#endif
#define USPACE          MAX(__MIN_USPACE, PAGE_SIZE)
#define UPAGES          (USPACE / PAGE_SIZE) /* number of pages for u-area */
#define USPACE_ALIGN    USPACE          /* make sure it starts on a even VA */
#define UPAGES_MAX      8               /* a (constant) max for userland use */

/*
 * Minimum and maximum sizes of the kernel malloc arena in PAGE_SIZE-sized
 * logical pages.
 */
#define NKMEMPAGES_MIN_DEFAULT  ((8 * 1024 * 1024) >> PAGE_SHIFT)
#define NKMEMPAGES_MAX_DEFAULT  ((128 * 1024 * 1024) >> PAGE_SHIFT)

/*
 * Mach derived conversion macros
 */
#define mips_round_page(x)      ((((uintptr_t)(x)) + NBPG - 1) & ~(NBPG-1))
#define mips_trunc_page(x)      ((uintptr_t)(x) & ~(NBPG-1))
#define mips_btop(x)            ((paddr_t)(x) >> PGSHIFT)
#define mips_ptob(x)            ((paddr_t)(x) << PGSHIFT)

#ifdef __MIPSEL__
#define MID_MACHINE     MID_PMAX        /* MID_PMAX (little-endian) */
#endif
#ifdef __MIPSEB__
#define MID_MACHINE     MID_MIPS        /* MID_MIPS (big-endian) */
#endif

/*
 * Constants related to network buffer management.
 * MCLBYTES must be no larger than NBPG (the software page size), and,
 * on machines that exchange pages of input or output buffers with mbuf
 * clusters (MAPPED_MBUFS), MCLBYTES must also be an integral multiple
 * of the hardware page size.
 */
#ifndef MSIZE
#ifdef _LP64
#define MSIZE           512             /* size of an mbuf */
#else
#define MSIZE           256             /* size of an mbuf */
#endif

#ifndef MCLSHIFT
# define MCLSHIFT       11              /* convert bytes to m_buf clusters */
#endif  /* MCLSHIFT */

#define MCLBYTES        (1 << MCLSHIFT) /* size of a m_buf cluster */

#endif

#endif  /* _MIPS_MIPS_PARAM_H_ */