Return to mv.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / bin / mv

Annotation of 43BSDReno/bin/mv/mv.1, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1989, 1990 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted provided
        !             5: .\" that: (1) source distributions retain this entire copyright notice and
        !             6: .\" comment, and (2) distributions including binaries display the following
        !             7: .\" acknowledgement:  ``This product includes software developed by the
        !             8: .\" University of California, Berkeley and its contributors'' in the
        !             9: .\" documentation or other materials provided with the distribution and in
        !            10: .\" all advertising materials mentioning features or use of this software.
        !            11: .\" Neither the name of the University nor the names of its contributors may
        !            12: .\" be used to endorse or promote products derived from this software without
        !            13: .\" specific prior written permission.
        !            14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
        !            15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
        !            16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            17: .\"
        !            18: .\"     @(#)mv.1       6.5 (Berkeley) 7/24/90
        !            19: .\"
        !            20: .Dd July 24, 1990
        !            21: .Dt MV 1
        !            22: .Os BSD 4.4
        !            23: .Sh NAME
        !            24: .Nm mv
        !            25: .Nd move files
        !            26: .Sh SYNOPSIS
        !            27: .Nm mv
        !            28: .Op Fl f Li \&| Fl i
        !            29: .Ar source target
        !            30: .Nm mv
        !            31: .Op  Fl f Li \&| Fl i
        !            32: .Ar source ... source directory
        !            33: .De
        !            34: .Sh DESCRIPTION
        !            35: .Pp
        !            36: In its first form, the
        !            37: .Nm mv
        !            38: utility renames the file named by the
        !            39: .Ar source
        !            40: operand to the destination path named by the
        !            41: .Ar target
        !            42: operand.
        !            43: This form is assumed when the last operand does not name an already
        !            44: existing directory.
        !            45: .Pp
        !            46: In its second form,
        !            47: .Nm mv
        !            48: moves each file named by a
        !            49: .Ar source
        !            50: operand to a destination file in the existing directory named by the
        !            51: .Ar directory
        !            52: operand.
        !            53: The destination path for each operand is the pathname produced by the
        !            54: concatenation of the last operand, a slash, and the final pathname
        !            55: component of the named file.
        !            56: .Pp
        !            57: The following options are available:
        !            58: .Tw Ds
        !            59: .Tp Fl f
        !            60: Do not prompt for confirmation before overwriting the destination
        !            61: path.
        !            62: (The
        !            63: .Fl i
        !            64: option is ignored if the
        !            65: .Fl f
        !            66: option is specified.)
        !            67: .Tp Fl i
        !            68: Causes
        !            69: .Nm mv
        !            70: to write a prompt to standard error before moving a file that would
        !            71: overwrite an existing file.
        !            72: If the response from the standard input begins with the character ``y'',
        !            73: the move is attempted.
        !            74: .Tp
        !            75: .Pp
        !            76: It is an error for either the
        !            77: .Ar source
        !            78: operand or the destination path to specify a directory unless both do.
        !            79: .Pp
        !            80: If the destination path does not have a mode which permits writing,
        !            81: .Nm mv
        !            82: prompts the user for confirmation as specified for the
        !            83: .Fl i
        !            84: option.
        !            85: .Pp
        !            86: As the
        !            87: .Xr rename  2
        !            88: call does not work across file systems,
        !            89: .Nm mv
        !            90: uses
        !            91: .Xr cp  1
        !            92: and
        !            93: .Xr rm  1
        !            94: to accomplish the move.
        !            95: The effect is equivalent to:
        !            96: .Pp
        !            97: .Ds I
        !            98: rm -f destination_path && \e
        !            99: \tcp -pr source_file destination && \e
        !           100: \trm -rf source_file
        !           101: .De
        !           102: .Pp
        !           103: The
        !           104: .Nm mv
        !           105: utility exits 0 on success, and >0 if an error occurs.
        !           106: .Sh SEE ALSO
        !           107: .Xr cp 1
        !           108: .Sh STANDARDS
        !           109: The
        !           110: .Nm mv
        !           111: function is expected to be POSIX 1003.2 compatible.

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