


READLDM(5ICD)		     7/1/84		    READLDM(5ICD)



NNNNAAAAMMMMEEEE
     readldm, freadldm - read an LDM file

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     rrrreeeeaaaaddddllllddddmmmm ((((ffffiiiilllleeee))))
     cccchhhhaaaarrrr ****ffffiiiilllleeee;;;;

     ffffrrrreeeeaaaaddddllllddddmmmm ((((ffffpppp))))
     FFFFIIIILLLLEEEE ****ffffpppp;;;;


PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
     ffffiiiilllleeee    Name of the file which must be read.

     ffffpppp      specifies an open file which must be read.

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     _R_e_a_d_l_d_m and _f_r_e_a_d_l_d_m are routines that will read the speci-
     fied LDM file, and update the internal LDMC datastructure
     with the new information.	The cells defined in the LDM file
     are treated exactly the same as cells defined in the LDMC
     program internally, and are also echo'ed to the output.
     Note that this differs from the way how dbread and
     dbreadl(5ICD) behave.  If this is not desired, you can use a
     call

	 setout("/dev/null");

     before readldm.

     This routine is also very useful to read the output of other
     layout generator programs, either written in LDMC or not.
     Examples of such programs may even be placement/routing pro-
     grams.

RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
     Both _r_e_a_d_l_d_m and _f_r_e_a_d_l_d_m return the number of succesfully
     read cells, which may be 0, e.g. if the file is empty.  On
     error, -1 is returned and ll_errno is set to indicate the
     error.

SSSSPPPPEEEECCCCIIIIAAAALLLL CCCCOOOONNNNSSSSIIIIDDDDEEEERRRRAAAATTTTIIIIOOOONNNNSSSS
     The LDM file is parsed by a special program (parseldm) in a
     separate process.	The parser checks the syntax and
     translates the LDM file in a fixed-format temporary file,
     with optional fields in the LDM statements all fully speci-
     fied.  This format is then easily read by the readldm rou-
     tine.  This arrangement avoids the size overhead of having a
     complete LDM parser linked into every program using the
     readldm routine.





		   The Nelsis IC Design System			1






READLDM(5ICD)		     7/1/84		    READLDM(5ICD)



SSSSEEEEEEEE AAAALLLLSSSSOOOO
     ldmcintro(5ICD)





















































2		   The Nelsis IC Design System



