Return to pmv.n CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / spms / man / mann

Annotation of 43BSDTahoe/new/spms/man/mann/pmv.n, revision 1.1.1.1

1.1       root        1: .TH PMV 1P "22 June 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: pmv \- move or rename files
                      5: .SH SYNOPSIS
                      6: .B pmv
                      7: [\fB\-f\^i\fR] [\fB\-\fR] file1 file2
                      8: .PP
                      9: .B pmv
                     10: [\fB\-f\^i\fR] [\fB\-\fR] file ... dirname
                     11: .SH DESCRIPTION
                     12: .I Pmv
                     13: moves (changes the name of)
                     14: .I file1
                     15: to
                     16: .I file2.
                     17: If
                     18: .I file2
                     19: already exists, it is removed before
                     20: .I file1
                     21: is moved. If
                     22: .I file2
                     23: has a mode that forbids
                     24: writing,
                     25: .I pmv
                     26: prints the mode and reads the standard input to obtain a line. The move
                     27: takes place only if the line begins with \fBy\fR. In the second form,
                     28: one or more
                     29: .I files
                     30: are moved to
                     31: .I dirname
                     32: with their original file names.
                     33: .PP
                     34: .I File
                     35: and
                     36: .I dirname
                     37: may be either regular or project pathnames. However, because
                     38: .I pmv
                     39: interprets both
                     40: .I file
                     41: and
                     42: .I dirname
                     43: arguments as project pathnames, if
                     44: .I file
                     45: matchs the name of a project directory within the same project, then
                     46: .I pmv
                     47: will print the error message `pmv: can't move project directory
                     48: .I file',
                     49: unless
                     50: .I file
                     51: is disguised as ./\fIfile\fR.
                     52: .PP
                     53: .I Pmv
                     54: blindly supercedes
                     55: existing files unless the
                     56: .B \-i
                     57: option is specified.
                     58: .PP
                     59: .I Pmv
                     60: refuses to move a file onto itself.
                     61: .SH OPTIONS
                     62: .TP
                     63: .IP \fB\-f\fR
                     64: Stands for force. This option
                     65: overrides any mode restrictions and the
                     66: .B \-i
                     67: switch.
                     68: .IP \fB\-i\fR
                     69: Interactive mode. Whenever a move is to supercede an existing file,
                     70: the user is prompted by the name of the file followed by a question mark. If
                     71: answered with a line starting with `y', the move continues. Any other reply
                     72: prevents the move from occurring.
                     73: .IP \fB\-\fR
                     74: Interpret all the following arguments to
                     75: .I pmv
                     76: as file names. This allows file names starting with minus.
                     77: .SH "SEE ALSO"
                     78: mv(1)
                     79: .SH DIAGNOSTICS
                     80: Exit status 0 is normal. Exit status 1 indicates an error.
                     81: .SH AUTHOR
                     82: Peter J. Nicklin
                     83: .SH BUGS
                     84: If
                     85: .I file1
                     86: and
                     87: .I file2
                     88: lie on different file systems,
                     89: .I pmv
                     90: must copy the file and delete the original. In this case the owner name
                     91: becomes that of the copying process and any linking relationship with
                     92: other files is lost.

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