← Back to branch summary

~ubuntu-branches/ubuntu/maverick/python3.1/maverick

« back to all changes in this revision

Viewing changes to Lib/plat-os2emx/_emx_link.py

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2009-03-23 00:01:27 UTC
  • Revision ID: james.westby@ubuntu.com-20090323000127-5fstfxju4ufrhthq
Tags: upstream-3.1~a1+20090322
Import upstream version 3.1~a1+20090322

Show diffs side-by-side

added added

removed removed

Lines of Context:
Lib/plat-os2emx/_emx_link.py
 
1
# _emx_link.py
 
2
 
 
3
# Written by Andrew I MacIntyre, December 2002.
 
4
 
 
5
"""_emx_link.py is a simplistic emulation of the Unix link(2) library routine
 
6
for creating so-called hard links.  It is intended to be imported into
 
7
the os module in place of the unimplemented (on OS/2) Posix link()
 
8
function (os.link()).
 
9
 
 
10
We do this on OS/2 by implementing a file copy, with link(2) semantics:-
 
11
  - the target cannot already exist;
 
12
  - we hope that the actual file open (if successful) is actually
 
13
    atomic...
 
14
 
 
15
Limitations of this approach/implementation include:-
 
16
  - no support for correct link counts (EMX stat(target).st_nlink
 
17
    is always 1);
 
18
  - thread safety undefined;
 
19
  - default file permissions (r+w) used, can't be over-ridden;
 
20
  - implemented in Python so comparatively slow, especially for large
 
21
    source files;
 
22
  - need sufficient free disk space to store the copy.
 
23
 
 
24
Behaviour:-
 
25
  - any exception should propagate to the caller;
 
26
  - want target to be an exact copy of the source, so use binary mode;
 
27
  - returns None, same as os.link() which is implemented in posixmodule.c;
 
28
  - target removed in the event of a failure where possible;
 
29
  - given the motivation to write this emulation came from trying to
 
30
    support a Unix resource lock implementation, where minimal overhead
 
31
    during creation of the target is desirable and the files are small,
 
32
    we read a source block before attempting to create the target so that
 
33
    we're ready to immediately write some data into it.
 
34
"""
 
35
 
 
36
import os
 
37
import errno
 
38
 
 
39
__all__ = ['link']
 
40
 
 
41
def link(source, target):
 
42
    """link(source, target) -> None
 
43
 
 
44
    Attempt to hard link the source file to the target file name.
 
45
    On OS/2, this creates a complete copy of the source file.
 
46
    """
 
47
 
 
48
    s = os.open(source, os.O_RDONLY | os.O_BINARY)
 
49
    if os.isatty(s):
 
50
        raise OSError(errno.EXDEV, 'Cross-device link')
 
51
    data = os.read(s, 1024)
 
52
 
 
53
    try:
 
54
        t = os.open(target, os.O_WRONLY | os.O_BINARY | os.O_CREAT | os.O_EXCL)
 
55
    except OSError:
 
56
        os.close(s)
 
57
        raise
 
58
 
 
59
    try:
 
60
        while data:
 
61
            os.write(t, data)
 
62
            data = os.read(s, 1024)
 
63
    except OSError:
 
64
        os.close(s)
 
65
        os.close(t)
 
66
        os.unlink(target)
 
67
        raise
 
68
 
 
69
    os.close(s)
 
70
    os.close(t)
 
71
 
 
72
if __name__ == '__main__':
 
73
    import sys
 
74
    try:
 
75
        link(sys.argv[1], sys.argv[2])
 
76
    except IndexError:
 
77
        print('Usage: emx_link <source> <target>')
 
78
    except OSError:
 
79
        print('emx_link: %s' % str(sys.exc_info()[1]))