paclient.exe, the Platform Assistant Client Application

Go Up to Command Line Utilities Index

Go Up to Installing and Running the Platform Assistant on the Target Platform

Description

paclient.exe is the client for paserver.exe, the Platform Assistant server. You need to install and run the Platform Assistant on the target platform in order to run, debug, or deploy a cross-platform application in the IDE. You must explicitly install paserver on your remote target platform. paclient, on the other hand, is part of the product installation on the development PC.

The role of paclient is to update the local file cache with files and symbolic information from the remote host. If you use the IDE instead of command line utilities, you might have no need to use paclient at all.

Example

The following command deletes files from the server installation on a Mac OS X remote target platform that has IP address 10.20.10.206. All files are deleted that are related to MyOldRemoteProfile. The ./ (dot-slash) indicates that the directory list is relative to the directory where paserver is installed on the target platform, and ** means that all subdirectories are searched:

> paclient --host=10.20.10.206 --Remove=./**/* MyOldRemoteProfile

Command-Line Help

Here is the command line help for paclient.exe:

> paclient -?
 
Platform Assistant Client  Version 1.0.2
Copyright (c) 2010-2011 Embarcadero Technologies, Inc.

Usage: paclient [<options>] ProfileName

where <options> include:
  -h<name> or --host=<name>
      Specify the name or IP address of the remote/host machine running the
      Platform Assistant Server
  -p<number> or --port=<number>
      Specify the port the Platform Assistant Server is configured for. Default
      to 64211
  -m<platform> or --platform=<platform>
      Specify the target platform. Possible values are "Win32", "OSX32",
      "Win64"
  -a<file/dir> or --add=<file/dir>
      Add file/dir to the list of items to be cached. You may specify multiple
      file/dir separated with ';'. You may also use this option more than once.
      File/dir can include wildcard characters (e.g. --add=c:\abc\**\*.* where
      ** indicates to include all sub-directories of abc)
  -ai<file/dir> or --addinclude=<file/dir>
      Add include file/dir to the list of items to be cached. You may specify
      multiple file/dir separated with ';'. You may also use this option
      more than once.
      File/dir can include wildcard characters (e.g. --addinclude=c:\abc\**\*.*
      where ** indicates to include all sub-directories of abc)
  -al<file/dir> or --addlibrary=<file/dir>
      Add library file/dir to the list of items to be cached. You may specify
      multiple file/dir separated with ';'. You may also use this option more
      than once.
      File/dir can include wildcard characters (e.g. --addlibrary=c:\abc\**\*.*
      where ** indicates to include all sub-directories of abc)
  -af<dir>[,*] or --addframework=<dir>[,*]
      Add framework files to the list of items to be cached. You may specify
      multiple dir separated with ';'. You may also use this option more than
      once
  -u<file/dir>[,<destdir>][,<flags>][,<destname>] or
  --put=<file/dir>[,<destdir>][,<flags>][,<destname>]
      Copy file/dir to the remote/host machine running the Platform Assistant
      Server. You may specify multiple file/dir,destdir,flag,destname separated
      with ';'. You may also use this option more than once. Possible flags
      values are "0", "1", "2", "3", "5" where 0 for normal file, 1 for
      runnable file, 2 for archive file, 3 for executable file, and 5 for
      script file.
      File/dir can include wildcard characters (e.g. --put=c:\abc\**\*.* where
      ** indicates to include all sub-directories of abc)
  -r<file/dir> or --remove=<file/dir>
      Remove file/dir from the list of items to be cached locally. You may
      specify multiple file/dir separated with ';'. You may also use this
      option more than once.
      File/dir can include wildcard characters (e.g. --remove=c:\abc\**\*.*
      where ** indicates to include all sub-directories of abc)
  -R<file/dir> or --Remove=<file/dir>
      Remove file/dir from the remote/host machine running the Platform
      Assistant Server. You may specify multiple file/dir separated with ';'.
      You may also use this option more than once.
      File/dir can include wildcard characters (e.g. --Remove=c:\abc\**\*.*
      where ** indicates to include all sub-directories of abc)
  -l or --local
      Update and display information about the specified Profile without
      initiating a connection to the Platform Assistant Server
  -s<dir> or --sysroot=<dir>
      Indicate the local directory where the remote files will be cached.
      Default to %USERPROFILE%\Documents\RAD Studio\Profiles\<ProfileName>
  -t<number> or --timeout=<number>
      Specify the timeout in seconds when connecting to the Platform Assistant
      Server. Default to 0 second
  -e<number> or --error=<number>
      Stop copy after n errors. Default to 20 errors
  -k or --keep
      Keep files whose source time is different than the destination time
  -pw<text> or --password=<text>
      Specify the login password for the Platform Assistant Server
  -pk<text> or --passkey=<text>
      Specify the login password (encrypted) for the Platform Assistant Server
  -pf<file> or --passfile=<file>
      Specify the login passfile for the Platform Assistant Server
  -v or --verbose
      Print out the files processed
  -? or --help
      Print this help screen

See Also

• Installing and Running the Platform Assistant on the Target Platform