1LINK(P)                    POSIX Programmer's Manual                   LINK(P)
2
3
4

NAME

6       link - call link function
7

SYNOPSIS

9       link file1 file2
10

DESCRIPTION

12       The link utility shall perform the function call:
13
14
15              link(file1, file2);
16
17       A user may need appropriate privilege to invoke the link utility.
18

OPTIONS

20       None.
21

OPERANDS

23       The following operands shall be supported:
24
25       file1  The pathname of an existing file.
26
27       file2  The pathname of the new directory entry to be created.
28
29

STDIN

31       Not used.
32

INPUT FILES

34       Not used.
35

ENVIRONMENT VARIABLES

37       The following environment variables shall affect the execution of link:
38
39       LANG   Provide  a  default value for the internationalization variables
40              that are unset or null. (See  the  Base  Definitions  volume  of
41              IEEE Std 1003.1-2001,  Section  8.2,  Internationalization Vari‐
42              ables for the precedence of internationalization variables  used
43              to determine the values of locale categories.)
44
45       LC_ALL If  set  to a non-empty string value, override the values of all
46              the other internationalization variables.
47
48       LC_CTYPE
49              Determine the locale for  the  interpretation  of  sequences  of
50              bytes  of  text  data as characters (for example, single-byte as
51              opposed to multi-byte characters in arguments).
52
53       LC_MESSAGES
54
55              Determine the locale that should be used to  affect  the  format
56              and contents of diagnostic messages written to standard error.
57
58       NLSPATH
59              Determine the location of message catalogs for the processing of
60              LC_MESSAGES .
61
62

ASYNCHRONOUS EVENTS

64       Default.
65

STDOUT

67       None.
68

STDERR

70       The standard error shall be used only for diagnostic messages.
71

OUTPUT FILES

73       None.
74

EXTENDED DESCRIPTION

76       None.
77

EXIT STATUS

79       The following exit values shall be returned:
80
81        0     Successful completion.
82
83       >0     An error occurred.
84
85

CONSEQUENCES OF ERRORS

87       Default.
88
89       The following sections are informative.
90

APPLICATION USAGE

92       None.
93

EXAMPLES

95       None.
96

RATIONALE

98       None.
99

FUTURE DIRECTIONS

101       None.
102

SEE ALSO

104       ln , unlink() , the System Interfaces volume  of  IEEE Std 1003.1-2001,
105       link()
106

108       Portions  of  this text are reprinted and reproduced in electronic form
109       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
110       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
111       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
112       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the
113       event of any discrepancy between this version and the original IEEE and
114       The  Open Group Standard, the original IEEE and The Open Group Standard
115       is the referee document. The original Standard can be  obtained  online
116       at http://www.opengroup.org/unix/online.html .
117
118
119
120IEEE/The Open Group                  2003                              LINK(P)
Impressum