The R Project SVN R

% File src/library/base/man/memlimits.Rd
% Part of the R package, https://www.R-project.org
% Copyright 1995-2023 R Core Team
% Distributed under GPL 2 or later

\name{memlimits}
\alias{mem.maxVSize}
\alias{mem.maxNSize}
\title{Query and Set Heap Size Limits}
\description{
  Query and set the maximal size of the vector heap and the maximal
  number of heap nodes for the current \R process.
}
\usage{
mem.maxVSize(vsize = 0)
mem.maxNSize(nsize = 0)
}
\arguments{
  \item{vsize}{numeric; new size limit in Mb.}
  \item{nsize}{numeric; new maximal node number.}
}
\details{
  New limits lower than current usage are ignored.
  Specifying a size of \code{Inf} sets the limit to the maximal possible
  value for the platform.

  The default maximal values are unlimited on most platforms, but can be
  adjusted using environment variables as described in
  \code{\link{Memory}}. On macOS a lower default vector heap limit is
  used to protect against the \R process being killed when macOS
  over-commits memory.

  Adjusting the maximal number of nodes is rarely necessary. Adjusting
  the vector heap size limit can be useful on macOS in particular but
  should be done with caution.
}
\value{
  The current or new value, in Mb for \code{mem.maxVSize}. \code{Inf} is
  returned if the current value is unlimited.
}

\seealso{
  \code{\link{Memory}}.
}
\keyword{utilities}