ns_file(3aolserver)					    AOLserver Built-In Commands 				       ns_file(3aolserver)

__________________________________________________________________________________________________________________________________________________

NAME

       ns_chmod, ns_cp, ns_cpfp, ns_ftruncate, ns_link, ns_mkdir, ns_rename, ns_rmdir, ns_symlink, ns_truncate, ns_unlink - File manipulation com-
       mands

SYNOPSIS

       ns_chmod option ?arg arg ...?

       ns_cp option ?arg arg ...?

       ns_cpfp option ?arg arg ...?

       ns_ftruncate option ?arg arg ...?

       ns_link option ?arg arg ...?

       ns_mkdir option ?arg arg ...?

       ns_rename option ?arg arg ...?

       ns_rmdir option ?arg arg ...?

       ns_symlink option ?arg arg ...?

       ns_truncate option ?arg arg ...?

       ns_unlink option ?arg arg ...?
_________________________________________________________________

DESCRIPTION

       ns_chmod filename mode
	      Change a file's access permissions.  ns_chmod changes the specified file's permissions to mode, in  the  same  manner  as  the  Unix
	      chmod(1) command-line utility.

       ns_cp -preserve file1 file2
	      Copy  one  file  to another.  ns_cp copies the contents of file1 to file2, just like the Unix "cp" command. The default directory is
	      the home directory for the server.  If -preserve is specified, the copied file will retain the  creation	time,  modification  time,
	      owner, and mode of the original file, just like the Unix "cp -p" command.

       ns_cpfp fileid1 fileid2 ?nbytes?
	      Copy a specified number of bytes from one file to another.  ns_cpfp copies information from one file (fileid1) to another (fileid2).
	      If you specify a number of bytes in the nbytes argument, only the specified number of bytes will be copied. By default,  the  entire
	      file is copied.

       ns_ftruncate fileid ?length?
	      Truncate	an open file to a specified length.  ns_ftruncate causes the open file specified by fileid to have a size of length bytes.
	      If length is not specified, it causes the file to have a size of zero bytes. The file must be open and be a regular file.

       ns_link ?-nocomplain? filename1 filename2
	      Create a link.  ns_link creates a link named filename2 that points to the file specified by filename1. If  the  link  fails,  a  Tcl
	      error is generated, unless -nocomplain is specified.

       ns_mkdir path
	      Create  a directory.  ns_mkdir creates the directory named PATH, just like the Unix mkdir command. By default, under Unix the direc-
	      tory is created with the file permissions set to 0755 (rwxr-xr-x.). These permissions can be modified by setting the umask parameter
	      for the server.

       ns_rename file1 file2
	      Rename  a  file.	 ns_rename  renames  the  first file (file1) to the file name specified by file2. Make sure that the files and the
	      directories in which the files exist are read/write accessible to the username that's running the AOLserver.

       ns_rmdir path
	      Remove a directory.  ns_rmdir removes the directory named path, just like the Unix rmdir command.  The  directory  must  already	be
	      empty.

       ns_unlink [-nocomplain] filename
	      Remove  a  file.	ns_unlink attempts to remove the file filename. If -nocomplain is not passed in and the removal fails, a Tcl error
	      is generated.

       ns_truncate filename ?length?
	      Truncate a file to a specified length.  ns_truncate causes the file specified by filename to have a size of length bytes. If  length
	      is not specified, it causes filename to have a size of zero bytes. The file must exist and be a regular file.

       ns_unlink [-nocomplain] filename
	      Remove  a  file.	ns_unlink attempts to remove the file filename. If -nocomplain is not passed in and the removal fails, a Tcl error
	      is generated.

SEE ALSO

       ns_chmod, ns_cp, ns_cpfp, ns_ftruncate, ns_link, ns_mkdir, ns_rename, ns_rmdir, ns_symlink, ns_truncate, ns_unlink

KEYWORDS

AOLserver								4.0						       ns_file(3aolserver)