share/man/man7d/null.7d

   1 '\" te
   2 .\"  Copyright 1989 AT&T
   3 .\" Copyright (C) 2001, Sun Microsystems, Inc.
   4 .\" All Rights Reserved
   5 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   6 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   7 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   8 .TH NULL 7D "Apr 4, 2001"
   9 .SH NAME
  10 null \- the null file, also called the null device
  11 .SH SYNOPSIS
  12 .LP
  13 .nf
  14 \fB/dev/null\fR
  15 .fi
  16
  17 .SH DESCRIPTION
  18 .sp
  19 .LP
  20 Data written on the null special file, \fB/dev/null\fR, is discarded.
  21 .sp
  22 .LP
  23 Reads from a null special file always return 0 bytes.
  24 .sp
  25 .LP
  26 Mapping a null special file creates an address reservation of a length equal to
  27 the length of the mapping, and rounded up to the nearest page size as returned
  28 by \fBsysconf\fR(3C). No resources are consumed by the reservation. Mappings
  29 can be placed in the resulting address range via subsequent calls to \fBmmap\fR
  30 with the \fB-MAP_FIXED\fR option set.
  31 .SH FILES
  32 .sp
  33 .ne 2
  34 .na
  35 \fB\fB/dev/null\fR\fR
  36 .ad
  37 .RS 13n
  38
  39 .RE
  40
  41 .SH SEE ALSO
  42 .sp
  43 .LP
  44 \fBmmap\fR(2), \fBsysconf\fR(3C)