1PMLOGMV(1)                  General Commands Manual                 PMLOGMV(1)
2
3
4

NAME

6       pmlogmv - move (rename) Performance Co-Pilot archive files
7

SYNOPSIS

9       pmlogmv [-NV?]  oldname newname
10

DESCRIPTION

12       A Performance Co-Pilot (PCP) archive consists of multiple files as cre‐
13       ated by pmlogger(1).  pmlogmv allows all the files of a single PCP  ar‐
14       chive to be moved or renamed as a group in a single operation.
15
16       The  oldname  argument identifies the target archive, and may be either
17       the basename that is common to all files in that archive or one of  the
18       archive's files.  The new archive's basename is newname.
19
20       Because  PCP archives are important records of system activity, special
21       care is taken to ensure the  integrity  of  an  archive's  files.   For
22       recoverable  problems  encountered during the execution of pmlogmv, all
23       the files associated with oldname will be preserved, and no  new  files
24       with  the  newname  prefix  will  be created.  ``Recoverable problems''
25       include signals that can be caught (such as SIGHUP, SIGINT, SIGQUIT and
26       SIGTERM),  permissions  issues, new files already existing, file system
27       full events, etc.
28
29       The implementation of pmlogmv uses hard links in the file system and so
30       follows the semantic restrictions of ln(2) which for most systems means
31       the directories containing both the oldname and the newname PCP archive
32       files need to be writeable and within the same file system.
33

OPTIONS

35       The available command line options are:
36
37       -N, --showme
38            Perform  a  dry-run,  checking and reporting what changes would be
39            made without making any changes.
40
41       -V, --verbose
42            Enable verbose mode.
43
44       -?, --help
45            Display usage message and exit.
46

DIAGNOSTICS

48       All error and warning messages are intended to be easily understood and
49       errors produce a non-zero exit status.
50

SEE ALSO

52       ln(2) and pmlogger(1).
53
54
55
56Performance Co-Pilot                  PCP                           PMLOGMV(1)
Impressum