Mac Developer Library Developer
Search

 

This manual page is for Mac OS X version 10.9

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.




PLUTIL(1)                 BSD General Commands Manual                PLUTIL(1)

NAME
     plutil -- property list utility

SYNOPSIS
     plutil [command_option] [other_options] file
             ...

DESCRIPTION
     plutil can be used to check the syntax of property list files, or convert a plist file from one format
     to another.  Specifying - as an input file reads from stdin.

     The first argument indicates the operation to perform, one of:

     -help         Show the usage information for the command and exit.

     -p            Print the property list in a human-readable fashion. The output format is not stable and
                   not designed for machine parsing. The purpose of this command is to be able to easily
                   read the contents of a plist file, no matter what format it is in.

     -lint         Check the named property list files for syntax errors.  This is the default command
                   option if none is specified.

     -convert fmt  Convert the named file to the indicated format and write back to the file system.  If the
                   file can't be loaded due to invalid syntax, the operation fails.

                   fmt is one of:  xml1, for version 1 of the XML plist format binary1, for version 1 of the
                                   binary plist format json, for the JSON format

     There are a few additional options:

     --            Specifies that all further arguments are file names

     -s            Don't print anything on success.

     -r            For JSON, add whitespace and indentation to make the output more human-readable.

     -o path       Specify an alternate path name for the result of the -convert operation; this option is
                   only useful with a single file to be converted.  Specifying - as the path outputs to std-out. stdout.
                   out.

     -e extension  Specify an alternate extension for converted files, and the output file names are other-wise otherwise
                   wise the same.

DIAGNOSTICS
     The plutil command exits 0 on success, and 1 on failure.

SEE ALSO
     plist(5)

STANDARDS
     The plutil command obeys no one's rules but its own.

HISTORY
     The plutil command first appeared in Mac OS X 10.2.

Mac OS X                        August 30, 2002                       Mac OS X

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Feedback