কমান্ড এবং অপশন

এই পৃষ্ঠাটি বিভিন্ন Bazel কমান্ডের সাথে উপলব্ধ বিকল্পগুলিকে কভার করে, যেমন bazel build , bazel run , এবং bazel test ৷ এই পৃষ্ঠাটি Build with Bazel- এ Bazel-এর কমান্ডের তালিকার একটি সহযোগী।

টার্গেট সিনট্যাক্স

কিছু কমান্ড, যেমন build বা test , লক্ষ্যগুলির একটি তালিকায় কাজ করতে পারে। তারা লেবেলের তুলনায় আরো নমনীয় একটি সিনট্যাক্স ব্যবহার করে, যা বিল্ড করার লক্ষ্য নির্দিষ্টকরণে নথিভুক্ত করা হয়েছে।

অপশন

নিম্নলিখিত বিভাগগুলি বিল্ড করার সময় উপলব্ধ বিকল্পগুলি বর্ণনা করে। যখন --long একটি হেল্প কমান্ডে ব্যবহার করা হয়, অন-লাইন সাহায্য বার্তাগুলি প্রতিটি বিকল্পের অর্থ, প্রকার এবং ডিফল্ট মান সম্পর্কে সারসংক্ষেপ তথ্য প্রদান করে।

বেশিরভাগ বিকল্প শুধুমাত্র একবার নির্দিষ্ট করা যেতে পারে। একাধিকবার নির্দিষ্ট করা হলে, শেষ দৃষ্টান্ত জয়ী হয়। একাধিকবার নির্দিষ্ট করা যেতে পারে এমন বিকল্পগুলিকে 'একাধিকবার ব্যবহার করা যেতে পারে' পাঠ্যের সাহায্যে অন-লাইন সাহায্যে চিহ্নিত করা হয়।

প্যাকেজ অবস্থান

--package_path

এই বিকল্পটি নির্দেশিকাগুলির সেট নির্দিষ্ট করে যা একটি প্রদত্ত প্যাকেজের জন্য BUILD ফাইল খুঁজতে অনুসন্ধান করা হয়।

ব্যাজেল প্যাকেজ পাথ অনুসন্ধান করে তার প্যাকেজগুলি খুঁজে পায়। এটি বেজেল ডিরেক্টরিগুলির একটি কোলন বিভক্ত অর্ডারকৃত তালিকা, প্রতিটি একটি আংশিক উত্স গাছের মূল।

--package_path বিকল্পটি ব্যবহার করে একটি কাস্টম প্যাকেজ পাথ নির্দিষ্ট করতে :

  % bazel build --package_path %workspace%:/some/other/root

প্যাকেজ পাথ উপাদান তিনটি বিন্যাসে নির্দিষ্ট করা যেতে পারে:

1. যদি প্রথম অক্ষরটি / হয় তবে পথটি পরম।
2. যদি পাথটি %workspace% দিয়ে শুরু হয়, তাহলে পাথটি নিকটতম ঘেরা বেজেল ডিরেক্টরির সাপেক্ষে নেওয়া হয়। উদাহরণস্বরূপ, যদি আপনার কাজের ডিরেক্টরিটি /home/bob/clients/bob_client/bazel/foo হয়, তাহলে প্যাকেজ-পাথের স্ট্রিং %workspace% কে /home/bob/clients/bob_client/bazel এ প্রসারিত করা হয়।
3. অন্য কিছু কাজ ডিরেক্টরি আপেক্ষিক নেওয়া হয়. এটি সাধারণত আপনি যা করতে চান তা নয় এবং আপনি যদি বেজেল ওয়ার্কস্পেসের নীচের ডিরেক্টরি থেকে Bazel ব্যবহার করেন তবে অপ্রত্যাশিতভাবে আচরণ করতে পারে। উদাহরণস্বরূপ, যদি আপনি প্যাকেজ-পাথ উপাদান ব্যবহার করেন . , এবং তারপর /home/bob/clients/bob_client/bazel/foo ডিরেক্টরিতে cd , প্যাকেজগুলি /home/bob/clients/bob_client/bazel/foo ডিরেক্টরি থেকে সমাধান করা হবে।

আপনি যদি একটি নন-ডিফল্ট প্যাকেজ পাথ ব্যবহার করেন, সুবিধার জন্য এটি আপনার Bazel কনফিগারেশন ফাইলে উল্লেখ করুন।

Bazel- এর বর্তমান ডিরেক্টরিতে কোনো প্যাকেজ থাকার প্রয়োজন নেই , তাই আপনি একটি খালি বেজেল ওয়ার্কস্পেস থেকে একটি বিল্ড করতে পারেন যদি প্যাকেজ পাথে অন্য কোথাও সব প্রয়োজনীয় প্যাকেজ পাওয়া যায়।

উদাহরণ: একটি খালি ক্লায়েন্ট থেকে বিল্ডিং

  % mkdir -p foo/bazel
  % cd foo/bazel
  % touch WORKSPACE
  % bazel build --package_path /some/other/path //foo

--deleted_packages

এই বিকল্পটি প্যাকেজগুলির একটি কমা দ্বারা পৃথক করা তালিকা নির্দিষ্ট করে যা Bazel মুছে ফেলা বিবেচনা করা উচিত এবং প্যাকেজ পাথের কোনো ডিরেক্টরি থেকে লোড করার চেষ্টা করা উচিত নয়। এটি আসলে প্যাকেজগুলি মুছে ফেলা ছাড়াই মুছে ফেলার অনুকরণ করতে ব্যবহার করা যেতে পারে।

ত্রুটি পরীক্ষা

এই বিকল্পগুলি Bazel এর ত্রুটি-পরীক্ষা এবং/অথবা সতর্কতা নিয়ন্ত্রণ করে।

--[no]check_visibility

যদি এই বিকল্পটি মিথ্যাতে সেট করা থাকে, তাহলে দৃশ্যমানতা পরীক্ষাকে সতর্কবার্তায় অবনমিত করা হয়। এই বিকল্পের ডিফল্ট মান সত্য, যাতে ডিফল্টরূপে, দৃশ্যমানতা পরীক্ষা করা হয়।

--output_filter= regex

--output_filter বিকল্পটি শুধুমাত্র নিয়মিত অভিব্যক্তির সাথে মেলে এমন লক্ষ্যগুলির জন্য বিল্ড এবং সংকলন সতর্কতা দেখাবে। যদি একটি টার্গেট প্রদত্ত রেগুলার এক্সপ্রেশনের সাথে মেলে না এবং এর এক্সিকিউশন সফল হয়, তাহলে এর স্ট্যান্ডার্ড আউটপুট এবং স্ট্যান্ডার্ড এররটি ফেলে দেওয়া হয়।

এই বিকল্পের জন্য এখানে কিছু সাধারণ মান রয়েছে:

`--আউটপুট_ফিল্টার='^//(প্রথম/প্রকল্প|সেকেন্ড/প্রকল্প):'`	নির্দিষ্ট প্যাকেজের জন্য আউটপুট দেখান।
`--আউটপুট_ফিল্টার='^//((?!(first/bad_project|second/bad_project):).)*$'`	নির্দিষ্ট প্যাকেজগুলির জন্য আউটপুট দেখাবেন না।
`--আউটপুট_ফিল্টার=`	সব দেখাও।
`--output_filter=DONT_MATCH_ANYTHING`	কিছুই দেখান না।

টুল পতাকা

এই বিকল্পগুলি নিয়ন্ত্রণ করে কোন বিকল্পগুলি Bazel অন্যান্য সরঞ্জামগুলিতে পাস করবে৷

--copt= cc-option

এই অপশনটি একটি আর্গুমেন্ট নেয় যা কম্পাইলারকে পাস করতে হবে। প্রিপ্রসেসিং, কম্পাইলিং, এবং/অথবা সি, সি++, বা অ্যাসেম্বলার কোড একত্রিত করার জন্য যখনই আর্গুমেন্টটি কম্পাইলারের কাছে পাঠানো হবে। লিঙ্ক করার সময় এটি পাস করা হবে না।

এই বিকল্পটি একাধিকবার ব্যবহার করা যেতে পারে। উদাহরণ স্বরূপ:

  % bazel build --copt="-g0" --copt="-fpic" //foo

ডিবাগ টেবিল ছাড়াই foo লাইব্রেরি কম্পাইল করবে, অবস্থান-স্বাধীন কোড তৈরি করবে।

দ্রষ্টব্য: --copt সেটিংস পরিবর্তন করা হলে সমস্ত প্রভাবিত অবজেক্ট ফাইলের পুনঃসংকলন বাধ্য হবে। এছাড়াও মনে রাখবেন যে নির্দিষ্ট cc_library বা cc_binary বিল্ড নিয়মে তালিকাভুক্ত copts মানগুলি এই বিকল্পগুলির পরে কম্পাইলার কমান্ড লাইনে স্থাপন করা হবে।

সতর্কতা: C++-নির্দিষ্ট বিকল্পগুলি (যেমন -fno-implicit-templates ) --cxxopt-এ উল্লেখ করা উচিত, --cxxopt এ --copt । একইভাবে, C-নির্দিষ্ট বিকল্পগুলি (যেমন -Wstrict-prototypes) --conlyopt-এ উল্লেখ করা উচিত, --conlyopt এ copt । একইভাবে, কম্পাইলার বিকল্পগুলি যেগুলি শুধুমাত্র লিঙ্কের সময় প্রভাব ফেলে (যেমন -l ) --linkopt-এ উল্লেখ করা উচিত, --linkopt এ --copt ।

--host_copt= cc-option

এই বিকল্পটি একটি যুক্তি নেয় যা হোস্ট কনফিগারেশনে কম্পাইল করা সোর্স ফাইলগুলির জন্য কম্পাইলারের কাছে প্রেরণ করা হয়। এটি --copt বিকল্পের সাথে সাদৃশ্যপূর্ণ, তবে শুধুমাত্র হোস্ট কনফিগারেশনের ক্ষেত্রে প্রযোজ্য।

--host_conlyopt= cc-option

এই বিকল্পটি একটি আর্গুমেন্ট নেয় যা হোস্ট কনফিগারেশনে কম্পাইল করা C সোর্স ফাইলগুলির জন্য কম্পাইলারের কাছে পাঠানো হয়। এটি --conlyopt বিকল্পের সাথে সাদৃশ্যপূর্ণ, কিন্তু শুধুমাত্র হোস্ট কনফিগারেশনের ক্ষেত্রে প্রযোজ্য।

--host_cxxopt= cc-option

এই বিকল্পটি একটি আর্গুমেন্ট নেয় যা হোস্ট কনফিগারেশনে কম্পাইল করা C++ সোর্স ফাইলগুলির জন্য কম্পাইলারের কাছে পাঠানো হয়। এটি --cxxopt বিকল্পের সাথে সাদৃশ্যপূর্ণ, কিন্তু শুধুমাত্র হোস্ট কনফিগারেশনের ক্ষেত্রে প্রযোজ্য।

--host_linkopt= linker-option

এই বিকল্পটি একটি আর্গুমেন্ট নেয় যা হোস্ট কনফিগারেশনে সংকলিত সোর্স ফাইলগুলির জন্য লিঙ্কারে প্রেরণ করা হয়। এটি --linkopt বিকল্পের সাথে সাদৃশ্যপূর্ণ, কিন্তু শুধুমাত্র হোস্ট কনফিগারেশনে প্রযোজ্য।

--conlyopt= cc-option

এই বিকল্পটি একটি আর্গুমেন্ট নেয় যা সি সোর্স ফাইল কম্পাইল করার সময় কম্পাইলারের কাছে পাঠানো হয়।

এটি --copt এর অনুরূপ, কিন্তু শুধুমাত্র C সংকলনের ক্ষেত্রে প্রযোজ্য, C++ সংকলন বা লিঙ্কিং এর ক্ষেত্রে নয়। তাই আপনি --conlyopt ব্যবহার করে সি-নির্দিষ্ট বিকল্পগুলি (যেমন -Wno-pointer-sign ) পাস করতে পারেন।

দ্রষ্টব্য: নির্দিষ্ট cc_library বা cc_binary বিল্ড নিয়মে তালিকাভুক্ত copts প্যারামিটারগুলি এই বিকল্পগুলির পরে কম্পাইলার কমান্ড লাইনে স্থাপন করা হয়।

--cxxopt= cc-option

এই বিকল্পটি একটি আর্গুমেন্ট নেয় যা C++ সোর্স ফাইল কম্পাইল করার সময় কম্পাইলারের কাছে পাঠানো হয়।

এটি --copt এর অনুরূপ, কিন্তু শুধুমাত্র C++ সংকলনের ক্ষেত্রে প্রযোজ্য, C সংকলন বা লিঙ্কিংয়ের ক্ষেত্রে নয়। তাই আপনি --cxxopt ব্যবহার করে C++-নির্দিষ্ট বিকল্পগুলি পাস করতে পারেন (যেমন -fpermissive বা -fno- --cxxopt -fno-implicit-templates )।

উদাহরণ স্বরূপ:

  % bazel build --cxxopt="-fpermissive" --cxxopt="-Wno-error" //foo/cruddy_code

দ্রষ্টব্য: নির্দিষ্ট cc_library বা cc_binary বিল্ড নিয়মে তালিকাভুক্ত copts প্যারামিটারগুলি এই বিকল্পগুলির পরে কম্পাইলার কমান্ড লাইনে স্থাপন করা হয়।

--linkopt= linker-option

এই বিকল্পটি একটি আর্গুমেন্ট নেয় যা লিঙ্ক করার সময় কম্পাইলারকে পাস করতে হবে।

এটি --copt এর অনুরূপ, কিন্তু শুধুমাত্র লিঙ্ক করার ক্ষেত্রে প্রযোজ্য, সংকলনের ক্ষেত্রে নয়। তাই আপনি কম্পাইলার বিকল্পগুলি পাস করতে পারেন যা শুধুমাত্র লিঙ্কের সময় (যেমন -lssp বা -Wl,--wrap,abort abort) ব্যবহার করে --linkopt ব্যবহার করে বোঝা যায়। উদাহরণ স্বরূপ:

  % bazel build --copt="-fmudflap" --linkopt="-lmudflap" //foo/buggy_code

