Return to link CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT

Annotation of coherent/a/usr/man/COHERENT/link, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: link()                 COHERENT System Call                link()
                      4: 
                      5: 
                      6: 
                      7: 
                      8: Create a link
                      9: 
                     10: lliinnkk(_o_l_d, _n_e_w)
                     11: cchhaarr *_o_l_d, *_n_e_w;
                     12: 
                     13: A link to a file is another name for the file.  All attributes of
                     14: the file appear identical among all links.
                     15: 
                     16: link creates a link called new to an existing file named old.
                     17: 
                     18: For administrative  reasons, it is an error  for users other than
                     19: the superuser  to create a  link to a directory.   Such links can
                     20: make the  file system no longer  tree structured unless carefully
                     21: controlled, posing problems for commands such as find.
                     22: 
                     23: ***** Example *****
                     24: 
                     25: This example, called lock.c, demonstrates how link can be used to
                     26: perform intertask  locking.  With  this technique, a  program can
                     27: start a  process in the  background and stop any  other user from
                     28: starting the identical process.
                     29: 
                     30: 
                     31: main()
                     32: {
                     33:         if(link("lock.c", "lockfile") == -1) {
                     34:                 printf("Cannot link\n");
                     35:                 exit(1);
                     36:         }
                     37: 
                     38: 
                     39: 
                     40:         sleep(50);      /* do nothing for 50 seconds */
                     41:         unlink("lockfile");
                     42:         printf("done\n");
                     43:         exit(0);
                     44: }
                     45: 
                     46: 
                     47: ***** See Also *****
                     48: 
                     49: COHERENT system calls, find, ln, unlink()
                     50: 
                     51: ***** Diagnostics *****
                     52: 
                     53: link  returns zero  when successful.   It  returns -1  on errors,
                     54: e.g., old  does not  exist, new  already exists, attempt  to link
                     55: across file systems, or no permission to create new in the target
                     56: directory.
                     57: 
                     58: ***** Notes *****
                     59: 
                     60: Because  each mounted  file  system is  a self-contained  entity,
                     61: links between different mounted file systems fail.
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: link()                 COHERENT System Call                link()
                     70: 
                     71: 
                     72: 
                     73: 
                     74: 
                     75: 
                     76: 
                     77: 
                     78: 
                     79: 
                     80: 
                     81: 
                     82: 
                     83: 
                     84: 
                     85: 
                     86: 
                     87: 
                     88: 
                     89: 
                     90: 
                     91: 
                     92: 
                     93: 
                     94: 
                     95: 
                     96: 
                     97: 
                     98: 
                     99: 
                    100: 
                    101: 
                    102: 
                    103: 
                    104: 
                    105: 
                    106: 
                    107: 
                    108: 
                    109: 
                    110: 
                    111: 
                    112: 
                    113: 
                    114: 
                    115: 
                    116: 
                    117: 
                    118: 
                    119: 
                    120: 
                    121: 
                    122: 
                    123: 
                    124: 
                    125: 
                    126: 
                    127: 
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 

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