doc/README.SOLARIS

   1 This is the Solaris README file for netatalk.
   2
   3 1.  SELECT COMPILER.  This distribution is configured to build with
   4     gcc.  It should also work with cc. At the present time only cc
   5     v5.0 and above can build the 64-bit kernel module.
   6
   7 1a. SELECT KERNEL TYPE.  Edit sys/solaris/Makefile and set KCFLAGS to
   8      include sparcv9 support if you run a 64-bit kernel, or leave it
   9      commented out for a 32-bit kernel. Only UltraSPARC systems
  10      running Solaris 7 and above support a 64-bit kernel. If you're
  11      not sure what kernel you use, run "isainfo -v". You're running a
  12      64-bit kernel if the result includes 64-bit (sparcv9), otherwize
  13      it's 32-bit.
  14
  15      NOTE: If you want both the 32-bit and 64-bit kernel modules to be
  16      installed, first compile and install the version appropriate to
  17      the kernel that you're currently running, then make clean,
  18      compile and install the other version.
  19
  20 2.  EDIT NETCONFIG.  Add the following line to /etc/netconfig:
  21
  22         ddp tpi_clts - appletalk ddp /dev/ddp -
  23
  24     This makes the socket library aware of the AppleTalk protocol
  25     family.
  26
  27 3.  INSTALL DRIVER.  Since the STREAMS ddp driver must be installed as
  28     root, we've separated that portion of the build.  Type
  29
  30         make kinstall
  31
  32     to install the driver.  This copies the driver and its config file
  33     into /usr/kernel/drv and /usr/kernel/strmod, runs "add_drv ddp" to
  34     make the kernel aware of the new driver, and adds an rc file to
  35     /etc/rc?.d. Watch out for error messages after it runs  add_drv.
  36     If you see something like
  37       devfsadm: driver failed to attach: ddp
  38       Warning: Driver (ddp) successfully added to system but failed to attach
  39     then recheck sys/solaris/Makefile and/or try a different compiler.
  40
  41 4.  ATALKD.CONF.  Under Solaris, you must create atalkd.conf, since
  42     Solaris provides no method for determining the names of the
  43     available interfaces.  It is sufficent to name the available
  44     interfaces in atalkd.conf, one per line.  E.g.
  45
  46         le0
  47
  48     on a line by itself on many Suns. hme0 on Ultras.  See atalkd(8).
  49
  50 5.  PRINTING.  Netatalk can use any postscript printer that has been set
  51     up for use by Solaris. If you haven't already set up a printer,
  52     type admintool then select Browse --> Printers, and then Edit --> Add
  53     and fill in the form for either a local or remote printer. If adding
  54     a local printer, set the Printer Type to PostScript. Then find a
  55     postscript file and test your printer from the command line. For
  56     example if you created a printer called "fred" your print command
  57     would be something like:  lp -d fred some_file.ps
  58
  59     Once you have a printer that works under Solaris, you need to create
  60     a papd.conf file. For example
  61
  62       MacLaserjet:\
  63           :pr=|/usr/bin/lp -d fred:\
  64           :op=nobody:\
  65           :pd=/usr/local/etc/HPLJ_4M.PPD:
  66
  67     See doc/CONFIGURE for more information on papd.conf.
  68     Once you have this set up, and assuming netatalk starts up after
  69       /etc/rc2.d/S79atalk start
  70     you should be able to see the printer from the Macintosh Chooser.