বিল্ড নিয়মগুলি তাদের বৈশিষ্ট্যগুলিতে লিঙ্ক বিকল্পগুলিও নির্দিষ্ট করতে পারে। এই বিকল্পের সেটিংস সর্বদা অগ্রাধিকার নেয়। এছাড়াও cc_library.linkopts দেখুন।

--strip (always|never|sometimes)

এই বিকল্পটি নির্ধারণ করে যে Bazel সমস্ত বাইনারি এবং ভাগ করা লাইব্রেরি থেকে ডিবাগিং তথ্য ছিনিয়ে নেবে -Wl,--strip-debug বিকল্পের সাথে লিঙ্কারকে আহ্বান করে। --strip=always মানে সর্বদা ডিবাগিং তথ্য ফালা। --strip=never মানে কখনই ডিবাগিং তথ্য ফালান না। --strip=sometimes স্ট্রিপ এর ডিফল্ট মান মানে যদি --compilation_mode fastbuild ।

  % bazel build --strip=always //foo:bar

সমস্ত উত্পন্ন বাইনারি থেকে ডিবাগিং তথ্য বের করার সময় লক্ষ্য কম্পাইল করবে।

দ্রষ্টব্য: আপনি যদি ডিবাগিং তথ্য চান তবে স্ট্রিপিং অক্ষম করার জন্য এটি যথেষ্ট নয়; আপনাকে নিশ্চিত করতে হবে যে ডিবাগিং তথ্য কম্পাইলার দ্বারা তৈরি হয়েছে, যা আপনি -c dbg বা --copt -g ব্যবহার করে করতে পারেন।

Bazel-এর --strip অপশনটি ld-এর --strip-debug বিকল্পের সাথে মিলে যায়: এটি শুধুমাত্র ডিবাগিং তথ্য বের করে দেয়। যদি কোনো কারণে আপনি শুধুমাত্র ডিবাগ চিহ্ন নয়, সমস্ত চিহ্ন স্ট্রীপ করতে চান, তাহলে আপনাকে ld-এর --strip-all অপশন ব্যবহার করতে হবে, যা আপনি --linkopt=-Wl,--strip-all পাস করে করতে পারেন। এছাড়াও সচেতন থাকুন যে Bazel-এর --strip পতাকা সেট করলে --linkopt=-Wl,--strip-all ওভাররাইড হবে, তাই আপনার শুধুমাত্র একটি বা অন্যটি সেট করা উচিত।

আপনি যদি শুধুমাত্র একটি বাইনারি তৈরি করেন এবং সমস্ত প্রতীক ছিনতাই করতে চান, তাহলে আপনি --stripopt=--strip-all পাস করতে পারেন এবং //foo:bar.stripped সংস্করণটি স্পষ্টভাবে তৈরি করতে পারেন। --stripopt এর বিভাগে বর্ণিত হিসাবে, এটি বিল্ডের সমস্ত লিঙ্ক অ্যাকশনে স্ট্রিপিং অন্তর্ভুক্ত করার পরিবর্তে চূড়ান্ত বাইনারি লিঙ্ক হওয়ার পরে একটি স্ট্রিপ অ্যাকশন প্রয়োগ করে।

--stripopt= strip-option

একটি *.stripped বাইনারি তৈরি করার সময় strip কমান্ডে পাস করার জন্য এটি একটি অতিরিক্ত বিকল্প। ডিফল্ট হল -S -p । এই বিকল্পটি একাধিকবার ব্যবহার করা যেতে পারে।

