1 05/14/84  bootload_fs
  2 
  3 Syntax:  bootload_fs operation {args}
  4 
  5 
  6 Function:  allows the user to operate on a copy of the bootload Multics
  7 (bce) file system, including the ability to extract the real bce file
  8 system and to replace it with this operating copy.
  9 
 10 
 11 Arguments:
 12 operation
 13      is an operation listed below under "List of Operations".
 14 args
 15      are arguments required by the designated operation.
 16 
 17 
 18 List of Operations:
 19 
 20      The operations  are grouped into two  categories.  The first
 21 group determines the location of the  user's copy of the bce file
 22 system; operations  in this group  can also extract  the real bce
 23 file  system and  overwrite the bce  file system  with the user's
 24 copy.  The second group operates on objects in the user's working
 25 copy of the bce file system.
 26 
 27 
 28 Operation:  read_partition, rpart
 29 
 30      The read_partition operation reads the bce file system from a
 31 specified  disk partition  into the  user's working  copy thereof
 32 overwriting the previous contents of the user's copy.
 33 
 34 
 35 Syntax:  bootload_fs read_partition pv_name part_name
 36 
 37 
 38 Arguments:
 39 pv_name
 40      is the name of a mounted physical volume.
 41 part_name
 42      is  the name  of a partition  on the specified  volume to be
 43      read.
 44 
 45 
 46 Notes:
 47      Acess to hphcs_ is required.
 48 
 49 
 50 Operation:  write_partition, wpart
 51 
 52      The  write_partition  operation replaces  the bce  file system
 53 found in the specified disk partition with the user's local copy.
 54 
 55 
 56 Syntax:  bootload_fs write_partition pv_name part_name
 57 
 58 
 59 Arguments:
 60 pv_name
 61      is the name of a mounted physical volume.
 62 part_name
 63      is  the name  of a partition  on the specified  volume to be
 64      read.
 65 
 66 
 67 Notes:
 68      Specifying "-force"  will suppress  the query  as to
 69 overwriting the old partition.
 70 
 71      Access to hphcs_ is required.
 72 
 73 
 74 Operation:  use_partition, upart
 75 
 76      The  use_partition operation  copies the contents  of a user
 77 specified segment  to become the  user's working copy  of the bce
 78 file system.
 79 
 80 
 81 Usage:  bootload_fs use_partition path
 82 
 83 
 84 Arguments:
 85 path
 86      is  the  pathname  of  a segment  which  will  overwrite the
 87      current  contents  of  the  user's local  copy  of  the file
 88      system.
 89 
 90 
 91 Operation:  save_partition, svpart, spart
 92 
 93      The save_partition  operation saves the  current contents of
 94 the user's local copy of the bce file system into a segment.
 95 
 96 
 97 Usage:  bootload_fs save_partition path
 98 
 99 
100 Arguments:
101 path
102      is the pathname of a  segment which will be overwritten with
103      the user's working copy of the file system.
104 
105 
106 Operation:  discard_partition, dpart
107 
108      The discard  operation discards the contents  of the working
109 copy of the bce file system.   This operation must be followed by
110 another read_partition, use_partition of init_partition operation.
111 
112 
113 Usage:  bootload_fs discard_partition {-force}
114 
115 
116 Operation:  init_partition, ipart
117 
118       The init_partition operation clears out the contents of the
119 working  copy   of  the  bce   file  system.   It   differs  from
120 discard_partition in that the result  is a file system containing
121 no files;  the result of  discard_partition is no  file system at
122 all.
123 
124 
125 Syntax:  bootload_fs init_partition {-force}
126 
127 
128 Operation:  read_file, read, r
129 
130      The read_file operation extracts a file from the working copy
131 of  the  bce file  system and  places it  into a  Multics storage
132 system file.
133 
134 
135 Syntax:  bootload_fs read_file file_name path
136 
137 
138 Arguments:
139 file_name
140      is the  name of a  file within the  working copy of  the bce
141      file system.
142 path
143      is the pathname of the Multics  file into which the bce file
144      is to be copied.
145 
146 
147 Operation:  write_file, write, w
148 
149      The write_file operation places a copy of a  Multics storage
150 system file in the working copy of the bce file system.
151 
152 
153 Usage:  bootload_fs write_file path file_name
154 
155 
156 Arguments:
157 path
158      is the name of a file  in the Multics hierarchy to be copied
159      into the bce file system.
160 file_name
161      is the name the copy is to have within the bce file system.
162 
163 
164 Operation:  list_files, list, ls
165 
166      The  list_files operation  lists the  names and  lengths (in
167 characters)  of the  files in  the working  copy of  the bce file
168 system.
169 
170 
171 Usage:  bootload_fs list_files
172 
173 
174 Operation:  delete_file, delete, dl
175 
176       The  delete_file operation  deletes files  from the working
177 copy of the bce file system.
178 
179 
180 Usage:  bootload_fs delete_file file_name
181 
182 
183 Arguments:
184 file_name
185      is the  name of a  file that is  to be deleted  from the bce
186      file system.
187 
188 
189 Operation:  rename_file, rename, rn
190 
191      The rename_file operation renames  a file within the working
192 copy of the bce file system.
193 
194 
195 Usage:  bootload_fs rename_file old_file_name new_file_name
196 
197 
198 Arguments:
199 old_file_name
200      is the name of an existing file in the bce file system.
201 new_file_name
202      is the new name to be given to the old file.