packaging/macosx/Read_me_first.rtf

   1 {\rtf1\ansi\ansicpg1252\cocoartf1187\cocoasubrtf400
   2 \cocoascreenfonts1{\fonttbl\f0\froman\fcharset0 TimesNewRomanPSMT;\f1\fswiss\fcharset0 Helvetica;\f2\fnil\fcharset0 Menlo-Regular;
   3 }
   4 {\colortbl;\red255\green255\blue255;}
   5 {\*\listtable{\list\listtemplateid1\listhybrid{\listlevel\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{decimal\}.}{\leveltext\leveltemplateid1\'02\'00.;}{\levelnumbers\'01;}\fi-360\li720\lin720 }{\listname ;}\listid1}
   6 {\list\listtemplateid2\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{disc\}}{\leveltext\leveltemplateid101\'01\uc0\u8226 ;}{\levelnumbers;}\fi-360\li720\lin720 }{\listname ;}\listid2}
   7 {\list\listtemplateid3\listhybrid{\listlevel\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{decimal\}.}{\leveltext\leveltemplateid201\'02\'00.;}{\levelnumbers\'01;}\fi-360\li720\lin720 }{\listname ;}\listid3}
   8 {\list\listtemplateid4\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{disc\}}{\leveltext\leveltemplateid301\'01\uc0\u8226 ;}{\levelnumbers;}\fi-360\li720\lin720 }{\listname ;}\listid4}}
   9 {\*\listoverridetable{\listoverride\listid1\listoverridecount0\ls1}{\listoverride\listid2\listoverridecount0\ls2}{\listoverride\listid3\listoverridecount0\ls3}{\listoverride\listid4\listoverridecount0\ls4}}
  10 \margl1440\margr1440\vieww13060\viewh12960\viewkind0
  11 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  12
  13 \f0\b\fs28 \cf0 Before You Begin\
  14 \
  15 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  16
  17 \f1\b0\fs24 \cf0 This release of Wireshark requires Macintosh OS X 10.5.5 or later. If you are running OS X 10.5.4 or older you can install using another packaging system such as MacPorts or Homebrew.
  18 \f0\b\fs28 \
  19 \
  20 Quick Setup\
  21 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  22
  23 \b0\fs24 \cf0 \
  24 \pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\pardirnatural
  25 \ls1\ilvl0
  26 \f1 \cf0 Simply double-click the Wireshark package. For details about the installation read below.\
  27 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  28 \cf0 \
  29 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  30
  31 \f0\b\fs28 \cf0 What changes does the installer make?\
  32 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  33
  34 \b0\fs24 \cf0 \
  35 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  36
  37 \f1 \cf0 The installer writes to the following locations:\
  38 \
  39 \pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\pardirnatural
  40 \ls2\ilvl0\cf0 {\listtext       \'95    }
  41 \i /Applications/Wireshark.app
  42 \i0 . The main Wireshark application.\
  43 {\listtext      \'95    }
  44 \i /Library/LaunchDaemons/org.wireshark.ChmodBPF.plist
  45 \i0 . A launch daemon that adjusts permissions on the system's packet capture devices (
  46 \i /dev/bpf
  47 \i0 *) when the system starts up.\
  48 {\listtext      \'95    }
  49 \i /Library/Application Support/Wireshark/ChmodBPF
  50 \i0  A copy of the launch daemon property list, and the script that the launch daemon runs.\
  51 {\listtext      \'95    }
  52 \i /usr/local/bin
  53 \i0 . A wrapper script and symbolic links which will let you run Wireshark and its associated utilities from the command line. You can access them directly or by adding /usr/local/bin to your PATH if it's not already in your PATH.\
  54 \pard\tx560\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  55 \cf0 \
  56 Additionally a group named
  57 \i access_bpf
  58 \i0  is created. The user who opened the package is added to the group.\
  59 \
  60 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  61
  62 \f0\b\fs28 \cf0 How do I uninstall?\
  63 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  64
  65 \b0\fs24 \cf0 \
  66 \pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\pardirnatural
  67 \ls3\ilvl0
  68 \f1 \cf0 {\listtext     1.      }Remove
  69 \i /Applications/Wireshark.app
  70 \i0 \
  71 {\listtext      2.      }Remove
  72 \i /Library/Application Support/Wireshark
  73 \i0 \
  74 {\listtext      3.      }Remove the wrapper scripts from
  75 \i /usr/local/bin
  76 \i0 \
  77 {\listtext      4.      }Unload the
  78 \i org.wireshark.ChmodBPF.plist
  79 \i0  launchd job\
  80 {\listtext      5.      }Remove
  81 \i /Library/LaunchDaemons/org.wireshark.ChmodBPF.plist
  82 \i0 \
  83 {\listtext      6.      }Remove the
  84 \i access_bpf
  85 \i0  group.\
  86 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  87
  88 \f0\b\fs28 \cf0 \
  89 How does the wrapper script work? What if I move Wireshark.app?\
  90 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  91
  92 \b0\fs24 \cf0 \
  93 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
  94
  95 \f1 \cf0 The script should find the Wireshark application bundle and run the appropriate executable automatically. It looks for Wireshark.app in the following locations:\
  96 \
  97 \pard\tx220\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\li720\fi-720\pardirnatural
  98 \ls4\ilvl0\cf0 {\listtext       \'95    }The path set in the WIRESHARK_APP_DIR environment variable\
  99 {\listtext      \'95    }/Applications/Wireshark.app\
 100 {\listtext      \'95    }The first path returned by
 101 \f2 mdfind "kMDItemCFBundleIdentifier == 'org.wireshark.Wireshark'"
 102 \f1 \
 103 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
 104 \cf0 \
 105 If you move Wireshark.app the script should automatically find it. If it doesn't you will have to set WIRESHARK_APP_DIR to the path to (and including) Wireshark.app. Automatic discovery might fail if you have multiple copies of Wireshark installed on your system or if Spotlight indexing isn't working properly.}