copy-file

Function

Package: system

Arguments: from-pathname to-pathname &key link preserve-symbolic-links element-type preserve-time

Copies from-pathname to to-pathname. If link is t, then copy by creating a symbolic link. If link is :hard, then copy by creating a hard link. If link is nil, just copy the file. link defaults to nil.

Note change in release 6.0: in releases 5.0.1 and earlier, the link was named link-ok, and defaulted to :hard. The link-ok argument is accepted in release 6.0, but a warning is signaled. We recommend changing link-ok to link. Note too that link-ok defaults to nil in 6.0 as does link, so if you want the behavior of :hard, you must specify it. Do not specify both link and link-ok.

If preserve-symbolic-links is true, copy a symbolic link by making a symbolic link, otherwise copy normally--link is ignored if from-pathname is a symbolic link.

element-type is given to open when from-pathname and to-pathname are opened and created, respectively.

If preserve-time is true, then the time on to-pathname is set to be the same as from-pathname.

Both from-pathname and to-pathname can be streams, in which case all the keyword arguments are ignored. This allows for copying bytes from one stream to another.

See Environment functions in os-interface.htm for information on file and directory information and manipulation functions in Allegro CL.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.