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

NAME

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

SYNOPSIS

9       pmlogmv [-fNV?]  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  re‐
22       coverable problems encountered during the execution of pmlogmv, all the
23       files associated with oldname will be preserved, and no new files  with
24       the  newname  prefix will be created.  ``Recoverable problems'' include
25       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       -f, --force
38            Normally  pmlogmv  takes a conservative view in respect of newname
39            and will not proceed if newname contains any characters  that  are
40            likely to cause a problem for sh(1).  This includes ``glob'' char‐
41            acters like ``?'', ``*'' and ``['', shell syntax  meta  characters
42            like  ``('', ``|'', ``;'' and ``&'', shell I/O redirection charac‐
43            ters like ``<'' and ``>'', the dollar sign, a space, etc.
44
45            The -f flag forces pmlogmv to proceed, even  if  newname  contains
46            any of these ``unsafe'' characters.
47
48       -N, --showme
49            Perform  a  dry-run,  checking and reporting what changes would be
50            made without making any changes.
51
52       -V, --verbose
53            Enable verbose mode.
54
55       -?, --help
56            Display usage message and exit.
57

DIAGNOSTICS

59       All error and warning messages are intended to be easily understood and
60       errors produce a non-zero exit status.
61

SEE ALSO

63       ln(1) and pmlogger(1).
64
65
66
67Performance Co-Pilot                  PCP                           PMLOGMV(1)
Impressum