manual page distributed with 4.1BSD
[unix-history] / usr / src / lib / libc / sys / mknod.2
.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" @(#)mknod.2 4.1 (Berkeley) %G%
.\"
.TH MKNOD 2
.UC 4
.SH NAME
mknod \- make a directory or a special file
.SH SYNOPSIS
.nf
.B mknod(name, mode, addr)
.B char *name;
.nf
.SH DESCRIPTION
.I Mknod
creates a new file
whose name is the null-terminated string pointed
to by
.IR name .
The mode of the new file
(including directory and special file bits)
is initialized from
.IR mode .
(The protection part of the mode
is modified by the process's mode mask; see
.IR umask (2)).
The first block pointer of the i-node
is initialized from
.IR addr .
For ordinary files and directories
.I addr
is normally zero.
In the case of a special file,
.I addr
specifies which special file.
.PP
.I Mknod
may be invoked only by the super-user.
.SH "SEE ALSO"
mkdir(1), mknod(1), filsys(5)
.SH DIAGNOSTICS
Zero is returned if the file has been made; \-1
if the file already exists
or if the user is not the super-user.
.SH "ASSEMBLER (PDP-11)"
(mknod = 14.)
.br
.B sys mknod; name; mode; addr