share/man/man7d/full.7d

   1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\" Copyright 2017 James S Blachly, MD <james.blachly@gmail.com>
  12 .
  13 .Dd "Feb 7, 2017"
  14 .Dt FULL 7D
  15 .Os
  16 .Sh NAME
  17 .Nm full
  18 .Nd always-full device
  19 .Sh SYNOPSIS
  20 .Pa /dev/full
  21 .Sh DESCRIPTION
  22 The
  23 .Nm
  24 device is used to test program behavior in out-of-space conditions.
  25 .Lp
  26 Writes always yield the error
  27 .Er ENOSPC.
  28 .Lp
  29 Reads supply an endless stream of zeros, identical to
  30 .Xr zero 7D
  31 .Lp
  32 .Xr lseek 2
  33 will always return successfully.
  34 .Lp
  35 .Xr mmap 2
  36 is not implemented.
  37 .Sh FILES
  38 .
  39 .Bl -tag -width Pa
  40 .It Pa /dev/full
  41 .El
  42 .
  43 .Sh SEE ALSO
  44 .Xr mem 7D ,
  45 .Xr null 7D ,
  46 .Xr zero 7D