FunctionPackage: systemToCDocOverviewCGDocRelNotesIndexPermutedIndex
Allegro CL version 6.1
Unrevised

copy-file

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

Copies from-pathname to to-pathname.

The link argument only has meaning on UNIX platforms (symbolic and hard links are not supported on Windows) so it is ignored on Windows. On UNIX, it can have the following values:

Note change effective in release 6.0: in releases 5.0.1 and earlier, the link was named link-ok, and defaulted to :hard instead on nil.

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. Because symbolic links are not supported on Windows, this argument has meaning on UNIX only. preserve-symbolic-links defaults to nil.

element-type is given to open when from-pathname and to-pathname are opened and created, respectively. element-type defaults to (unsigned-byte 8).

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

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.


Copyright (c) 1998-2001, Franz Inc. Berkeley, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.1 update # 1. This page was not revised.
Created 2001.12.15.

ToCDocOverviewCGDocRelNotesIndexPermutedIndex
Allegro CL version 6.1
Unrevised