দ্রষ্টব্য: --stripopt [--strip](#flag--strip)=(always|sometimes) দিয়ে প্রধান বাইনারি স্ট্রীপ করার ক্ষেত্রে প্রযোজ্য নয়।

--fdo_instrument= profile-output-dir

--fdo_instrument বিকল্পটি FDO (ফিডব্যাক নির্দেশিত অপ্টিমাইজেশান) প্রোফাইল আউটপুট তৈরি করতে সক্ষম করে যখন নির্মিত C/C++ বাইনারি কার্যকর করা হয়। GCC-এর জন্য, প্রদত্ত আর্গুমেন্টটি প্রতিটি .o ফাইলের প্রোফাইল তথ্য ধারণকারী .gcda ফাইলের প্রতি-অবজেক্ট ফাইল ডিরেক্টরি ট্রির জন্য একটি ডিরেক্টরি উপসর্গ হিসাবে ব্যবহৃত হয়।

প্রোফাইল ডেটা ট্রি তৈরি হয়ে গেলে, প্রোফাইল ট্রি জিপ করা উচিত, এবং FDO-অপ্টিমাইজ করা সংকলন সক্রিয় করার জন্য --fdo_optimize= profile-zip Bazel বিকল্পে প্রদান করা উচিত।

LLVM কম্পাইলারের জন্য আর্গুমেন্ট হল সেই ডিরেক্টরি যার অধীনে কাঁচা LLVM প্রোফাইল ডেটা ফাইল(গুলি) ডাম্প করা হয়। উদাহরণস্বরূপ: --fdo_instrument= /path/to/rawprof/dir/ ।

--fdo_instrument এবং --fdo_optimize বিকল্পগুলি একই সময়ে ব্যবহার করা যাবে না।

--fdo_optimize= profile-zip

--fdo_optimize বিকল্পটি কম্পাইল করার সময় FDO (ফিডব্যাক নির্দেশিত অপ্টিমাইজেশান) অপ্টিমাইজেশান করার জন্য প্রতি-অবজেক্ট ফাইল প্রোফাইল তথ্য ব্যবহার করতে সক্ষম করে। GCC-এর জন্য, প্রদত্ত আর্গুমেন্ট হল জিপ ফাইল যেখানে প্রতিটি .o ফাইলের প্রোফাইল তথ্য ধারণকারী .gcda ফাইলের পূর্বে তৈরি করা ফাইল ট্রি রয়েছে।

বিকল্পভাবে, প্রদত্ত যুক্তিটি এক্সটেনশন .afdo দ্বারা চিহ্নিত একটি স্বয়ংক্রিয় প্রোফাইল নির্দেশ করতে পারে।

দ্রষ্টব্য: এই বিকল্পটি লেবেলগুলিকেও গ্রহণ করে যা সোর্স ফাইলগুলির সমাধান করে৷ ফাইলটিকে Bazel-এ দৃশ্যমান করতে আপনাকে সংশ্লিষ্ট প্যাকেজে একটি exports_files নির্দেশিকা যোগ করতে হতে পারে।

LLVM কম্পাইলারের জন্য প্রদত্ত আর্গুমেন্টটি llvm-profdata টুল দ্বারা প্রস্তুতকৃত সূচীকৃত LLVM প্রোফাইল আউটপুট ফাইলের দিকে নির্দেশ করা উচিত এবং একটি .profdata এক্সটেনশন থাকা উচিত।

--fdo_instrument এবং --fdo_optimize বিকল্পগুলি একই সময়ে ব্যবহার করা যাবে না।

--java_language_version= version

এই বিকল্পটি জাভা উৎসের সংস্করণ নির্দিষ্ট করে। উদাহরণ স্বরূপ:

  % bazel build --java_language_version=8 java/com/example/common/foo:all

জাভা 8 স্পেসিফিকেশনের সাথে সামঞ্জস্যপূর্ণ শুধুমাত্র কম্পাইল এবং অনুমতি দেয়। ডিফল্ট মান হল 11। --> সম্ভাব্য মানগুলি হল: 8, 9, 10, 11, 14, এবং 15 এবং default_java_toolchain ব্যবহার করে কাস্টম জাভা টুলচেইন নিবন্ধনের মাধ্যমে বাড়ানো যেতে পারে।

--tool_java_language_version= version

জাভা ভাষার সংস্করণটি এমন সরঞ্জাম তৈরি করতে ব্যবহৃত হয় যা বিল্ড করার সময় কার্যকর করা হয়। ডিফল্ট মান হল 11।

--java_runtime_version= version

এই বিকল্পটি কোড চালানো এবং পরীক্ষা চালানোর জন্য JVM-এর সংস্করণটি নির্দিষ্ট করে। উদাহরণ স্বরূপ:

  % bazel run --java_runtime_version=remotejdk_11 java/com/example/common/foo:java_application

একটি দূরবর্তী সংগ্রহস্থল থেকে JDK 11 ডাউনলোড করে এবং এটি ব্যবহার করে জাভা অ্যাপ্লিকেশন চালায়।

ডিফল্ট মান হল localjdk । সম্ভাব্য মানগুলি হল: localjdk , localjdk_ version , remotejdk_11 , এবং remote_jdk17 । আপনি local_java_repository বা remote_java_repostory সংগ্রহস্থলের নিয়মগুলি ব্যবহার করে কাস্টম JVM নিবন্ধন করে মানগুলি প্রসারিত করতে পারেন।

--tool_java_runtime_version= version

JVM এর সংস্করণটি বিল্ড করার সময় প্রয়োজনীয় সরঞ্জামগুলি চালানোর জন্য ব্যবহৃত হয়। ডিফল্ট মান হল remotejdk_11 ।

--jvmopt= jvm-option

এই বিকল্পটি বিকল্প আর্গুমেন্টগুলি জাভা ভিএম-এ পাস করার অনুমতি দেয়। এটি একটি বড় আর্গুমেন্টের সাথে ব্যবহার করা যেতে পারে, বা একাধিকবার পৃথক আর্গুমেন্টের সাথে ব্যবহার করা যেতে পারে। উদাহরণ স্বরূপ:

  % bazel build --jvmopt="-server -Xms256m" java/com/example/common/foo:all

সমস্ত জাভা বাইনারি চালু করার জন্য সার্ভার VM ব্যবহার করবে এবং VM-এর জন্য স্টার্টআপ হিপের আকার 256 MB সেট করবে।

--javacopt= javac-option

এই বিকল্পটি বিকল্প আর্গুমেন্টগুলি javac-এ পাস করার অনুমতি দেয়। এটি একটি বড় আর্গুমেন্টের সাথে ব্যবহার করা যেতে পারে, বা একাধিকবার পৃথক আর্গুমেন্টের সাথে ব্যবহার করা যেতে পারে। উদাহরণ স্বরূপ:

  % bazel build --javacopt="-g:source,lines" //myprojects:prog

javac ডিফল্ট ডিবাগ তথ্য দিয়ে একটি java_binary পুনর্নির্মাণ করবে (ব্যাজেল ডিফল্টের পরিবর্তে)।

javac-এর জন্য Bazel বিল্ট-ইন ডিফল্ট বিকল্পের পরে এবং প্রতি-বিধি বিকল্পগুলির আগে বিকল্পটি javac-এ পাস করা হয়। javac জিততে যে কোন অপশনের শেষ স্পেসিফিকেশন। javac-এর জন্য ডিফল্ট বিকল্পগুলি হল:

  -source 8 -target 8 -encoding UTF-8

দ্রষ্টব্য: --javacopt সেটিংস পরিবর্তন করা সমস্ত প্রভাবিত ক্লাসের পুনর্সংকলনকে বাধ্য করবে। এছাড়াও মনে রাখবেন যে নির্দিষ্ট java_library বা java_binary বিল্ড নিয়মে তালিকাভুক্ত javacopts প্যারামিটারগুলি এই বিকল্পগুলির পরে javac কমান্ড লাইনে স্থাপন করা হবে।

--strict_java_deps (default|strict|off|warn|error)

এই বিকল্পটি জাভাক অনুপস্থিত সরাসরি নির্ভরতা পরীক্ষা করে কিনা তা নিয়ন্ত্রণ করে। জাভা লক্ষ্যমাত্রা অবশ্যই স্পষ্টভাবে সমস্ত সরাসরি ব্যবহৃত লক্ষ্যগুলিকে নির্ভরতা হিসাবে ঘোষণা করতে হবে। এই ফ্ল্যাগটি জাভাককে নির্দেশ দেয় যে প্রতিটি জাভা ফাইল টাইপ চেক করার জন্য প্রকৃতপক্ষে ব্যবহৃত জারগুলি নির্ধারণ করতে এবং সতর্ক/ত্রুটি যদি সেগুলি বর্তমান লক্ষ্যের সরাসরি নির্ভরতার আউটপুট না হয়।

• off মানে চেকিং নিষ্ক্রিয়।
• warn মানে javac প্রতিটি অনুপস্থিত সরাসরি নির্ভরতার জন্য [strict] ধরণের স্ট্যান্ডার্ড জাভা সতর্কতা তৈরি করবে।
• default , strict এবং error সব মানে javac সতর্কতার পরিবর্তে ত্রুটি তৈরি করবে, যার ফলে বর্তমান লক্ষ্যটি নির্মাণে ব্যর্থ হবে যদি কোনো অনুপস্থিত সরাসরি নির্ভরতা পাওয়া যায়। পতাকা অনির্দিষ্ট থাকলে এটিও ডিফল্ট আচরণ।

শব্দার্থবিদ্যা তৈরি করুন

এই বিকল্পগুলি বিল্ড কমান্ড এবং/অথবা আউটপুট ফাইল বিষয়বস্তু প্রভাবিত করে।

--compilation_mode (fastbuild|opt|dbg) (-c)

--compilation_mode বিকল্পটি (প্রায়শই -c , বিশেষ করে -c opt তে সংক্ষিপ্ত করা হয়) fastbuild , dbg বা opt এর একটি যুক্তি নেয় এবং বিভিন্ন C/C++ কোড-জেনারেশন বিকল্পগুলিকে প্রভাবিত করে, যেমন অপ্টিমাইজেশানের স্তর এবং ডিবাগ টেবিলের সম্পূর্ণতা। . Bazel প্রতিটি ভিন্ন সংকলন মোডের জন্য একটি ভিন্ন আউটপুট ডিরেক্টরি ব্যবহার করে, তাই আপনি প্রতিবার সম্পূর্ণ পুনর্নির্মাণের প্রয়োজন ছাড়াই মোডগুলির মধ্যে স্যুইচ করতে পারেন।

• fastbuild মানে যত দ্রুত সম্ভব নির্মাণ করা: ন্যূনতম ডিবাগিং তথ্য তৈরি করুন ( -gmlt -Wl,-S ), এবং অপ্টিমাইজ করবেন না। এটি ডিফল্ট। দ্রষ্টব্য: -DNDEBUG সেট করা হবে না ।
• dbg মানে ডিবাগিং সক্ষম ( -g ) সহ বিল্ড, যাতে আপনি gdb (বা অন্য ডিবাগার) ব্যবহার করতে পারেন।
• opt মানে অপ্টিমাইজেশান সক্ষম এবং assert assert() কল নিষ্ক্রিয় ( -O2 -DNDEBUG ) সহ বিল্ড। আপনি --copt -g পাস না করলে opt মোডে ডিবাগিং তথ্য তৈরি করা হবে না।

--cpu= cpu

এই বিকল্পটি বিল্ড করার সময় বাইনারিগুলির সংকলনের জন্য ব্যবহার করা লক্ষ্য CPU আর্কিটেকচার নির্দিষ্ট করে।

দ্রষ্টব্য: ক্রসটুল সংস্করণ, কম্পাইলার সংস্করণ এবং লক্ষ্য CPU-এর একটি নির্দিষ্ট সংমিশ্রণ শুধুমাত্র তখনই অনুমোদিত হয় যদি এটি বর্তমানে ব্যবহৃত CROSSTOOL ফাইলে নির্দিষ্ট করা থাকে।

--action_env= VAR=VALUE

সমস্ত ক্রিয়া সম্পাদনের সময় উপলব্ধ পরিবেশ ভেরিয়েবলের সেট নির্দিষ্ট করে। ভেরিয়েবলগুলি হয় নাম দ্বারা নির্দিষ্ট করা যেতে পারে, এই ক্ষেত্রে মানটি আমন্ত্রণ পরিবেশ থেকে নেওয়া হবে, বা name=value জোড়া দ্বারা যা আমন্ত্রণ পরিবেশ থেকে স্বাধীন মান সেট করে।

এই --action_env পতাকা একাধিকবার নির্দিষ্ট করা যেতে পারে। যদি একটি মান একাধিক --action_env ফ্ল্যাগ জুড়ে একই ভেরিয়েবলে বরাদ্দ করা হয়, সর্বশেষ অ্যাসাইনমেন্ট জয়ী হয়।

--experimental_action_listener= label

সতর্কতা: অতিরিক্ত ক্রিয়াকলাপ বাতিল করা হয়েছে। পরিবর্তে দিক ব্যবহার করুন.

experimental_action_listener বিকল্পটি বিল্ড গ্রাফে extra_actions সন্নিবেশ করার জন্য label দ্বারা নির্দিষ্ট করা action_listener নিয়ম থেকে বিশদ ব্যবহার করার জন্য বেজেলকে নির্দেশ দেয়।

--[no]experimental_extra_action_top_level_only

সতর্কতা: অতিরিক্ত ক্রিয়াকলাপ বাতিল করা হয়েছে। পরিবর্তে দিক ব্যবহার করুন.

এই বিকল্পটি সত্য হিসাবে সেট করা থাকলে, --experimental_action_listener কমান্ড লাইন বিকল্প দ্বারা নির্দিষ্ট অতিরিক্ত কর্মগুলি শুধুমাত্র শীর্ষ স্তরের লক্ষ্যগুলির জন্য নির্ধারিত হবে।

--experimental_extra_action_filter= regex

সতর্কতা: অতিরিক্ত ক্রিয়াকলাপ বাতিল করা হয়েছে। পরিবর্তে দিক ব্যবহার করুন.

experimental_extra_action_filter বিকল্পটি extra_actions জন্য নির্ধারিত লক্ষ্যের সেট ফিল্টার করার নির্দেশ দেয়।

এই ফ্ল্যাগটি শুধুমাত্র --experimental_action_listener পতাকার সাথে একত্রে প্রযোজ্য।

ডিফল্টরূপে অনুরোধ করা লক্ষ্য-টু-বিল্ডের ট্রানজিটিভ extra_actions সমস্ত অতিরিক্ত_ক্রিয়া সম্পাদনের জন্য নির্ধারিত হয়। --experimental_extra_action_filter নির্ধারিত রেগুলার এক্সপ্রেশনের সাথে মালিকের লেবেল মেলে এমন extra_actions সময় নির্ধারণকে সীমাবদ্ধ করবে।

নিম্নলিখিত উদাহরণটি অতিরিক্ত_ক্রিয়াগুলির সময়সূচীকে সীমিত করবে শুধুমাত্র সেই ক্রিয়াগুলিতে প্রযোজ্য extra_actions মালিকের লেবেলে '/bar/' রয়েছে:

% bazel build --experimental_action_listener=//test:al //foo/... \
  --experimental_extra_action_filter=.*/bar/.*

--host_cpu= cpu

এই বিকল্পটি CPU আর্কিটেকচারের নাম উল্লেখ করে যা হোস্ট টুল তৈরি করতে ব্যবহার করা উচিত।

--fat_apk_cpu= cpu[,cpu]*

android_binary নিয়মের ট্রানজিটিভ deps জন্য C/C++ লাইব্রেরি তৈরি করার জন্য CPUগুলি। অন্যান্য C/C++ নিয়ম প্রভাবিত হয় না। উদাহরণস্বরূপ, যদি একটি cc_library একটি android_binary নিয়ম এবং একটি cc_binary নিয়মের ট্রানজিটিভ deps উপস্থিত হয়, তাহলে cc_library কমপক্ষে দুবার তৈরি করা হবে: একবার প্রতিটি CPU-এর জন্য android_binary নিয়মের জন্য --fat_apk_cpu দিয়ে নির্দিষ্ট করা হবে, এবং একবার নির্দিষ্ট CPU-এর জন্য --cpu cc_binary নিয়মের জন্য।

ডিফল্ট হল armeabi-v7a ।

--fat_apk_cpu সাথে নির্দিষ্ট করা প্রতিটি CPU-এর জন্য একটি .so ফাইল তৈরি এবং প্যাকেজ করা হয়। .so ফাইলের নাম "lib" এর সাথে android_binary নিয়মের নামের উপসর্গ স্থাপন করে। উদাহরণস্বরূপ, যদি android_binary এর নাম "foo" হয়, তাহলে ফাইলটি libfoo.so ।

দ্রষ্টব্য: একটি Android-সামঞ্জস্যপূর্ণ ক্রসটুল নির্বাচন করা আবশ্যক। যদি একটি android_ndk_repository নিয়ম WORKSPACE ফাইলে সংজ্ঞায়িত করা হয়, তাহলে একটি Android-সামঞ্জস্যপূর্ণ ক্রসটুল স্বয়ংক্রিয়ভাবে নির্বাচিত হয়। অন্যথায়, --android_crosstool_top বা --crosstool_top পতাকা ব্যবহার করে crostool নির্বাচন করা যেতে পারে।

--per_file_copt= [+-]regex[,[+-]regex]...@option[,option]...

উপস্থিত থাকাকালীন, লেবেল সহ যেকোন C++ ফাইল বা একটি এক্সিকিউশন পাথ যেটি অন্তর্ভুক্তি regex এক্সপ্রেশনগুলির একটির সাথে মেলে এবং যেকোনও এক্সক্লুশন এক্সপ্রেশনের সাথে মেলে না প্রদত্ত বিকল্পগুলির সাথে তৈরি করা হবে। লেবেল মেলে লেবেলের ক্যানোনিকাল ফর্ম ব্যবহার করে (যেমন // package : label_name )।

এক্সিকিউশন পাথ হল C++ ফাইলের বেস নাম (এক্সটেনশন সহ) আপনার ওয়ার্কস্পেস ডিরেক্টরির আপেক্ষিক পথ। এটি যেকোনো প্ল্যাটফর্ম নির্ভর উপসর্গও অন্তর্ভুক্ত করে।

দ্রষ্টব্য: যদি শুধুমাত্র একটি লেবেল বা এক্সিকিউশন পাথ মেলে অপশনগুলি ব্যবহার করা হবে৷

জেনারেট করা ফাইলের সাথে মেলে (যেমন জেনরুল আউটপুট) Bazel শুধুমাত্র এক্সিকিউশন পাথ ব্যবহার করতে পারে। এই ক্ষেত্রে regexp '//' দিয়ে শুরু হওয়া উচিত নয় কারণ এটি কোনো এক্সিকিউশন পাথের সাথে মেলে না। প্যাকেজের নাম এইভাবে ব্যবহার করা যেতে পারে: --per_file_copt=base/.*\.pb\.cc@-g0 । এটি প্রতিটি .pb.cc ফাইলের সাথে মিলবে base নামক একটি ডিরেক্টরির অধীনে।

এই বিকল্পটি একাধিকবার ব্যবহার করা যেতে পারে।

ব্যবহার করা সংকলন মোড নির্বিশেষে বিকল্পটি প্রয়োগ করা হয়। উদাহরণ স্বরূপ, --compilation_mode=opt দিয়ে কম্পাইল করা সম্ভব এবং শক্তিশালী অপ্টিমাইজেশান চালু থাকলে বা অপ্টিমাইজেশন অক্ষম করে কিছু ফাইল বেছে বেছে কম্পাইল করা সম্ভব।

সতর্কতা : কিছু ফাইল নির্বাচনীভাবে ডিবাগ চিহ্নের সাথে কম্পাইল করা হলে লিঙ্ক করার সময় চিহ্নগুলি ছিনতাই হতে পারে। --strip=never সেট করে এটি প্রতিরোধ করা যেতে পারে।

সিনট্যাক্স : [+-]regex[,[+-]regex]...@option[,option]... যেখানে regex একটি রেগুলার এক্সপ্রেশন বোঝায় যেটি চিহ্নিত করার জন্য + প্যাটার্ন অন্তর্ভুক্ত করার জন্য এবং এর সাথে - চিহ্নিত করা যেতে পারে নিদর্শন বাদ। option হল একটি নির্বিচারী বিকল্প যা C++ কম্পাইলারে পাস করা হয়। যদি কোনো অপশনে a থাকে , তাহলে এটিকে এভাবে উদ্ধৃত করতে হবে \, ,। বিকল্পগুলিতে @ ও থাকতে পারে, যেহেতু শুধুমাত্র প্রথম @ টি বিকল্পগুলি থেকে রেগুলার এক্সপ্রেশন আলাদা করতে ব্যবহৃত হয়।

উদাহরণ : --per_file_copt=//foo:.*\.cc,-//foo:file\.cc@-O0,-fprofile-arcs arcs-এর কমান্ড লাইনে -O0 এবং -fprofile-arcs বিকল্পগুলি যোগ করে। ফাইল. file.cc ছাড়া //foo/ -এ সমস্ত .cc ফাইলের জন্য C++ কম্পাইলার।

--dynamic_mode= mode

বিল্ড নিয়মে লিঙ্কস্ট্যাটিক অ্যাট্রিবিউটের সাথে ইন্টারঅ্যাক্ট করে C++ বাইনারিগুলি গতিশীলভাবে লিঙ্ক করা হবে কিনা তা নির্ধারণ করে।

মোড:

• auto : একটি প্ল্যাটফর্ম-নির্ভর মোডে অনুবাদ করে; লিনাক্সের জন্য default এবং সাইগউইনের জন্য off ।
• default : গতিশীলভাবে লিঙ্ক করতে হবে কিনা তা বেছে নিতে বেজেলকে অনুমতি দেয়। আরও তথ্যের জন্য লিঙ্কস্ট্যাটিক দেখুন।
• fully : গতিশীলভাবে সমস্ত লক্ষ্যকে লিঙ্ক করে। এটি লিঙ্ক করার সময়কে দ্রুত করবে এবং ফলস্বরূপ বাইনারিগুলির আকার হ্রাস করবে।
• off : বেশিরভাগ স্ট্যাটিক মোডে সমস্ত লক্ষ্যকে লিঙ্ক করে। -static সেট করা থাকলে, লক্ষ্যগুলি সম্পূর্ণরূপে স্থির হয়ে যাবে।

--fission (yes|no|[dbg][,opt][,fastbuild])

ফিশন সক্রিয় করে, যা .o ফাইলের পরিবর্তে ডেডিকেটেড .dwo ফাইলগুলিতে C++ ডিবাগ তথ্য লেখে, যেখানে এটি অন্যথায় যাবে। এটি উল্লেখযোগ্যভাবে লিঙ্কগুলিতে ইনপুট আকার হ্রাস করে এবং লিঙ্কের সময় কমাতে পারে।

যখন [dbg][,opt][,fastbuild] (উদাহরণ: --fission=dbg,fastbuild ) তে সেট করা হয়, শুধুমাত্র সংকলন মোডের নির্দিষ্ট সেটের জন্য ফিশন সক্রিয় করা হয়। এটি bazelrc সেটিংসের জন্য দরকারী। yes সেট করা হলে, ফিশন সার্বজনীনভাবে সক্রিয় করা হয়। no সেট করা হলে, ফিশন সার্বজনীনভাবে অক্ষম করা হয়। ডিফল্ট no .

--force_ignore_dash_static

যদি এই পতাকা সেট করা থাকে, তাহলে cc_* -static বিকল্পগুলি উপেক্ষা করা হয়। এটি শুধুমাত্র C++ হার্ডেনিং বিল্ডগুলির জন্য একটি সমাধান হিসাবে উদ্দেশ্যে করা হয়েছে।

--[no]force_pic

সক্ষম হলে, সমস্ত C++ সংকলন পজিশন-স্বাধীন কোড ("-fPIC") তৈরি করে, লিঙ্কগুলি PIC-এর পূর্ব-নির্মিত লাইব্রেরিগুলিকে নন-PIC লাইব্রেরির চেয়ে পছন্দ করে এবং লিঙ্কগুলি অবস্থান-স্বাধীন এক্সিকিউটেবল ("-pie") তৈরি করে। ডিফল্ট নিষ্ক্রিয় করা হয়.

দ্রষ্টব্য: গতিশীলভাবে লিঙ্কযুক্ত বাইনারিগুলি (উদাহরণস্বরূপ --dynamic_mode fully ) এই পতাকার সেটিং নির্বিশেষে PIC কোড তৈরি করে৷ সুতরাং এই পতাকাটি সেই ক্ষেত্রে যেখানে ব্যবহারকারীরা স্ট্যাটিক লিঙ্কগুলির জন্য স্পষ্টভাবে PIC কোড তৈরি করতে চান।

--android_resource_shrinking

android_binary নিয়মের জন্য রিসোর্স সঙ্কুচিত করা হবে কিনা তা নির্বাচন করে। android_binary নিয়মে shrink_resources অ্যাট্রিবিউটের জন্য ডিফল্ট সেট করে; আরও বিস্তারিত জানার জন্য সেই নিয়মের ডকুমেন্টেশন দেখুন। ডিফল্ট বন্ধ.

--custom_malloc= malloc-library-target

নির্দিষ্ট করা হলে, সর্বদা প্রদত্ত malloc বাস্তবায়ন ব্যবহার করুন, সমস্ত malloc="target" বৈশিষ্ট্যগুলিকে ওভাররাইড করে, সেই লক্ষ্যগুলি সহ যেগুলি ডিফল্ট ব্যবহার করে (কোনও malloc নির্দিষ্ট না করে)।

--crosstool_top= label

এই বিকল্পটি একটি বিল্ডের সময় সমস্ত C++ সংকলনের জন্য ব্যবহার করা ক্রসটুল কম্পাইলার স্যুটের অবস্থান নির্দিষ্ট করে। Bazel একটি CROSSTOOL ফাইলের জন্য সেই অবস্থানে দেখবে এবং স্বয়ংক্রিয়ভাবে --compiler সেটিংস নির্ধারণ করতে সেটি ব্যবহার করবে।

--host_crosstool_top= label

নির্দিষ্ট করা না থাকলে, হোস্ট কনফিগারেশনে কোড কম্পাইল করার জন্য Bazel --crosstool_top এর মান ব্যবহার করে, যেমন বিল্ড চলাকালীন টুলগুলি চালানো হয়। এই পতাকার মূল উদ্দেশ্য ক্রস-সংকলন সক্ষম করা।

--apple_crosstool_top= label

objc *, ios *, এবং apple * নিয়মগুলির ট্রানজিটিভ deps C/C++ নিয়মগুলি কম্পাইল করার জন্য ব্যবহার করার জন্য ক্রসটুল। সেই লক্ষ্যগুলির জন্য, এই পতাকাটি --crosstool_top ওভাররাইট করে।

--android_crosstool_top= label

android_binary নিয়মের ট্রানজিটিভ deps C/C++ নিয়ম কম্পাইল করার জন্য ক্রসটুল ব্যবহার করা হবে। বিল্ডের অন্যান্য লক্ষ্যগুলির জন্য একটি ভিন্ন ক্রসটুল প্রয়োজন হলে এটি কার্যকর। ডিফল্ট হল WORKSPACE ফাইলে android_ndk_repository নিয়ম দ্বারা তৈরি করা ক্রসটুল ব্যবহার করা। এছাড়াও দেখুন --fat_apk_cpu ।

--compiler= version

এই বিকল্পটি C/C++ কম্পাইলার সংস্করণ (যেমন gcc-4.1.0 ) নির্দিষ্ট করে যা নির্মাণের সময় বাইনারিগুলির সংকলনের জন্য ব্যবহার করা হবে। আপনি যদি একটি কাস্টম ক্রসটুল দিয়ে তৈরি করতে চান, তাহলে এই পতাকা নির্দিষ্ট করার পরিবর্তে আপনার একটি CROSSTOOL ফাইল ব্যবহার করা উচিত।

দ্রষ্টব্য: ক্রসটুল সংস্করণ, কম্পাইলার সংস্করণ এবং লক্ষ্য CPU-এর শুধুমাত্র কিছু সংমিশ্রণ অনুমোদিত।

--android_sdk= label

এই বিকল্পটি Android SDK/প্ল্যাটফর্ম টুলচেন এবং Android রানটাইম লাইব্রেরি নির্দিষ্ট করে যা Android-সম্পর্কিত যেকোনো নিয়ম তৈরি করতে ব্যবহার করা হবে।

যদি WORKSPACE ফাইলে একটি android_sdk_repository নিয়ম সংজ্ঞায়িত করা থাকে তাহলে Android SDK স্বয়ংক্রিয়ভাবে নির্বাচিত হবে।

--java_toolchain= label

এই বিকল্পটি জাভা সোর্স ফাইল কম্পাইল করতে ব্যবহৃত java_toolchain-এর লেবেল নির্দিষ্ট করে।

--host_java_toolchain= label

নির্দিষ্ট করা না থাকলে, হোস্ট কনফিগারেশনে কোড কম্পাইল করতে --java_toolchain এর মান ব্যবহার করে, যেমন বিল্ড চলাকালীন চালানো টুলগুলির জন্য। এই পতাকার মূল উদ্দেশ্য ক্রস-সংকলন সক্ষম করা।

--javabase=( label )

এই বিকল্পটি bazel রান , bazel test , এবং java_binary এবং java_test নিয়ম দ্বারা নির্মিত জাভা বাইনারিগুলির জন্য ব্যবহার করার জন্য বেস জাভা ইনস্টলেশনের লেবেল সেট করে। JAVABASE এবং JAVA "Make" ভেরিয়েবল এই বিকল্প থেকে উদ্ভূত হয়েছে।

--host_javabase= label

এই বিকল্পটি হোস্ট কনফিগারেশনে ব্যবহার করার জন্য বেস জাভা ইনস্টলেশনের লেবেল সেট করে, উদাহরণস্বরূপ JavaBuilder এবং Singlejar সহ হোস্ট বিল্ড টুলের জন্য।

এটি জাভা কম্পাইলার নির্বাচন করে না যা জাভা সোর্স ফাইল কম্পাইল করতে ব্যবহৃত হয়। --java_toolchain বিকল্পটি সেটিংস করে কম্পাইলার নির্বাচন করা যেতে পারে।

মৃত্যুদন্ড কার্যকর করার কৌশল

এই বিকল্পগুলি ব্যাজেল কীভাবে বিল্ডটি কার্যকর করবে তা প্রভাবিত করে। বিল্ড দ্বারা উত্পন্ন আউটপুট ফাইলগুলিতে তাদের কোনও উল্লেখযোগ্য প্রভাব থাকা উচিত নয়। সাধারণত তাদের প্রধান প্রভাব বিল্ড গতি উপর হয়.

--spawn_strategy= strategy

এই বিকল্পটি কোথায় এবং কিভাবে কমান্ড কার্যকর করা হয় তা নিয়ন্ত্রণ করে।

• standalone কমান্ড স্থানীয় সাবপ্রসেস হিসাবে নির্বাহ করা হয়. এই মান অবমূল্যায়ন করা হয়. পরিবর্তে local ব্যবহার করুন.
• sandboxed কারণে স্থানীয় মেশিনে একটি স্যান্ডবক্সের ভিতরে কমান্ড কার্যকর করা হয়। এর জন্য প্রয়োজন যে সমস্ত ইনপুট ফাইল, ডেটা নির্ভরতা এবং সরঞ্জামগুলি srcs , data এবং tools বৈশিষ্ট্যগুলিতে সরাসরি নির্ভরতা হিসাবে তালিকাভুক্ত করা হয়৷ ব্যাজেল ডিফল্টরূপে স্থানীয় স্যান্ডবক্সিং সক্ষম করে, এমন সিস্টেমে যেগুলি স্যান্ডবক্সড এক্সিকিউশন সমর্থন করে।
• local কারণ কমান্ড।
• worker একটি অবিরাম কর্মী ব্যবহার করে কমান্ড কার্যকর করার কারণ, যদি উপলব্ধ থাকে।
• docker স্থানীয় মেশিনে একটি ডকার স্যান্ডবক্সের ভিতরে কমান্ড কার্যকর করার কারণ করে। এর জন্য ডকার ইনস্টল করা প্রয়োজন।
• remote কারণে কমান্ড দূরবর্তীভাবে কার্যকর করা হয়; এটি শুধুমাত্র উপলব্ধ হয় যদি একটি দূরবর্তী নির্বাহককে আলাদাভাবে কনফিগার করা হয়।

--strategy mnemonic = strategy

এই বিকল্পটি প্রতি-স্মরণীয় ভিত্তিতে --spawn_strategy (এবং mnemonic Genrule-এর সাথে --genrule_strategy) ওভাররাইড করে, কোথায় এবং কিভাবে কমান্ড চালানো হয় তা নিয়ন্ত্রণ করে। সমর্থিত কৌশল এবং তাদের প্রভাবের জন্য --spawn_strategy দেখুন।

--strategy_regexp= <filter,filter,...>=<strategy>

একটি নির্দিষ্ট regex_filter সাথে মেলে এমন কমান্ডগুলি চালানোর জন্য কোন কৌশলটি ব্যবহার করা উচিত তা এই বিকল্পটি নির্দিষ্ট করে। regex_filter মিলের বিস্তারিত জানার জন্য --per_file_copt দেখুন। সমর্থিত কৌশল এবং তাদের প্রভাবের জন্য --spawn_strategy দেখুন।

বর্ণনার সাথে মেলে শেষ regex_filter ব্যবহার করা হয়। কৌশল নির্দিষ্ট করার জন্য এই বিকল্পটি অন্যান্য ফ্ল্যাগ ওভাররাইড করে।

• উদাহরণ: --strategy_regexp=//foo.*\\.cc,-//foo/bar=local মানে local কৌশল ব্যবহার করে অ্যাকশন চালানো যদি তাদের বিবরণ //foo.*.cc মেলে তবে //foo/bar না।
• উদাহরণ: --strategy_regexp='Compiling.*/bar=local' --strategy_regexp=Compiling=sandboxed sandboxed করা কৌশলের সাথে 'কম্পাইলিং //foo/bar/baz' চালায়, কিন্তু ক্রম বিপরীত করলে তা local দিয়ে চলে।
• উদাহরণ: --strategy_regexp='Compiling.*/bar=local,sandboxed' local কৌশলের সাথে 'কম্পাইলিং //foo/bar/baz' চালায় এবং এটি ব্যর্থ হলে sandboxed ফিরে আসে।

--genrule_strategy= strategy

এটি --strategy=Genrule= strategy -এর জন্য একটি অপপ্রচারিত শর্ট-হ্যান্ড।

--jobs= n )

এই বিকল্পটি, যা একটি পূর্ণসংখ্যা আর্গুমেন্ট নেয়, বিল্ডের এক্সিকিউশন পর্বের সময় একযোগে কার্যকর করা কাজের সংখ্যার একটি সীমা নির্দিষ্ট করে।

দ্রষ্টব্য: Bazel যে সমসাময়িক চাকরিগুলি চালাবে তা কেবল --jobs সেটিং দ্বারা নয়, Bazel-এর সময়সূচী দ্বারাও নির্ধারিত হয়, যা উপলভ্যের চেয়ে বেশি সংস্থান (RAM বা CPU) ব্যবহার করবে এমন একযোগে কাজ চালানো এড়াতে চেষ্টা করে, প্রতিটি কাজের সম্পদ খরচের কিছু (খুব অশোধিত) অনুমানের উপর ভিত্তি করে। শিডিউলারের আচরণ --local_ram_resources বিকল্প দ্বারা নিয়ন্ত্রিত হতে পারে।

--progress_report_interval= n

বেজেল পর্যায়ক্রমে এমন কাজগুলির একটি অগ্রগতি প্রতিবেদন প্রিন্ট করে যা এখনও শেষ হয়নি (যেমন দীর্ঘমেয়াদী পরীক্ষা)। এই বিকল্পটি রিপোর্টিং ফ্রিকোয়েন্সি সেট করে, অগ্রগতি প্রতি n সেকেন্ডে মুদ্রিত হবে।

ডিফল্ট হল 0, এর মানে হল একটি ক্রমবর্ধমান অ্যালগরিদম: প্রথম রিপোর্টটি 10 ​​সেকেন্ড পরে মুদ্রিত হবে, তারপর 30 সেকেন্ড এবং তারপরে প্রতি মিনিটে একবার অগ্রগতি রিপোর্ট করা হবে।

যখন bazel কার্সার নিয়ন্ত্রণ ব্যবহার করে, যেমন --curses দ্বারা নির্দিষ্ট করা হয়েছে, প্রতি সেকেন্ডে অগ্রগতি রিপোর্ট করা হয়।

--local_{ram,cpu}_resources resources or resource expression

এই বিকল্পগুলি স্থানীয় সংস্থানগুলির পরিমাণ নির্দিষ্ট করে (MB-এ RAM এবং CPU লজিক্যাল কোরের সংখ্যা) যা স্থানীয়ভাবে চালানোর জন্য বিল্ড এবং পরীক্ষা কার্যক্রমের সময় নির্ধারণ করার সময় Bazel বিবেচনা করতে পারে। তারা একটি পূর্ণসংখ্যা নেয়, অথবা একটি কীওয়ার্ড (HOST_RAM বা HOST_CPUS) ঐচ্ছিকভাবে [-|* float ] দ্বারা অনুসরণ করে (উদাহরণস্বরূপ, --local_cpu_resources=2 , --local_ram_resources=HOST_RAM*.5 , --local_cpu_resources=HOST_CPUS-1 )। পতাকা স্বাধীন; এক বা উভয় সেট করা যেতে পারে। ডিফল্টরূপে, Bazel স্থানীয় সিস্টেমের কনফিগারেশন থেকে সরাসরি RAM এর পরিমাণ এবং CPU কোরের সংখ্যা অনুমান করে।

--[no]build_runfile_links

এই বিকল্পটি, যা ডিফল্টরূপে সক্রিয় থাকে, পরীক্ষা এবং বাইনারিগুলির জন্য রানফাইল সিমলিংকগুলি আউটপুট ডিরেক্টরিতে তৈরি করা উচিত কিনা তা নির্দিষ্ট করে। --nobuild_runfile_links ব্যবহার করে সকল টার্গেট রানফাইল ট্রি নির্মাণের জন্য ওভারহেড খরচ না করেই কম্পাইল করা হলে তা যাচাই করতে উপযোগী হতে পারে।

যখন পরীক্ষা (বা অ্যাপ্লিকেশন) চালানো হয়, তাদের রান-টাইম ডেটা নির্ভরতা এক জায়গায় একত্রিত হয়। ব্যাজেলের আউটপুট ট্রির মধ্যে, এই "রানফাইলস" গাছটি সাধারণত সংশ্লিষ্ট বাইনারি বা পরীক্ষার ভাইবোন হিসাবে রুট করা হয়। পরীক্ষা সম্পাদনের সময়, $TEST_SRCDIR/workspace/ packagename / filename ফর্মের পাথ ব্যবহার করে রানফাইলগুলি অ্যাক্সেস করা যেতে পারে। রানফাইলস ট্রি নিশ্চিত করে যে পরীক্ষার সমস্ত ফাইলে অ্যাক্সেস রয়েছে যেগুলির উপর তাদের একটি ঘোষিত নির্ভরতা রয়েছে এবং এর বেশি কিছু নয়। ডিফল্টরূপে, প্রয়োজনীয় ফাইলগুলির প্রতীকী লিঙ্কগুলির একটি সেট তৈরি করে রানফাইলস ট্রি প্রয়োগ করা হয়। লিঙ্কের সেট বাড়ার সাথে সাথে এই অপারেশনের খরচও বাড়ে, এবং কিছু বড় বিল্ডের জন্য এটি সামগ্রিক বিল্ড টাইমে উল্লেখযোগ্যভাবে অবদান রাখতে পারে, বিশেষ করে কারণ প্রতিটি পৃথক পরীক্ষা (বা অ্যাপ্লিকেশন) এর নিজস্ব রানফাইল ট্রি প্রয়োজন।

--[no]build_runfile_manifests

এই বিকল্পটি, যা ডিফল্টরূপে সক্রিয় থাকে, রানফাইল ম্যানিফেস্ট আউটপুট ট্রিতে লেখা উচিত কিনা তা নির্দিষ্ট করে। এটি নিষ্ক্রিয় করা বোঝায় --nobuild_runfile_links ।

দূরবর্তীভাবে পরীক্ষা চালানোর সময় এটি নিষ্ক্রিয় করা যেতে পারে, কারণ রানফাইল ট্রিগুলি ইন-মেমরি ম্যানিফেস্ট থেকে দূরবর্তীভাবে তৈরি করা হবে।

--[no]discard_analysis_cache

যখন এই বিকল্পটি সক্রিয় থাকে, তখন এক্সিকিউশন শুরু হওয়ার ঠিক আগে Bazel বিশ্লেষণ ক্যাশে বাতিল করে দেবে, এইভাবে এক্সিকিউশন পর্বের জন্য অতিরিক্ত মেমরি (প্রায় 10%) মুক্ত করবে৷ অসুবিধা হল যে আরও বর্ধিত বিল্ডগুলি ধীর হবে। এছাড়াও মেমরি-সেভিং মোড দেখুন।

--[no]keep_going (-কে)

GNU Make-এর মতো, প্রথম ত্রুটির সম্মুখীন হলে বিল্ডের এক্সিকিউশন ফেজ বন্ধ হয়ে যায়। কখনও কখনও ত্রুটির মুখেও যতটা সম্ভব নির্মাণের চেষ্টা করা কার্যকর। এই বিকল্পটি সেই আচরণকে সক্ষম করে, এবং যখন এটি নির্দিষ্ট করা হয়, বিল্ডটি প্রতিটি লক্ষ্য তৈরি করার চেষ্টা করবে যার পূর্বশর্তগুলি সফলভাবে নির্মিত হয়েছিল, কিন্তু ত্রুটিগুলি উপেক্ষা করবে।

যদিও এই বিকল্পটি সাধারণত একটি বিল্ডের এক্সিকিউশন ফেজের সাথে যুক্ত থাকে, এটি বিশ্লেষণ ফেজকেও প্রভাবিত করে: যদি একটি বিল্ড কমান্ডে বেশ কয়েকটি লক্ষ্য নির্দিষ্ট করা থাকে, কিন্তু শুধুমাত্র তাদের মধ্যে কয়েকটি সফলভাবে বিশ্লেষণ করা যায়, তবে বিল্ডটি একটি ত্রুটির সাথে বন্ধ হয়ে যাবে যদি না --keep_going নির্দিষ্ট করা আছে, এই ক্ষেত্রে বিল্ডটি এক্সিকিউশন পর্বে এগিয়ে যাবে, কিন্তু শুধুমাত্র সেই লক্ষ্যগুলির জন্য যা সফলভাবে বিশ্লেষণ করা হয়েছে।

--[no]use_ijars

এই বিকল্পটি Bazel দ্বারা java_library টার্গেট কম্পাইল করার উপায় পরিবর্তন করে। নির্ভরশীল java_library টার্গেট কম্পাইল করার জন্য একটি java_library এর আউটপুট ব্যবহার করার পরিবর্তে, Bazel ইন্টারফেস জার তৈরি করবে যাতে শুধুমাত্র অ-প্রাইভেট সদস্যদের (সর্বজনীন, সুরক্ষিত, এবং ডিফল্ট (প্যাকেজ) অ্যাক্সেস পদ্ধতি এবং ক্ষেত্র) স্বাক্ষর থাকে এবং ইন্টারফেস জারগুলি ব্যবহার করে নির্ভরশীল লক্ষ্যগুলি কম্পাইল করুন। এটি পুনঃসংকলন এড়ানো সম্ভব করে যখন পরিবর্তনগুলি শুধুমাত্র মেথড বডি বা ক্লাসের ব্যক্তিগত সদস্যদের জন্য করা হয়।

দ্রষ্টব্য: --use_ijars ব্যবহার করা আপনাকে একটি ভিন্ন ত্রুটির বার্তা দিতে পারে যখন আপনি ঘটনাক্রমে অন্য শ্রেণীর একজন অদৃশ্যমান সদস্যকে উল্লেখ করছেন: সদস্যটি দৃশ্যমান নয় এমন একটি ত্রুটি পাওয়ার পরিবর্তে আপনি একটি ত্রুটি পাবেন যে সদস্যটির অস্তিত্ব নেই। --use_ijars সেটিং পরিবর্তন করা হলে সমস্ত প্রভাবিত ক্লাসের পুনঃসংকলন বাধ্য হবে।

--[no]interface_shared_objects

এই বিকল্পটি ইন্টারফেস শেয়ার্ড অবজেক্টকে সক্ষম করে, যা বাইনারি এবং অন্যান্য শেয়ার্ড লাইব্রেরিগুলিকে একটি শেয়ার্ড অবজেক্টের ইন্টারফেসের উপর নির্ভর করে, এর বাস্তবায়নের পরিবর্তে। যখন শুধুমাত্র বাস্তবায়ন পরিবর্তিত হয়, তখন Bazel অপ্রয়োজনীয়ভাবে পরিবর্তিত শেয়ার্ড লাইব্রেরির উপর নির্ভর করে পুনর্নির্মাণ লক্ষ্যগুলি এড়াতে পারে।

আউটপুট নির্বাচন

এই বিকল্পগুলি নির্ধারণ করে কি নির্মাণ বা পরীক্ষা করা হবে।

--[no]build

এই বিকল্পটি বিল্ডের এক্সিকিউশন ফেজ ঘটায়; এটি ডিফল্টরূপে চালু আছে। যখন এটি সুইচ অফ করা হয়, তখন সম্পাদনের পর্যায়টি এড়িয়ে যায় এবং শুধুমাত্র প্রথম দুটি পর্যায়, লোডিং এবং বিশ্লেষণ ঘটে।

এই বিকল্পটি বিল্ড ফাইলগুলি যাচাই করার জন্য এবং ইনপুটগুলিতে ত্রুটি সনাক্ত করার জন্য কার্যকর হতে পারে, আসলে কিছু তৈরি না করে।

--[no]build_tests_only

নির্দিষ্ট করা থাকলে, Bazel শুধুমাত্র সেইগুলি তৈরি করবে যা *_test এবং test_suite নিয়মগুলি চালানোর জন্য প্রয়োজনীয় যা তাদের আকার , সময়সীমা , ট্যাগ বা ভাষার কারণে ফিল্টার করা হয়নি। নির্দিষ্ট করা হলে, Bazel কমান্ড লাইনে নির্দিষ্ট করা অন্যান্য লক্ষ্য উপেক্ষা করবে। By default, this option is disabled and Bazel will build everything requested, including *_test and test_suite rules that are filtered out from testing. This is useful because running bazel test --build_tests_only foo/... may not detect all build breakages in the foo tree.

--[no]check_up_to_date

This option causes Bazel not to perform a build, but merely check whether all specified targets are up-to-date. If so, the build completes successfully, as usual. However, if any files are out of date, instead of being built, an error is reported and the build fails. This option may be useful to determine whether a build has been performed more recently than a source edit (for example, for pre-submit checks) without incurring the cost of a build.

See also --check_tests_up_to_date .

--[no]compile_one_dependency

Compile a single dependency of the argument files. This is useful for syntax checking source files in IDEs, for example, by rebuilding a single target that depends on the source file to detect errors as early as possible in the edit/build/test cycle. This argument affects the way all non-flag arguments are interpreted: each argument must be a file target label or a plain filename relative to the current working directory, and one rule that depends on each source filename is built. For

C++ and Java sources, rules in the same language space are preferentially chosen. For multiple rules with the same preference, the one that appears first in the BUILD file is chosen. An explicitly named target pattern which does not reference a source file results in an error.

--save_temps

The --save_temps option causes temporary outputs from the compiler to be saved. These include .s files (assembler code), .i (preprocessed C) and .ii (preprocessed C++) files. These outputs are often useful for debugging. Temps will only be generated for the set of targets specified on the command line.

Note: The implementation of --save_temps does not use the compiler's -save-temps flag. Instead, there are two passes, one with -S and one with -E . A consequence of this is that if your build fails, Bazel may not yet have produced the ".i" or ".ii" and ".s" files. If you're trying to use --save_temps to debug a failed compilation, you may need to also use --keep_going so that Bazel will still try to produce the preprocessed files after the compilation fails.

The --save_temps flag currently works only for cc_* rules.

To ensure that Bazel prints the location of the additional output files, check that your --show_result n setting is high enough.

--build_tag_filters= tag[,tag]*

If specified, Bazel will build only targets that have at least one required tag (if any of them are specified) and does not have any excluded tags. Build tag filter is specified as comma delimited list of tag keywords, optionally preceded with '-' sign used to denote excluded tags. Required tags may also have a preceding '+' sign.

When running tests, Bazel ignores --build_tag_filters for test targets, which are built and run even if they do not match this filter. To avoid building them, filter test targets using --test_tag_filters or by explicitly excluding them.

--test_size_filters= size[,size]*

If specified, Bazel will test (or build if --build_tests_only is also specified) only test targets with the given size. Test size filter is specified as comma delimited list of allowed test size values (small, medium, large or enormous), optionally preceded with '-' sign used to denote excluded test sizes. For example,

  % bazel test --test_size_filters=small,medium //foo:all

and

  % bazel test --test_size_filters=-large,-enormous //foo:all

will test only small and medium tests inside //foo.

By default, test size filtering is not applied.

--test_timeout_filters= timeout[,timeout]*

If specified, Bazel will test (or build if --build_tests_only is also specified) only test targets with the given timeout. Test timeout filter is specified as comma delimited list of allowed test timeout values (short, moderate, long or eternal), optionally preceded with '-' sign used to denote excluded test timeouts. See --test_size_filters for example syntax.

By default, test timeout filtering is not applied.

--test_tag_filters= tag[,tag]*

If specified, Bazel will test (or build if --build_tests_only is also specified) only test targets that have at least one required tag (if any of them are specified) and does not have any excluded tags. Test tag filter is specified as comma delimited list of tag keywords, optionally preceded with '-' sign used to denote excluded tags. Required tags may also have a preceding '+' sign.

For example,

  % bazel test --test_tag_filters=performance,stress,-flaky //myproject:all

will test targets that are tagged with either performance or stress tag but are not tagged with the flaky tag.

By default, test tag filtering is not applied. Note that you can also filter on test's size and local tags in this manner.

--test_lang_filters= string[,string]*

Specifies a comma-separated list of strings referring to names of test rule classes. To refer to the rule class foo_test , use the string "foo". Bazel will test (or build if --build_tests_only is also specified) only targets of the referenced rule classes. To instead exclude those targets, use the string "-foo". For example,

  % bazel test --test_lang_filters=foo,bar //baz/...

will test only targets that are instances of foo_test or bar_test in //baz/... , while

  % bazel test --test_lang_filters=-foo,-bar //baz/...

will test all the targets in //baz/... except for the foo_test and bar_test instances.

Tip: You can use bazel query --output=label_kind "//p:t" to learn the rule class name of the target //p:t . And you can look at the pair of instantiation stacks in the output of bazel query --output=build "//p:t" to learn why that target is an instance of that rule class.

Warning: The option name "--test_lang_filter" is vestigal and is therefore unfortunately misleading; don't make assumptions about the semantics based on the name.

--test_filter= filter-expression

Specifies a filter that the test runner may use to pick a subset of tests for running. All targets specified in the invocation are built, but depending on the expression only some of them may be executed; in some cases, only certain test methods are run.

The particular interpretation of filter-expression is up to the test framework responsible for running the test. It may be a glob, substring, or regexp. --test_filter is a convenience over passing different --test_arg filter arguments, but not all frameworks support it.

Verbosity

These options control the verbosity of Bazel's output, either to the terminal, or to additional log files.

--explain= logfile

This option, which requires a filename argument, causes the dependency checker in bazel build 's execution phase to explain, for each build step, either why it is being executed, or that it is up-to-date. The explanation is written to logfile .

If you are encountering unexpected rebuilds, this option can help to understand the reason. Add it to your .bazelrc so that logging occurs for all subsequent builds, and then inspect the log when you see an execution step executed unexpectedly. This option may carry a small performance penalty, so you might want to remove it when it is no longer needed.

--verbose_explanations

This option increases the verbosity of the explanations generated when the --explain option is enabled.

In particular, if verbose explanations are enabled, and an output file is rebuilt because the command used to build it has changed, then the output in the explanation file will include the full details of the new command (at least for most commands).

Using this option may significantly increase the length of the generated explanation file and the performance penalty of using --explain .

If --explain is not enabled, then --verbose_explanations has no effect.

--profile= file

This option, which takes a filename argument, causes Bazel to write profiling data into a file. The data then can be analyzed or parsed using the bazel analyze-profile command. The Build profile can be useful in understanding where Bazel's build command is spending its time.

--[no]show_loading_progress

This option causes Bazel to output package-loading progress messages. If it is disabled, the messages won't be shown.

--[no]show_progress

This option causes progress messages to be displayed; it is on by default. When disabled, progress messages are suppressed.

--show_progress_rate_limit= n

This option causes bazel to display at most one progress message per n seconds, where n is a real number. The default value for this option is 0.02, meaning bazel will limit the progress messages to one per every 0.02 seconds.

--show_result= n

This option controls the printing of result information at the end of a bazel build command. By default, if a single build target was specified, Bazel prints a message stating whether or not the target was successfully brought up-to-date, and if so, the list of output files that the target created. If multiple targets were specified, result information is not displayed.

While the result information may be useful for builds of a single target or a few targets, for large builds (such as an entire top-level project tree), this information can be overwhelming and distracting; this option allows it to be controlled. --show_result takes an integer argument, which is the maximum number of targets for which full result information should be printed. By default, the value is 1. Above this threshold, no result information is shown for individual targets. Thus zero causes the result information to be suppressed always, and a very large value causes the result to be printed always.

Users may wish to choose a value in-between if they regularly alternate between building a small group of targets (for example, during the compile-edit-test cycle) and a large group of targets (for example, when establishing a new workspace or running regression tests). In the former case, the result information is very useful whereas in the latter case it is less so. As with all options, this can be specified implicitly via the .bazelrc file.

The files are printed so as to make it easy to copy and paste the filename to the shell, to run built executables. The "up-to-date" or "failed" messages for each target can be easily parsed by scripts which drive a build.

--sandbox_debug

This option causes Bazel to print extra debugging information when using sandboxing for action execution. This option also preserves sandbox directories, so that the files visible to actions during execution can be examined.

--subcommands ( -s )

This option causes Bazel's execution phase to print the full command line for each command prior to executing it.

  >>>>> # //examples/cpp:hello-world [action 'Linking examples/cpp/hello-world']
  (cd /home/johndoe/.cache/bazel/_bazel_johndoe/4c084335afceb392cfbe7c31afee3a9f/bazel && \
    exec env - \
    /usr/bin/gcc -o bazel-out/local-fastbuild/bin/examples/cpp/hello-world -B/usr/bin/ -Wl,-z,relro,-z,now -no-canonical-prefixes -pass-exit-codes -Wl,-S -Wl,@bazel-out/local_linux-fastbuild/bin/examples/cpp/hello-world-2.params)

Where possible, commands are printed in a Bourne shell compatible syntax, so that they can be easily copied and pasted to a shell command prompt. (The surrounding parentheses are provided to protect your shell from the cd and exec calls; be sure to copy them!) However some commands are implemented internally within Bazel, such as creating symlink trees. For these there's no command line to display.

--subcommands=pretty_print may be passed to print the arguments of the command as a list rather than as a single line. This may help make long command lines more readable.

See also --verbose_failures , below.

For logging subcommands to a file in a tool-friendly format, see --execution_log_json_file and --execution_log_binary_file .

--verbose_failures

This option causes Bazel's execution phase to print the full command line for commands that failed. This can be invaluable for debugging a failing build.

Failing commands are printed in a Bourne shell compatible syntax, suitable for copying and pasting to a shell prompt.

Workspace status

Use these options to "stamp" Bazel-built binaries: to embed additional information into the binaries, such as the source control revision or other workspace-related information. You can use this mechanism with rules that support the stamp attribute, such as genrule , cc_binary , and more.

--workspace_status_command= program

This flag lets you specify a binary that Bazel runs before each build. The program can report information about the status of the workspace, such as the current source control revision.

The flag's value must be a path to a native program. On Linux/macOS this may be any executable. On Windows this must be a native binary, typically an ".exe", ".bat", or a ".cmd" file.

The program should print zero or more key/value pairs to standard output, one entry on each line, then exit with zero (otherwise the build fails). The key names can be anything but they may only use upper case letters and underscores. The first space after the key name separates it from the value. The value is the rest of the line (including additional whitespaces). Neither the key nor the value may span multiple lines. Keys must not be duplicated.

Bazel partitions the keys into two buckets: "stable" and "volatile". (The names "stable" and "volatile" are a bit counter-intuitive, so don't think much about them.)

Bazel then writes the key-value pairs into two files:

• bazel-out/stable-status.txt contains all keys and values where the key's name starts with STABLE_
• bazel-out/volatile-status.txt contains the rest of the keys and their values

The contract is:

• "stable" keys' values should change rarely, if possible. If the contents of bazel-out/stable-status.txt change, Bazel invalidates the actions that depend on them. In other words, if a stable key's value changes, Bazel will rerun stamped actions. Therefore the stable status should not contain things like timestamps, because they change all the time, and would make Bazel rerun stamped actions with each build.

  Bazel always outputs the following stable keys:

  • BUILD_EMBED_LABEL : value of --embed_label
  • BUILD_HOST : the name of the host machine that Bazel is running on
  • BUILD_USER : the name of the user that Bazel is running as

• "volatile" keys' values may change often. Bazel expects them to change all the time, like timestamps do, and duly updates the bazel-out/volatile-status.txt file. In order to avoid rerunning stamped actions all the time though, Bazel pretends that the volatile file never changes . In other words, if the volatile status file is the only file whose contents has changed, Bazel will not invalidate actions that depend on it. If other inputs of the actions have changed, then Bazel reruns that action, and the action will see the updated volatile status, but just the volatile status changing alone will not invalidate the action.

  Bazel always outputs the following volatile keys:

  • BUILD_TIMESTAMP : time of the build in seconds since the Unix Epoch (the value of System.currentTimeMillis() divided by a thousand)

On Linux/macOS you can pass --workspace_status_command=/bin/true to disable retrieving workspace status, because true does nothing, successfully (exits with zero) and prints no output. On Windows you can pass the path of MSYS's true.exe for the same effect.

If the workspace status command fails (exits non-zero) for any reason, the build will fail.

Example program on Linux using Git:

#!/bin/bash
echo "CURRENT_TIME $(date +%s)"
echo "RANDOM_HASH $(cat /proc/sys/kernel/random/uuid)"
echo "STABLE_GIT_COMMIT $(git rev-parse HEAD)"
echo "STABLE_USER_NAME $USER"

Pass this program's path with --workspace_status_command , and the stable status file will include the STABLE lines and the volatile status file will include the rest of the lines.

--[no]stamp

This option, in conjunction with the stamp rule attribute, controls whether to embed build information in binaries.

Stamping can be enabled or disabled explicitly on a per-rule basis using the stamp attribute. Please refer to the Build Encyclopedia for details. When a rule sets stamp = -1 (the default for *_binary rules), this option determines whether stamping is enabled.

Bazel never stamps binaries that are built for the host configuration, regardless of this option or the stamp attribute. For rules that set stamp = 0 (the default for *_test rules), stamping is disabled regardless of --[no]stamp . Specifying --stamp does not force targets to be rebuilt if their dependencies have not changed.

Setting --nostamp is generally desireable for build performance, as it reduces input volatility and maximizes build caching.

Platform

Use these options to control the host and target platforms that configure how builds work, and to control what execution platforms and toolchains are available to Bazel rules.

Please see background information on Platforms and Toolchains .

--platforms= labels

The labels of the platform rules describing the target platforms for the current command.

--host_platform= label

The label of a platform rule that describes the host system.

--extra_execution_platforms= labels

The platforms that are available as execution platforms to run actions. Platforms can be specified by exact target, or as a target pattern. These platforms will be considered before those declared in the WORKSPACE file by register_execution_platforms() .

--extra_toolchains= labels

The toolchain rules to be considered during toolchain resolution. Toolchains can be specified by exact target, or as a target pattern. These toolchains will be considered before those declared in the WORKSPACE file by register_toolchains() .

--toolchain_resolution_debug= regex

Print debug information while finding toolchains if the toolchain type matches the regex. Multiple regexes can be separated by commas. The regex can be negated by using a - at the beginning. This might help developers of Bazel or Starlark rules with debugging failures due to missing toolchains.

Miscellaneous

--flag_alias= alias_name=target_path

A convenience flag used to bind longer Starlark build settings to a shorter name. For more details, see the Starlark Configurations .

--symlink_prefix= string

Changes the prefix of the generated convenience symlinks. The default value for the symlink prefix is bazel- which will create the symlinks bazel-bin , bazel-testlogs , and bazel-genfiles .

If the symbolic links cannot be created for any reason, a warning is issued but the build is still considered a success. In particular, this allows you to build in a read-only directory or one that you have no permission to write into. Any paths printed in informational messages at the conclusion of a build will only use the symlink-relative short form if the symlinks point to the expected location; in other words, you can rely on the correctness of those paths, even if you cannot rely on the symlinks being created.

Some common values of this option:

• Suppress symlink creation: --symlink_prefix=/ will cause Bazel to not create or update any symlinks, including the bazel-out and bazel-<workspace> symlinks. Use this option to suppress symlink creation entirely.

• Reduce clutter: --symlink_prefix=.bazel/ will cause Bazel to create symlinks called bin (etc) inside a hidden directory .bazel .

--platform_suffix= string

Adds a suffix to the configuration short name, which is used to determine the output directory. Setting this option to different values puts the files into different directories, for example to improve cache hit rates for builds that otherwise clobber each others output files, or to keep the output files around for comparisons.

--default_visibility= (private|public)

Temporary flag for testing bazel default visibility changes. Not intended for general use but documented for completeness' sake.

--[no]use_action_cache

This option is enabled by default. If disabled, Bazel will not use its local action cache. Disabling the local action cache saves memory and disk space for clean builds, but will make incremental builds slower.

--starlark_cpu_profile=_file_

This flag, whose value is the name of a file, causes Bazel to gather statistics about CPU usage by all Starlark threads, and write the profile, in pprof format, to the named file.

Use this option to help identify Starlark functions that make loading and analysis slow due to excessive computation. For example:

$ bazel build --nobuild --starlark_cpu_profile=/tmp/pprof.gz my/project/...
$ pprof /tmp/pprof.gz
(pprof) top
Type: CPU
Time: Feb 6, 2020 at 12:06pm (PST)
Duration: 5.26s, Total samples = 3.34s (63.55%)
Showing nodes accounting for 3.34s, 100% of 3.34s total
      flat  flat%   sum%        cum   cum%
     1.86s 55.69% 55.69%      1.86s 55.69%  sort_source_files
     1.02s 30.54% 86.23%      1.02s 30.54%  expand_all_combinations
     0.44s 13.17% 99.40%      0.44s 13.17%  range
     0.02s   0.6%   100%      3.34s   100%  sorted
         0     0%   100%      1.38s 41.32%  my/project/main/BUILD
         0     0%   100%      1.96s 58.68%  my/project/library.bzl
         0     0%   100%      3.34s   100%  main

For different views of the same data, try the pprof commands svg , web , and list .

Using Bazel for releases

Bazel is used both by software engineers during the development cycle, and by release engineers when preparing binaries for deployment to production. This section provides a list of tips for release engineers using Bazel.

Significant options

When using Bazel for release builds, the same issues arise as for other scripts that perform a build. For more details, see Call Bazel from scripts . In particular, the following options are strongly recommended:

• --bazelrc=/dev/null
• --nokeep_state_after_build

These options are also important:

• --package_path
• --symlink_prefix : for managing builds for multiple configurations, it may be convenient to distinguish each build with a distinct identifier, such as "64bit" vs. "32bit". This option differentiates the bazel-bin (etc.) symlinks.

Running tests

To build and run tests with bazel, type bazel test followed by the name of the test targets.

By default, this command performs simultaneous build and test activity, building all specified targets (including any non-test targets specified on the command line) and testing *_test and test_suite targets as soon as their prerequisites are built, meaning that test execution is interleaved with building. Doing so usually results in significant speed gains.

Options for bazel test

--cache_test_results=(yes|no|auto) ( -t )

If this option is set to 'auto' (the default) then Bazel will only rerun a test if any of the following conditions applies:

• Bazel detects changes in the test or its dependencies
• the test is marked as external
• multiple test runs were requested with --runs_per_test
• the test failed.

If 'no', all tests will be executed unconditionally.

If 'yes', the caching behavior will be the same as auto except that it may cache test failures and test runs with --runs_per_test .

Note: Test results are always saved in Bazel's output tree, regardless of whether this option is enabled, so you needn't have used --cache_test_results on the prior run(s) of bazel test in order to get cache hits. The option only affects whether Bazel will use previously saved results, not whether it will save results of the current run.

Users who have enabled this option by default in their .bazelrc file may find the abbreviations -t (on) or -t- (off) convenient for overriding the default on a particular run.

--check_tests_up_to_date

This option tells Bazel not to run the tests, but to merely check and report the cached test results. If there are any tests which have not been previously built and run, or whose tests results are out-of-date (for example, because the source code or the build options have changed), then Bazel will report an error message ("test result is not up-to-date"), will record the test's status as "NO STATUS" (in red, if color output is enabled), and will return a non-zero exit code.

This option also implies [--check_up_to_date](#check-up-to-date) behavior.

This option may be useful for pre-submit checks.

--test_verbose_timeout_warnings

This option tells Bazel to explicitly warn the user if a test's timeout is significantly longer than the test's actual execution time. While a test's timeout should be set such that it is not flaky, a test that has a highly over-generous timeout can hide real problems that crop up unexpectedly.

For instance, a test that normally executes in a minute or two should not have a timeout of ETERNAL or LONG as these are much, much too generous.

This option is useful to help users decide on a good timeout value or sanity check existing timeout values.

Note: Each test shard is allotted the timeout of the entire XX_test target. Using this option does not affect a test's timeout value, merely warns if Bazel thinks the timeout could be restricted further.

--[no]test_keep_going

By default, all tests are run to completion. If this flag is disabled, however, the build is aborted on any non-passing test. Subsequent build steps and test invocations are not run, and in-flight invocations are canceled. Do not specify both --notest_keep_going and --keep_going .

--flaky_test_attempts= attempts

This option specifies the maximum number of times a test should be attempted if it fails for any reason. A test that initially fails but eventually succeeds is reported as FLAKY on the test summary. It is, however, considered to be passed when it comes to identifying Bazel exit code or total number of passed tests. Tests that fail all allowed attempts are considered to be failed.

By default (when this option is not specified, or when it is set to default), only a single attempt is allowed for regular tests, and 3 for test rules with the flaky attribute set. You can specify an integer value to override the maximum limit of test attempts. Bazel allows a maximum of 10 test attempts in order to prevent abuse of the system.

--runs_per_test= [regex@]number

This option specifies the number of times each test should be executed. All test executions are treated as separate tests (fallback functionality will apply to each of them independently).

The status of a target with failing runs depends on the value of the --runs_per_test_detects_flakes flag:

• If absent, any failing run causes the entire test to fail.
• If present and two runs from the same shard return PASS and FAIL, the test will receive a status of flaky (unless other failing runs cause it to fail).

If a single number is specified, all tests will run that many times. Alternatively, a regular expression may be specified using the syntax regex@number. This constrains the effect of --runs_per_test to targets which match the regex ( --runs_per_test=^//pizza:.*@4 runs all tests under //pizza/ 4 times). This form of --runs_per_test may be specified more than once.

--[no]runs_per_test_detects_flakes

If this option is specified (by default it is not), Bazel will detect flaky test shards through --runs_per_test . If one or more runs for a single shard fail and one or more runs for the same shard pass, the target will be considered flaky with the flag. If unspecified, the target will report a failing status.

--test_summary= output_style

Specifies how the test result summary should be displayed.

• short prints the results of each test along with the name of the file containing the test output if the test failed. This is the default value.
• terse like short , but even shorter: only print information about tests which did not pass.
• detailed prints each individual test case that failed, not only each test. The names of test output files are omitted.
• none does not print test summary.

--test_output= output_style

Specifies how test output should be displayed:

• summary shows a summary of whether each test passed or failed. Also shows the output log file name for failed tests. The summary will be printed at the end of the build (during the build, one would see just simple progress messages when tests start, pass or fail). This is the default behavior.
• errors sends combined stdout/stderr output from failed tests only into the stdout immediately after test is completed, ensuring that test output from simultaneous tests is not interleaved with each other. Prints a summary at the build as per summary output above.
• all is similar to errors but prints output for all tests, including those which passed.
• streamed streams stdout/stderr output from each test in real-time.

--java_debug

This option causes the Java virtual machine of a java test to wait for a connection from a JDWP-compliant debugger before starting the test. This option implies --test_output=streamed .

--[no]verbose_test_summary

By default this option is enabled, causing test times and other additional information (such as test attempts) to be printed to the test summary. If --noverbose_test_summary is specified, test summary will include only test name, test status and cached test indicator and will be formatted to stay within 80 characters when possible.

--test_tmpdir= path

Specifies temporary directory for tests executed locally. Each test will be executed in a separate subdirectory inside this directory. The directory will be cleaned at the beginning of the each bazel test command. By default, bazel will place this directory under Bazel output base directory.

Note: This is a directory for running tests, not storing test results (those are always stored under the bazel-out directory).

--test_timeout= seconds OR --test_timeout= seconds , seconds , seconds , seconds

Overrides the timeout value for all tests by using specified number of seconds as a new timeout value. If only one value is provided, then it will be used for all test timeout categories.

Alternatively, four comma-separated values may be provided, specifying individual timeouts for short, moderate, long and eternal tests (in that order). In either form, zero or a negative value for any of the test sizes will be substituted by the default timeout for the given timeout categories as defined by the page Writing Tests . By default, Bazel will use these timeouts for all tests by inferring the timeout limit from the test's size whether the size is implicitly or explicitly set.

Tests which explicitly state their timeout category as distinct from their size will receive the same value as if that timeout had been implicitly set by the size tag. So a test of size 'small' which declares a 'long' timeout will have the same effective timeout that a 'large' tests has with no explicit timeout.

--test_arg= arg

Passes command-line options/flags/arguments to each test process. This option can be used multiple times to pass several arguments. For example, --test_arg=--logtostderr --test_arg=--v=3 .

--test_env= variable =_value_ OR --test_env= variable

Specifies additional variables that must be injected into the test environment for each test. If value is not specified it will be inherited from the shell environment used to start the bazel test command.

The environment can be accessed from within a test by using System.getenv("var") (Java), getenv("var") (C or C++),

--run_under= command-prefix

This specifies a prefix that the test runner will insert in front of the test command before running it. The command-prefix is split into words using Bourne shell tokenization rules, and then the list of words is prepended to the command that will be executed.

If the first word is a fully-qualified label (starts with // ) it is built. Then the label is substituted by the corresponding executable location that is prepended to the command that will be executed along with the other words.

Some caveats apply:

• The PATH used for running tests may be different than the PATH in your environment, so you may need to use an absolute path for the --run_under command (the first word in command-prefix ).
• stdin is not connected , so --run_under can't be used for interactive commands.

Examples:

        --run_under=/usr/bin/strace
        --run_under='/usr/bin/strace -c'
        --run_under=/usr/bin/valgrind
        --run_under='/usr/bin/valgrind --quiet --num-callers=20'

Test selection

As documented under Output selection options , you can filter tests by size , timeout , tag , or language . A convenience general name filter can forward particular filter args to the test runner.

Other options for bazel test

The syntax and the remaining options are exactly like bazel build .

Running executables

The bazel run command is similar to bazel build , except it is used to build and run a single target. Here is a typical session:

  % bazel run java/myapp:myapp -- --arg1 --arg2
  Welcome to Bazel
  INFO: Loading package: java/myapp
  INFO: Loading package: foo/bar
  INFO: Loading complete.  Analyzing...
  INFO: Found 1 target...
  ...
  Target //java/myapp:myapp up-to-date:
    bazel-bin/java/myapp:myapp
  INFO: Elapsed time: 0.638s, Critical Path: 0.34s

  INFO: Running command line: bazel-bin/java/myapp:myapp --arg1 --arg2
  Hello there
  $EXEC_ROOT/java/myapp/myapp
  --arg1
  --arg2

Note: -- is needed so that Bazel does not interpret --arg1 and --arg2 as Bazel options, but rather as part of the command line for running the binary. (The program being run simply says hello and prints out its args.)

bazel run is similar, but not identical, to directly invoking the binary built by Bazel and its behavior is different depending on whether the binary to be invoked is a test or not.

When the binary is not a test, the current working directory will be the runfiles tree of the binary.

When the binary is a test, the current working directory will be the exec root and a good-faith attempt is made to replicate the environment tests are usually run in. The emulation is not perfect, though, and tests that have multiple shards cannot be run this way (the --test_sharding_strategy=disabled command line option can be used to work around this)

The following extra environment variables are also available to the binary:

• BUILD_WORKSPACE_DIRECTORY : the root of the workspace where the build was run.
• BUILD_WORKING_DIRECTORY : the current working directory where Bazel was run from.

These can be used, for example, to interpret file names on the command line in a user-friendly way.

Options for bazel run

--run_under= command-prefix

This has the same effect as the --run_under option for bazel test ( see above ), except that it applies to the command being run by bazel run rather than to the tests being run by bazel test and cannot run under label.

Filtering logging outputs from Bazel

When invoking a binary with bazel run , Bazel prints logging output from Bazel itself and the binary under invocation. To make the logs less noisy, you can suppress the outputs from Bazel itself with the --ui_event_filters and --noshow_progress flags.

For example: bazel run --ui_event_filters=-info,-stdout,-stderr --noshow_progress //java/myapp:myapp

Executing tests

bazel run can also execute test binaries, which has the effect of running the test in a close approximation of the environment described at Writing Tests . Note that none of the --test_* arguments have an effect when running a test in this manner except --test_arg .

Cleaning build outputs

The clean command

Bazel has a clean command, analogous to that of Make. It deletes the output directories for all build configurations performed by this Bazel instance, or the entire working tree created by this Bazel instance, and resets internal caches. If executed without any command-line options, then the output directory for all configurations will be cleaned.

Recall that each Bazel instance is associated with a single workspace, thus the clean command will delete all outputs from all builds you've done with that Bazel instance in that workspace.

To completely remove the entire working tree created by a Bazel instance, you can specify the --expunge option. When executed with --expunge , the clean command simply removes the entire output base tree which, in addition to the build output, contains all temp files created by Bazel. It also stops the Bazel server after the clean, equivalent to the shutdown command. For example, to clean up all disk and memory traces of a Bazel instance, you could specify:

  % bazel clean --expunge

Alternatively, you can expunge in the background by using --expunge_async . It is safe to invoke a Bazel command in the same client while the asynchronous expunge continues to run.

Note: This may introduce IO contention.

The clean command is provided primarily as a means of reclaiming disk space for workspaces that are no longer needed. Bazel's incremental rebuilds may not be perfect so clean can be used to recover a consistent state when problems arise.

Bazel's design is such that these problems are fixable and these bugs are a high priority to be fixed. If you ever find an incorrect incremental build, file a bug report, and report bugs in the tools rather than using clean .

Querying the dependency graph

Bazel includes a query language for asking questions about the dependency graph used during the build. The query language is used by two commands: query and cquery. The major difference between the two commands is that query runs after the loading phase and cquery runs after the analysis phase . These tools are an invaluable aid to many software engineering tasks.

The query language is based on the idea of algebraic operations over graphs; it is documented in detail in

Bazel Query Reference . Please refer to that document for reference, for examples, and for query-specific command-line options.

The query tool accepts several command-line option. --output selects the output format. --[no]keep_going (disabled by default) causes the query tool to continue to make progress upon errors; this behavior may be disabled if an incomplete result is not acceptable in case of errors.

The --[no]tool_deps option, enabled by default, causes dependencies in non-target configurations to be included in the dependency graph over which the query operates.

The --[no]implicit_deps option, enabled by default, causes implicit dependencies to be included in the dependency graph over which the query operates. An implicit dependency is one that is not explicitly specified in the BUILD file but added by bazel.

Example: "Show the locations of the definitions (in BUILD files) of all genrules required to build all the tests in the PEBL tree."

  bazel query --output location 'kind(genrule, deps(kind(".*_test rule", foo/bar/pebl/...)))'

Querying the action graph

Caution: The aquery command is still experimental and its API will change.

The aquery command allows you to query for actions in your build graph. It operates on the post-analysis configured target graph and exposes information about actions, artifacts and their relationships.

The tool accepts several command-line options. --output selects the output format. The default output format ( text ) is human-readable, use proto or textproto for machine-readable format. Notably, the aquery command runs on top of a regular Bazel build and inherits the set of options available during a build.

It supports the same set of functions that is also available to traditional query but siblings , buildfiles and tests .

For more details, see Action Graph Query .

Miscellaneous commands and options

help

The help command provides on-line help. By default, it shows a summary of available commands and help topics, as shown in Building with Bazel . Specifying an argument displays detailed help for a particular topic. Most topics are Bazel commands, such as build or query , but there are some additional help topics that do not correspond to commands.

--[no]long ( -l )

By default, bazel help [ topic ] prints only a summary of the relevant options for a topic. If the --long option is specified, the type, default value and full description of each option is also printed.

shutdown

Bazel server processes may be stopped by using the shutdown command. This command causes the Bazel server to exit as soon as it becomes idle (for example, after the completion of any builds or other commands that are currently in progress). For more details, see Client/server implementation .

Bazel servers stop themselves after an idle timeout, so this command is rarely necessary; however, it can be useful in scripts when it is known that no further builds will occur in a given workspace.

shutdown accepts one option, --iff_heap_size_greater_than _n_ , which requires an integer argument (in MB). If specified, this makes the shutdown conditional on the amount of memory already consumed. This is useful for scripts that initiate a lot of builds, as any memory leaks in the Bazel server could cause it to crash spuriously on occasion; performing a conditional restart preempts this condition.

info

The info command prints various values associated with the Bazel server instance, or with a specific build configuration. (These may be used by scripts that drive a build.)

The info command also permits a single (optional) argument, which is the name of one of the keys in the list below. In this case, bazel info key will print only the value for that one key. (This is especially convenient when scripting Bazel, as it avoids the need to pipe the result through sed -ne /key:/s/key://p :

Configuration-independent data

• release : the release label for this Bazel instance, or "development version" if this is not a released binary.
• workspace the absolute path to the base workspace directory.

• install_base : the absolute path to the installation directory used by this Bazel instance for the current user. Bazel installs its internally required executables below this directory.

• output_base : the absolute path to the base output directory used by this Bazel instance for the current user and workspace combination. Bazel puts all of its scratch and build output below this directory.

• execution_root : the absolute path to the execution root directory under output_base. This directory is the root for all files accessible to commands executed during the build, and is the working directory for those commands. If the workspace directory is writable, a symlink named bazel-<workspace> is placed there pointing to this directory.

• output_path : the absolute path to the output directory beneath the execution root used for all files actually generated as a result of build commands. If the workspace directory is writable, a symlink named bazel-out is placed there pointing to this directory.

• server_pid : the process ID of the Bazel server process.

• server_log : the absolute path to the Bazel server's debug log file. This file contains debugging information for all commands over the lifetime of the Bazel server, and is intended for human consumption by Bazel developers and power users.

• command_log : the absolute path to the command log file; this contains the interleaved stdout and stderr streams of the most recent Bazel command. Note that running bazel info will overwrite the contents of this file, since it then becomes the most recent Bazel command. However, the location of the command log file will not change unless you change the setting of the --output_base or --output_user_root options.

• used-heap-size , committed-heap-size , max-heap-size : reports various JVM heap size parameters. Respectively: memory currently used, memory currently guaranteed to be available to the JVM from the system, maximum possible allocation.

• gc-count , gc-time : The cumulative count of garbage collections since the start of this Bazel server and the time spent to perform them. Note that these values are not reset at the start of every build.

• package_path : A colon-separated list of paths which would be searched for packages by bazel. Has the same format as the --package_path build command line argument.

Example: the process ID of the Bazel server.

% bazel info server_pid
1285

Configuration-specific data

These data may be affected by the configuration options passed to bazel info , for example --cpu , --compilation_mode , etc. The info command accepts all the options that control dependency analysis, since some of these determine the location of the output directory of a build, the choice of compiler, etc.

• bazel-bin , bazel-testlogs , bazel-genfiles : reports the absolute path to the bazel-* directories in which programs generated by the build are located. This is usually, though not always, the same as the bazel-* symlinks created in the base workspace directory after a successful build. However, if the workspace directory is read-only, no bazel-* symlinks can be created. Scripts that use the value reported by bazel info , instead of assuming the existence of the symlink, will be more robust.
• The complete "Make" environment . If the --show_make_env flag is specified, all variables in the current configuration's "Make" environment are also displayed (such as CC , GLIBC_VERSION , etc). These are the variables accessed using the $(CC) or varref("CC") syntax inside BUILD files.

Example: the C++ compiler for the current configuration. This is the $(CC) variable in the "Make" environment, so the --show_make_env flag is needed.

  % bazel info --show_make_env -c opt COMPILATION_MODE
  opt

Example: the bazel-bin output directory for the current configuration. This is guaranteed to be correct even in cases where the bazel-bin symlink cannot be created for some reason (such as if you are building from a read-only directory).

% bazel info --cpu=piii bazel-bin
/var/tmp/_bazel_johndoe/fbd0e8a34f61ce5d491e3da69d959fe6/execroot/io_bazel/bazel-out/piii-opt/bin
% bazel info --cpu=k8 bazel-bin
/var/tmp/_bazel_johndoe/fbd0e8a34f61ce5d491e3da69d959fe6/execroot/io_bazel/bazel-out/k8-opt/bin

version and --version

The version command prints version details about the built Bazel binary, including the changelist at which it was built and the date. These are particularly useful in determining if you have the latest Bazel, or if you are reporting bugs. Some of the interesting values are:

• changelist : the changelist at which this version of Bazel was released.
• label : the release label for this Bazel instance, or "development version" if this is not a released binary. Very useful when reporting bugs.

bazel --version , with no other args, will emit the same output as bazel version --gnu_format , except without the side-effect of potentially starting a Bazel server or unpacking the server archive. bazel --version can be run from anywhere - it does not require a workspace directory.

mobile-install

The mobile-install command installs apps to mobile devices. Currently only Android devices running ART are supported.

See bazel mobile-install for more information.

Note: This command does not install the same thing that bazel build produces: Bazel tweaks the app so that it can be built, installed and re-installed quickly. This should, however, be mostly transparent to the app.

The following options are supported:

--incremental

If set, Bazel tries to install the app incrementally, that is, only those parts that have changed since the last build. This cannot update resources referenced from AndroidManifest.xml , native code or Java resources (such as those referenced by Class.getResource() ). If these things change, this option must be omitted. Contrary to the spirit of Bazel and due to limitations of the Android platform, it is the responsibility of the user to know when this command is good enough and when a full install is needed.

If you are using a device with Marshmallow or later, consider the --split_apks flag.

--split_apks

Whether to use split apks to install and update the application on the device. Works only with devices with Marshmallow or later. Note that the --incremental flag is not necessary when using --split_apks .

--start_app

Starts the app in a clean state after installing. Equivalent to --start=COLD .

--debug_app

Waits for debugger to be attached before starting the app in a clean state after installing. Equivalent to --start=DEBUG .

--start=_start_type_

How the app should be started after installing it. Supported _start_type_s are:

• NO Does not start the app. This is the default.
• COLD Starts the app from a clean state after install.
• WARM Preserves and restores the application state on incremental installs.
• DEBUG Waits for the debugger before starting the app in a clean state after install.

Note: If more than one of --start=_start_type_ , --start_app or --debug_app is set, the last value is used.

--adb= path

Indicates the adb binary to be used.

The default is to use the adb in the Android SDK specified by --android_sdk .

--adb_arg= serial

Extra arguments to adb . These come before the subcommand in the command line and are typically used to specify which device to install to. For example, to select the Android device or emulator to use:

% bazel mobile-install --adb_arg=-s --adb_arg=deadbeef

invokes adb as

adb -s deadbeef install ...

--incremental_install_verbosity= number

The verbosity for incremental install. Set to 1 for debug logging to be printed to the console.

dump

The dump command prints to stdout a dump of the internal state of the Bazel server. This command is intended primarily for use by Bazel developers, so the output of this command is not specified, and is subject to change.

By default, command will just print help message outlining possible options to dump specific areas of the Bazel state. In order to dump internal state, at least one of the options must be specified.

Following options are supported:

• --action_cache dumps action cache content.
• --packages dumps package cache content.
• --skyframe dumps state of internal Bazel dependency graph.
• --rules dumps rule summary for each rule and aspect class, including counts and action counts. This includes both native and Starlark rules. If memory tracking is enabled, then the rules' memory consumption is also printed.
• --skylark_memory dumps a pprof compatible .gz file to the specified path. You must enable memory tracking for this to work.

Memory tracking

Some dump commands require memory tracking. To turn this on, you have to pass startup flags to Bazel:

• --host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar
• --host_jvm_args=-DRULE_MEMORY_TRACKER=1

The java-agent is checked into Bazel at third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar , so make sure you adjust $BAZEL for where you keep your Bazel repository.

Do not forget to keep passing these options to Bazel for every command or the server will restart.

Example:

    % bazel --host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar \
    --host_jvm_args=-DRULE_MEMORY_TRACKER=1 \
    build --nobuild <targets>

    # Dump rules
    % bazel --host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar \
    --host_jvm_args=-DRULE_MEMORY_TRACKER=1 \
    dump --rules

    # Dump Starlark heap and analyze it with pprof
    % bazel --host_jvm_args=-javaagent:$BAZEL/third_party/allocation_instrumenter/java-allocation-instrumenter-3.3.0.jar \
    --host_jvm_args=-DRULE_MEMORY_TRACKER=1 \
    dump --skylark_memory=$HOME/prof.gz
    % pprof -flame $HOME/prof.gz

analyze-profile

The analyze-profile command analyzes data previously gathered during the build using --profile option. It provides several options to either perform analysis of the build execution or export data in the specified format.

The following options are supported:

• --dump displays all gathered data in a human-readable format. However, this it does not support other formats yet.

For format details and usage help, see Troubleshooting performance by profiling .

canonicalize-flags

The canonicalize-flags command, which takes a list of options for a Bazel command and returns a list of options that has the same effect. The new list of options is canonical. For example, two lists of options with the same effect are canonicalized to the same new list.

The --for_command option can be used to select between different commands. At this time, only build and test are supported. Options that the given command does not support cause an error.

Note: A small number of options cannot be reordered, because Bazel cannot ensure that the effect is identical. Also note that this command does not expand flags from --config .

As an example:

  % bazel canonicalize-flags -- --config=any_name --test_tag_filters="-lint"
  --config=any_name
  --test_tag_filters=-lint

Startup options

The options described in this section affect the startup of the Java virtual machine used by Bazel server process, and they apply to all subsequent commands handled by that server. If there is an already running Bazel server and the startup options do not match, it will be restarted.

All of the options described in this section must be specified using the --key=value or --key value syntax. Also, these options must appear before the name of the Bazel command. Use startup --key=value to list these in a .bazelrc file.

--output_base= dir

This option requires a path argument, which must specify a writable directory. Bazel will use this location to write all its output. The output base is also the key by which the client locates the Bazel server. By changing the output base, you change the server which will handle the command.

By default, the output base is derived from the user's login name, and the name of the workspace directory (actually, its MD5 digest), so a typical value looks like: /var/tmp/google/_bazel_johndoe/d41d8cd98f00b204e9800998ecf8427e .

Note: The client uses the output base to find the Bazel server instance, so if you specify a different output base in a Bazel command, a different server will be found (or started) to handle the request. It's possible to perform two concurrent builds in the same workspace directory by varying the output base.

For example:

 OUTPUT_BASE=/var/tmp/google/_bazel_johndoe/custom_output_base
% bazel --output_base ${OUTPUT_BASE}1 build //foo  &  bazel --output_base ${OUTPUT_BASE}2 build //bar

In this command, the two Bazel commands run concurrently (because of the shell & operator), each using a different Bazel server instance (because of the different output bases). In contrast, if the default output base was used in both commands, then both requests would be sent to the same server, which would handle them sequentially: building //foo first, followed by an incremental build of //bar .

Note: We recommend you do not use an NFS or similar networked file system for the root directory, as the higher access latency will cause noticeably slower builds.

--output_user_root= dir

Points to the root directory where output and install bases are created. The directory must either not exist or be owned by the calling user. In the past, this was allowed to point to a directory shared among various users but it's not allowed any longer. This may be allowed once issue #11100 is addressed.

If the --output_base option is specified, it overrides using --output_user_root to calculate the output base.

The install base location is calculated based on --output_user_root , plus the MD5 identity of the Bazel embedded binaries.

You can use the --output_user_root option to choose an alternate base location for all of Bazel's output (install base and output base) if there is a better location in your filesystem layout.

Note: We recommend you do not use an NFS or similar networked file system for the root directory, as the higher access latency will cause noticeably slower builds.

--server_javabase= dir

Specifies the Java virtual machine in which Bazel itself runs. The value must be a path to the directory containing a JDK or JRE. It should not be a label. This option should appear before any Bazel command, for example:

  % bazel --server_javabase=/usr/local/buildtools/java/jdk11 build //foo

This flag does not affect the JVMs used by Bazel subprocesses such as applications, tests, tools, and so on. Use build options --javabase or --host_javabase instead.

This flag was previously named --host_javabase (sometimes referred to as the 'left-hand side' --host_javabase ), but was renamed to avoid confusion with the build flag --host_javabase (sometimes referred to as the 'right-hand side' --host_javabase ).

--host_jvm_args= string

Specifies a startup option to be passed to the Java virtual machine in which Bazel itself runs. This can be used to set the stack size, for example:

  % bazel --host_jvm_args="-Xss256K" build //foo

This option can be used multiple times with individual arguments. Note that setting this flag should rarely be needed. You can also pass a space-separated list of strings, each of which will be interpreted as a separate JVM argument, but this feature will soon be deprecated.

That this does not affect any JVMs used by subprocesses of Bazel: applications, tests, tools, and so on. To pass JVM options to executable Java programs, whether run by bazel run or on the command-line, you should use the --jvm_flags argument which all java_binary and java_test programs support. Alternatively for tests, use bazel test --test_arg=--jvm_flags=foo ... .

--host_jvm_debug

This option causes the Java virtual machine to wait for a connection from a JDWP-compliant debugger before calling the main method of Bazel itself . This is primarily intended for use by Bazel developers.

Note: This does not affect any JVMs used by subprocesses of Bazel: applications, tests, tools, etc.

--autodetect_server_javabase

This option causes Bazel to automatically search for an installed JDK on startup, and to fall back to the installed JRE if the embedded JRE isn't available. --explicit_server_javabase can be used to pick an explicit JRE to run Bazel with.

--batch

Batch mode causes Bazel to not use the standard client/server mode , but instead runs a bazel java process for a single command, which has been used for more predictable semantics with respect to signal handling, job control, and environment variable inheritance, and is necessary for running bazel in a chroot jail.

Batch mode retains proper queueing semantics within the same output_base. That is, simultaneous invocations will be processed in order, without overlap. If a batch mode Bazel is run on a client with a running server, it first kills the server before processing the command.

Bazel will run slower in batch mode, or with the alternatives described above. This is because, among other things, the build file cache is memory-resident, so it is not preserved between sequential batch invocations. Therefore, using batch mode often makes more sense in cases where performance is less critical, such as continuous builds.

Warning: --batch is sufficiently slower than standard client/server mode. Additionally it might not support all of the features and optimizations which are made possible by a persistent Bazel server. If you're using --batch for the purpose of build isolation, you should use the command option --nokeep_state_after_build , which guarantees that no incremental in-memory state is kept between builds. In order to restart the Bazel server and JVM after a build, please explicitly do so using the "shutdown" command.

--max_idle_secs= n

This option specifies how long, in seconds, the Bazel server process should wait after the last client request, before it exits. The default value is 10800 (3 hours). --max_idle_secs=0 will cause the Bazel server process to persist indefinitely.

Note: this flag is only read if Bazel needs to start a new server. Changing this option will not cause the server to restart.

This option may be used by scripts that invoke Bazel to ensure that they do not leave Bazel server processes on a user's machine when they would not be running otherwise. For example, a presubmit script might wish to invoke bazel query to ensure that a user's pending change does not introduce unwanted dependencies. However, if the user has not done a recent build in that workspace, it would be undesirable for the presubmit script to start a Bazel server just for it to remain idle for the rest of the day. By specifying a small value of --max_idle_secs in the query request, the script can ensure that if it caused a new server to start, that server will exit promptly, but if instead there was already a server running, that server will continue to run until it has been idle for the usual time. Of course, the existing server's idle timer will be reset.

--[no]shutdown_on_low_sys_mem

If enabled and --max_idle_secs is set to a positive duration, after the build server has been idle for a while, shut down the server when the system is low on memory. Linux only.

In addition to running an idle check corresponding to max_idle_secs, the build server will starts monitoring available system memory after the server has been idle for some time. If the available system memory becomes critically low, the server will exit.

--[no]block_for_lock

If enabled, Bazel will wait for other Bazel commands holding the server lock to complete before progressing. If disabled, Bazel will exit in error if it cannot immediately acquire the lock and proceed.

Developers might use this in presubmit checks to avoid long waits caused by another Bazel command in the same client.

--io_nice_level= n

Sets a level from 0-7 for best-effort IO scheduling. 0 is highest priority, 7 is lowest. The anticipatory scheduler may only honor up to priority 4. Negative values are ignored.

--batch_cpu_scheduling

Use batch CPU scheduling for Bazel. This policy is useful for workloads that are non-interactive, but do not want to lower their nice value. See 'man 2 sched_setscheduler'. This policy may provide for better system interactivity at the expense of Bazel throughput.

Miscellaneous options

--[no]announce_rc

Controls whether Bazel announces command options read from the bazelrc file when starting up. (Startup options are unconditionally announced.)

--color (yes|no|auto)

This option determines whether Bazel will use colors to highlight its output on the screen.

If this option is set to yes , color output is enabled. If this option is set to auto , Bazel will use color output only if the output is being sent to a terminal and the TERM environment variable is set to a value other than dumb , emacs , or xterm-mono . If this option is set to no , color output is disabled, regardless of whether the output is going to a terminal and regardless of the setting of the TERM environment variable.

--config= name

Selects additional config section from the rc files ; for the current command , it also pulls in the options from command:name if such a section exists. Can be specified multiple times to add flags from several config sections. Expansions can refer to other definitions (for example, expansions can be chained).

--curses (yes|no|auto)

This option determines whether Bazel will use cursor controls in its screen output. This results in less scrolling data, and a more compact, easy-to-read stream of output from Bazel. This works well with --color .

If this option is set to yes , use of cursor controls is enabled. If this option is set to no , use of cursor controls is disabled. If this option is set to auto , use of cursor controls will be enabled under the same conditions as for --color=auto .

--[no]show_timestamps

If specified, a timestamp is added to each message generated by Bazel specifying the time at which the message was displayed.