Return to link.2 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man2

Annotation of researchv10dc/man/adm/man2/link.2, revision 1.1.1.1

1.1       root        1: .TH LINK 2
                      2: .CT 2 file_inq_creat
                      3: .SH NAME
                      4: link, symlink, readlink \(mi link to a file
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B int link(name1, name2)
                      8: .B char *name1, *name2;
                      9: .LP
                     10: .B int symlink(name1, name2)
                     11: .B char *name1, *name2;
                     12: .LP
                     13: .B int readlink(name, buf, size)
                     14: .B char *name, *buf;
                     15: .fi
                     16: .SH DESCRIPTION
                     17: .I Link
                     18: and
                     19: .I symlink
                     20: create a link to file
                     21: .I name1
                     22: with new name
                     23: .IR name2 .
                     24: Either name may be an arbitrary path name.
                     25: .PP
                     26: After
                     27: .IR link ,
                     28: .IR name2
                     29: is entirely equivalent to
                     30: .IR name1 ;
                     31: it is a directory entry referring to the same file as
                     32: .IR name1 .
                     33: Only the super-user can make the link if
                     34: .I name1
                     35: is a directory.
                     36: .PP
                     37: After
                     38: .IR symlink ,
                     39: .I name2
                     40: is a new symbolic link;
                     41: when it is encountered in any path name,
                     42: .IR name1
                     43: is substituted for
                     44: .IR name2 ,
                     45: and path name parsing continues.
                     46: If
                     47: .IR name1
                     48: begins with the 
                     49: .L /
                     50: character, it is interpreted with respect to the
                     51: root directory; if not,
                     52: it is interpreted with respect to the directory in which
                     53: .IR name2
                     54: resides.
                     55: .PP
                     56: Symbolic links are slightly slower than normal links but
                     57: may span file systems;
                     58: normal links are confined to a single file system.
                     59: .PP
                     60: .I Readlink
                     61: copies the pathname inside
                     62: symbolic link
                     63: .I name
                     64: into memory at
                     65: .IR buf .
                     66: No more than
                     67: .IR size
                     68: bytes are copied;
                     69: the actual number of bytes read is returned.
                     70: The contents of
                     71: .I buf
                     72: will not be null-terminated.
                     73: An error is returned if
                     74: .I name
                     75: is not a symbolic link.
                     76: .SH "SEE ALSO"
                     77: .IR cp (1), 
                     78: .IR unlink (2), 
                     79: .IR stat (2)
                     80: .SH DIAGNOSTICS
                     81: all:
                     82: .BR EIO ,
                     83: .BR ELOOP ,
                     84: .BR ENOENT ,
                     85: .BR ENOTDIR
                     86: .br
                     87: .IR link :
                     88: .BR EEXIST ,
                     89: .BR EROFS ,
                     90: .BR EXDEV
                     91: .br
                     92: .IR symlink :
                     93: .BR EEXIST ,
                     94: .BR EROFS
                     95: .br
                     96: .IR readlink :
                     97: .BR ENXIO

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.